-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Wednesday 17 March 2004 5:54 pm, Christopher Kings-Lynne wrote: > > I was thinking of writing a cron job to update the CVS tree and then > > build the documentation (takes about 10 minutes on my computer). Then > > I could push it to wherever you like. Are we currently maintaining > > two or three branches in the code? We may want to keep them seperate. > > > > We could also maintain released postgresql documentation -- IE, one > > set for PostgreSQL 7.4.0, one set for PostgreSQL 7.4.1, etc... These > > would only have to be built once. > > How about posting a 'doxygen commenting guide' to the list so that we > know how to comment? Also, maybe it's time we standardised code > documentation? :) >
Doxygen manuals are available on the 'net at doxygen.sourceforge.com. I'm using the '/' style, so no '@' for me. Read through them at your leisure at http://www.stack.nl/~dimitri/doxygen/manual.html This page in particular sums up all you need to know: http://www.stack.nl/~dimitri/doxygen/docblocks.html As far as a standard, I would like to actually go through and see what works before we talk of that. Personally, I am /stunned/ by the sheer volume of comments in the code, and getting all that to show up in Doxygen is a 6 month project! - -- Jonathan Gardner [EMAIL PROTECTED] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQFAWTgpqp6r/MVGlwwRAluNAKCm3zwp5AoY0ChTaJyki/xXRZ+2YACgosV0 RyaDbYFWYIFokmrhjpN4Y+w= =Srgo -----END PGP SIGNATURE----- ---------------------------(end of broadcast)--------------------------- TIP 5: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faqs/FAQ.html
