Re: [PATCH] Improve docs, new attempt

[Stefan Kost <ensonic hora-obscura de>]

Hi Christian,

Am Sonntag, den 18.06.2006, 19:36 +0200 schrieb Christian Neumair:
> I've spent some more hours on GnomeVFS docs and the Xfer docs should be
> in a way better shape now. I got commit permission for the last one
> already, but this one is significantly larger (240 kB, but including the
> tmpl/ regeneration garbage).

I strongly recommend to move all docs to the source files and remove the
tmpl files from cvs totaly. If developers use different versions of
gtk-doc, commiting partialy generated files such as the files under
tmpl/ can often cause conflicts like those we know with po/*.po files.

Besides developers will more likely update docs when they are close to
the sources.

In case you are not aware, even the section docs can be added to the
sources (see the gtk-doc manual in yelp).

Stefan