[ruby-talk:00688] Re: Summary of discussion about RD (Re: Documenta tion about RD?)

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!

> > But you made a mistake. HTML element like <B> ... </B> and <CENTER>=20
> > ... </CENTER> should not use in RD. RDtool-0.2.1 or after come not
> > to escape "<", ">" and "&" to "&lt;", "&gt;" and "&amp;". RD have

Excuse me, I made a big mistake. RDtool-0.2.1 or after COME TO ESCAPE ...

> I know, I have already realized that! :-( My fault! I have find, that
> `rd2html' didn't escape `<...>' tags within my doc, I have silently
> used them. It is already corrected in my current version. But I will
> not issue a new release only because these thumbness of mine :-)

I see.

> That would be fine. I have already thought of that also. I had some
> ideas but I didn't know, how to send them to you, as I had no mail
> adress. Perhaps you could introduce it into the README?

I missed to write it. README of rdtool-0.2.2 have my mail address.

> Regarding my ideas, I find these of you all much better than my own, so
> I will not mention them here, respectively I would adapt them to the
> proposed syntax. :-)
> 
> Here are two of them:
> 
> 	- 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...

> 	- 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??

> But then, it should be mentioned in the README of Ruby, about the fact,
> that there *IS* a RD format for documenting Ruby. And where to get the
> tools and infos!

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

> Sorry of my poor English...
> Nothing to forgive. Mine is also not better ;-))))

Thank you.:-)

---
Tosh