Re: [Tracker] *** Maybe Spam *** Re: Documentation

[Martyn Russell <martyn imendio com>]

Luca Ferretti wrote:
> Il giorno lun, 29/09/2008 alle 16.40 +0100, Martyn Russell ha scritto:
> > Jamie McCracken wrote:
> > > agree - maybe gtkdoc?
> > I would rather not, I hate GtkDoc :) and it is far from compliant with
> > Windows, Tor had to add hacks around GtkDoc to get Evolution and other
> > technologies working on Windows with it. I have had to do this too.
>
> Martyn, please consider that gtk-doc stuff are greatly managed on
> http://library.gnome.org 
>
> Here you can browse docs as well as download a tar.gz with all html
> files. 
>
> And it's the standard GNOME way to document the APIS.
>
> Plus, of course, you can distribute docs inside the tracker sources and
> read/search with Devhelp

We are not documenting the APIs we are documenting architecture and
HOWTOs for building 3rd party components into Tracker. This feels
outside the scope of what l.g.o is for. Maybe I am wrong?

-- 
Regards,
Martyn