Re: [libdc1394-devel] Minor API tweaks

[Peter A. <the...@us...>]

On Monday 17 September 2007 10:44:05 David Moore wrote:
> > I'm not familiar with doxygen or gtk-doc so I don't mind either. We
> > could even have both if that's possible. Otherwise I let you and Peter
> > Antoniac decide which doc generator to use.
>
> Yeah, we can definitely try both. =A0But I guess the burden is on me to
> implement the gtk-doc bits. =A0:) =A0Luckily, I think the C-comment markup
> looks roughly the same for both.

Hmm, I've heard that gtk-doc has better C generation docs than Doxygen. I j=
ust=20
picked doxygen as I thought it was more popular and it was easy to integrat=
e.=20
The problem that we have is not so much in the tool, but who does the=20
documentation :) When I did the doxygen integration there was a promise fro=
m=20
someone on the list to write the comments in the code. Since then, nothing=
=20
happened, so, whoever is doing the comments, can pick the tool they like :)

Cheers,
Peter