[ruby-talk:00692] Re: Summary of discussion about RD (Re: Docum enta tion about RD?)

On 19 Aug, Toshiro Kuwabara wrote:
> Hi,
> 
> 
>> > Thank you for your using RD and RDtool in testsupp-0.2!> \cle
>> Thank you for providing such a great tool, Tosh! :-))))
> 
> What a great complaint! I'm very glad!

Only the truth to them who deserves it! :-) I had begun to do something
similar like Perl`s Plain Old Document (POD) thing! But after looking
to your tool, I know I need not do it forth. :-)))

But so is the Ruby world. Every time I have a good idea (IMHO, of
course) matz, goto kentaro, or other show me, that it is already there
;-)

[...]

>> 	- May I propose to have a `rd2man' in future?
> 
> If I know about roff and man-macro, I will write rd2man for RDtool. And that
> would not be difficult. But I don't know. uum...

Uhm too! Here we both are in the same difficulty! I had begun to write
a `rd2troff' based on your `rdtool's, but I think, that makes no sense.
Because man-format and troff has its differences.

Perhaps I will learn it later! But then, I know, other will already
finished the task :-)))

> 
>> 	- The latex section seems to numerate sections beginning with
>> 	  `=3D=3D=B4 with 0, if there was no `=3D =B4 section before. I think, i=
>> f
>> 	  there is no `=3D ' section, it should silently be cut down one
>> 	  level. So the first occurence of `=3D=3D ' should become `1.' but
>> 	  not `0.1'. That should also be valid, if I would have a `=3D=3D=3D '
>> 	  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?
> 
> You've said that
> =begin
> === First Headline
> Some text ...
> ==== subsection of First Headline
> Some text ...
> === Second Headline
> =end
> should be formatted to
> (preface)
> \begin{document}
> \section{First Headline}
> Some text ...
> \subsection{subsection of First Headline}
> Some text ...
> \section{Second Headline}
> ...
> \end{document}
> by rd2latex??

So I think! The highest level used in that special document, should
become the toplevel of the latex hierarchy. That is, because neither
`rd2html' nor `rd2man' would use section numbering. So the document
would looks right both in the browser and in the manpage viewer. I
would not have to think about document hierarchy! 

I could even put that document among others. It would looks right
erverywhere. Only not if using latex.

But I have thought my trick would solve that. If the document would be
e.g. `testsupp.rb' and build like that:

	rd2latex testsupp.rb > testsupp.tex

it would looks right, even if I build it as part among others like:

	rd2latex ... rdtool.rb testsupp.rb ... > tools.html

The section numbering would be appropiate, here. The highest level of
every document would make a toplevel in latex.

[...]

> 
> I suppose RD is too young to be written in Ruby-Manual. RDtool is much
> younger!!(aged 6 days ...:-))

I had not known, that it is so young. I have assumed, that its only me,
that had not detect it :-)))

[...]

> ---
> Tosh

\cle