[ruby-talk:00685] Re: Summary of discussion about RD (Re: Documentation about RD?)

Hi, 

In message "[ruby-talk:00684] Re: Summary of discussion about RD (Re: Documentation about RD?)"
    on 99/08/18, TAKAHASHI Masayoshi <[e-mail]> 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, [e-mail] <[e-mail]> 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