Descent and gotoapi

[Lars Ivar Igesund]

Guillaume B. wrote:

> Lars Ivar Igesund wrote:
>> 
>> I chatted with Ary earlier today - I don't think Descent generated API
>> docs can ever be a permanent solution for Tango as we want to be able to
>> have it part of the various scripts, both for releases and continously
>> updated on server for trunk. For that I hope that someone would tackle
>> rebuild to do the same, or for dil to suddenly be complete compiler <g>.
>> 
>> So maybe gotapi should have higher priority, at least from the above
>> perspective.
>> 
> 
>  Hi,
> 
>  Beside D, my other favorite language is Ruby so I've made a little Ruby
> script (see attachment) that can parse the Tango HTML documentation and
> create a XML file for gotapi. (If there was an HTML parser like Hpricot in
> D, I would have done it in D!) But, I have no idea if the XML will be
> accepted or not like it is by gotapi. Anyway, it's a good start.
> 
>  To use the script, you need Ruby and then you can install Hpricot with
>  "gem
> install hpricot". You can then run the Ruby script like this:
> 
> ruby TangoDocToXML.rb > TangoDoc.xml
> 
>  The XML is big so I won't attach it... but don't run it too often because
> it downloads the HTML pages from dsource! It would be better to parse
> local documentation but I don't have it...
> 
>  Also, there are errors in the HTML file for tango.core.Variant and
> tango.util.Convert so they are explicitly excluded by the script.
> 
>  Hope this helps!
> 
>  Guillaume

We will have to try this out. Thank you very, very much :)

-- 
Lars Ivar Igesund
blog at http://larsivi.net
DSource, #d.tango & #D: larsivi
Dancing the Tango