Hi,
In message "[ruby-talk:00684] Re: Summary of discussion about RD (Re: Documentation about RD?)"
on 99/08/18, TAKAHASHI Masayoshi <maki / inac.co.jp> writes:
>> : Separater
>> Like HR of HTML.
>(snip)
>> I think we don't need separater, we should use HeadlineElement instead of
>> separater.
>
>hmmmmm. I agree that we can write docuemnt without separator, but
>separator is useful. For example, when I write several classes in one
>page, I'd like to use separator.
I think this problem depends on HTML. And I've never seen horizontal
line delimited TeX or Roff document. So, I won't vote for separater.
>> : Multi-TextElement in definition part of DescListItem(?).
>> Maybe, He want to write more than one paragraph in definition.
Me too. It should be included in RD specification.
>But it's better to use describe methods's description with DescList,
>I think. Because it's exactly `Description List' of methods :-)
However, cle's requiest as follows is also reasonable and I agree it:
In message "[ruby-talk:00683] Re: Summary of discussion about RD (Re: Documenta tion about RD?)"
on 99/08/18, clemens.hintze / alcatel.de <clemens.hintze / alcatel.de> writes:
>Here are two of them:
>
> - May I propose to have a `rd2man' in future?
>
> - The latex section seems to numerate sections beginning with
> `==with 0, if there was no `= ¥¨ section before. I think, if
> there is no `= ' section, it should silently be cut down one
> level. So the first occurence of `== ' should become `1.' but
> not `0.1'. That should also be valid, if I would have a `=== '
> section as highest level in my doc.
>
> That means, the highest level in a RD doc should be regarded
> as level one in a Latex doc!
>
> Why could that be meaningful? Perhaps I would like to write
> some documents together in a book-like document. But I should
> also be able to separately handle them!
>
>What do you think?
-- gotoken