[stringtemplate-interest] Moving closer to 4.0 ST release (what to do with the doc)

[Collin Fagan]

I learned a lot from the ST3 documentation but I still think it could
benefit from some attention.

Here are some things I consider "missing", I apologise if these are well
documented and I just can't find them.

If statements support "and" and "or" logic.
<if(thing && otherThing)>
... do stuff ...
<endif>

Using (" ") for map keys that contain special characters. (Wait, was that
even in ST3?)


Also I can also never *quickly* find the following information, even though
it is present.

Syntax for a map. - I never remember it.

/**/ for comments in-between templates in a template group. -- I went a
loong time without knowing this one, which was silly of me.

All of this is easily fixable.

At this point I would recommend each of us take a few minuets and try to put
ourselves in the shoes of a beginner who just stumbled onto the ST project,
then re-read the documentation. That might help highlight anything that
might be missing.

Collin



On Sun, Feb 13, 2011 at 3:49 AM, Oliver Zeigermann <
oliver.zeigermann at gmail.com> wrote:

> ST3 documentation was always good enough for me. Mosf of the time the
> cheating sheet was all I consulted.
>
> Thus I agree to what Udo said.
> Am 13.02.2011 10:28 schrieb "Udo Borkowski" <ub at abego-software.de>:
>
> _______________________________________________
> stringtemplate-interest mailing list
> stringtemplate-interest at antlr.org
> http://www.antlr.org/mailman/listinfo/stringtemplate-interest
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.antlr.org/pipermail/stringtemplate-interest/attachments/20110213/016330b9/attachment.html