Descent and gotoapi

Lars Ivar Igesund larsivar at igesund.net
Tue Jan 29 00:59:53 PST 2008


Lars Ivar Igesund wrote:

> Robert Fraser wrote:
> 
>> Kris wrote:
>>> "Robert Fraser" <fraserofthenight at gmail.com> wrote in message
>>> news:fnjt4u$2t5p$1 at digitalmars.com...

>>>> Actually, I can take a break from the unit test stuff (that's not
>>>> useful without a builder anyway) and work on a documentation generation
>>>> system that has interlinks. Would it be more useful to have that or the
>>>> gotapi?
>>> 
>>> Descent is the best! :)
>>> 
>>> Interlinked doc would likely be more valuable to Tango at this time,
>>> since it can presumeably be hosted anywhere? But it's your call. I guess
>>> there might be more "presentation" style effort in the interlinked
>>> stuff, while gotoapi would be free of such concerns?
>>> 
>>> - Kris
>>> 
>>> 
>> 
>> I was thinking that I would generate docs as closely to the Ddoc format
>> as possible (including parsing macros & all that good stuff). But the
>> gotapi might still be useful since everything is listed and searchable,
>> right? I think the gotapi thing is better as a separate plugin, though.
>> 
>> We should move this convo to IRC, but if I did that, my chances of
>> finishing my homework would be shot for tonight.
> 
> 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.
> 

Considering Guillaume's gotapi contribution, just completely ignore the
above. I was probably just selfish in any case :)

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



More information about the Digitalmars-d mailing list