Re: [PATCH] libgnomecanvas documentation cleanup

Malcolm Tredinnick <[email protected]> Mon, 29 Apr 2002 16:53:37 +1000
Newsgroups gmane.comp.gnome.lib.devel
Message-ID <[email protected]>
On Sun, Apr 28, 2002 at 04:22:05PM +0200, Sebastian Rittau wrote:
> Hi!
> 
> Currently the libgnomecanvas documentation is a mess. Attached is a
> patch that revamps the TOC and adds all unused doc strings to the
> appropriate chapters. I've left out all changes to docs/reference/tmpl,
> to minize the size of the attached patch. Since all files in there are
> auto-generated anyways, I don't understand, why they are in CVS at all.

Because you can add extra documentation into the *.tmpl files for things
that don't get documented inline or that you want to put code examples
for, etc. The gtk-doc scripts will not overwrite any manual changes you
have made to files in that directory, so they are not completely
auto-generated.

Cheers,
Malcolm

--
signature.asc (application/pgp-signature, 232 B)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE8zO3xPGhGvxo2jcwRAuTfAJ4hsf/B+Dif3I3eWsfC6NhGcpR1fQCdHb59
hCTmdgbcpxlvY2YEkkcqJqg=
=3uxv
-----END PGP SIGNATURE-----