Descent and gotoapi

Kris foo at bar.com
Sun Jan 27 22:41:30 PST 2008


"Robert Fraser" <fraserofthenight at gmail.com> wrote in message 
news:fnjt4u$2t5p$1 at digitalmars.com...
> Ary Borenszweig wrote:
>> The API provided by Descent includes top level members like classes, 
>> structs, functions, templates, etc. For each of these you can get a lot 
>> of information also, like which is the base class of a class, and which 
>> interfaces it implements, or which is the return type of a method and the 
>> types of the parameters, etc. (though this functionality is only present 
>> in the trunk revision, not in 0.4).
>>
>> So writing a plugin that generates the files required by gotoapi should 
>> be very, very simple. No changes are required in Descent. :-)
>>
>> If anyone is interested in doing it, I can give help on how to write an 
>> Eclipse plugin, and which are the important classes/packages needed to do 
>> it.
>>
>> Kris escribió:
>>> Hi,
>>>
>>> Guillaume mentioned the "gotoapi" on another thread. Seems like a useful 
>>> resource for D libraries too, and can be customized here: 
>>> http://www.gotapi.com/contribute/
>>>
>>> My questions is this: since Descent can internally infer the public API 
>>> of a D library, could it be adjusted to also generate the kind of XML 
>>> tagging required by gotoapi?
>>>
>>> - Kris
>
> 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 





More information about the Digitalmars-d mailing list