Re: [jamboost] v2 help output

From: David Abrahams (dave_at_[hidden])
Date: 2002-11-11 19:00:55

Rene Rivera <grafik666_at_[hidden]> writes:

> [2002-11-11] David Abrahams wrote:
>
>>Hi Rene,
>>
>>Try bjam --help generators.generator on
>>tools/build/new/generators.jam,1.15 for some strange output.
>
> Yikes... There's a conflict with the name of the argument for a rule, and a
> rule with the same name in the scope of the rule. I'll fix it :-)
>
>
>>Also, I notice some #:: used to get preformatted output (at least,
>>that's what I guess it does).
>
> Yes, I added that to support preformated output. The syntax is:
> #:: whatever...
>
>> I wonder if we couldn't just use >1 space indenting to detect that?
>
> Yes, we could.
>
>> That's what ReST does...
>
> Well... no. ReST uses a line with "::" on it, followed by any number of
> whitespace prefixed lines, followed by a single blank line. That's why I
> chose to use "#::". I can try and replicate the ReST syntax, but perhaps
> your >1 suggestion is sufficient.

Well, that's Wiki-like.

However, bulleted lists and other indentations also arise, so I can
see the point of a ReST-like syntax. The thing I don't like is having
to put :: on every line. In fact, I think I'm very fond of ending a
line with '::' and having the preformatted text follow. That's what
ReST does, right?

-- 
David Abrahams
dave_at_[hidden] * http://www.boost-consulting.com
Boost support, enhancements, training, and commercial distribution