Download Firefox: WindowsMac OS X
logo       
Google Custom Search
    AddThis Social Bookmark Button

Re: Discussion on ruby-core about documentation: msg#00017

Subject: Re: Discussion on ruby-core about documentation
Gavin Sinclair wrote:

On Wednesday, December 17, 2003, 12:21:10 AM, jbritt wrote:
Yes, and with that coming up I'm pretty sure I'll never touch RImport
code again.


LOL!  Will there be an official announcement?  :)

Well, I'll put something up on the RubyForge site, maybe a 'Closed for Vacation' sign ...

I may then look at doing Rexport. :)

I gather from Dave's comments that, whereas ri currently uses Ruby's
Marshall format to store data files, the next version will use YAML. A step in the right direction, but, from my understanding of YAML, it is designed to be data-centric, not document-centric, with corresponding limitations.

I'd like to have a way to get semantically rich markup out of RDoc comments (the current XML output is full of presentation markup), suitable for a variety of document processing tasks (e.g. transclusion, data extraction via XPath/XQuery, dependency hierarchies), and I don't think the next version of RDoc/ri will address this.

But time will tell.


James







<Prev in Thread] Current Thread [Next in Thread>