From: Jim Cain <list@...>
Date: 2003-07-11T11:35:31+09:00
Subject: Re: A Ruby XSL stylesheet for DocBook?

Austin Ziegler wrote:

> On Fri, 11 Jul 2003 08:54:59 +0900, Jim Cain wrote:
> 
>>I'm writing documentation for my Oracle library, and I was wondering
>>if anyone has come across or has written an XSL stylesheet for
>>DocBook that is customized for Ruby? The standard language choices
>>(C, C++, Java, Perl) do not produce an acceptable syntax for method
>>prototypes.
> 
> 
> Might it be easier to document the library with rdoc? You can cause it to output to XML.
> 

Perhaps, but I prefer not to clutter my source code with an abundance of 
commends. I would ultimately like to have more than just an API 
reference for my library, and I don't feel that the source code is the 
place for all that text.

Something that would be really useful is if a tool could generate a 
DocBook XML skeleton for all of the classes and methods in a project. 
That would be a great basis for filling in the documentation. Hmmm.... :)

In any case, I think I'll look into writing some XSL for Ruby myself.