[ruby-talk:00696] Re: Summary of discussion about RD (Re: Docum entation about RD?)

On 19 Aug, Yukihiro Matsumoto wrote:
> Hi,
> 
> In message "[ruby-talk:00689] Re: Summary of discussion about RD (Re: Documentation about RD?)"
>     on 99/08/19, Toshiro Kuwabara <[e-mail]> writes:
> 
> |> Me too. It should be included in RD specification. 
> |
> |How can we indicate that new TextElement starts.
> 
> My old rd2html.rb detect (well, tryed to detect, at least) them by
> indentation levels.  That is:
> 
> |: term 
> |   Text of first TextElement in definition part.
> |    This is verbatim, because it's indented.
> |   Text of FIRST TextElement, because it on the same indentation
> |   level.  Yes, we need indent level stack to implement this.
> |
> |   Text of FIRST TextElement, too
> 
> Empty lines are ignored for indentation (as in Python :-).

I like it as it would bring a kind of structure and order in the doc.
You would have to proper indent the lines, that makes the structure
clearer, IMHO.

BTW: I like grouping by line indentation... ;-)))

[...]

> According to my scheme, this should be:
> 
> |: Term
> |__Text of First TextElement
> |  : Term of sub list
> |____Text of First TextElement of Sub list
> |____Following line is ignored as a blank line.
> |__
> |____This is continuing First TextElement of Sub list,
> |____because of its indent level.
> |
> |__Text of First TextElement.
> |__Terminates sub list automagically.
> 
> What do you think?

Nice!

>                                                 matz.

\cle