Date: Thu, 18 May 2006 11:31:03 -0700 From: Frank Mayhar <frank@exit.com> To: Warner Losh <imp@bsdimp.com> Cc: src-committers@freebsd.org, cvs-src@freebsd.org, gnn@neville-neil.com, cvs-all@freebsd.org, phk@phk.freebsd.dk, julian@elischer.org, hellmuth.michaelis@t-online.de Subject: Re: cvs commit: src Makefile.inc1 ObsoleteFiles.inc src/etc/defaults rc.conf src/etc/mtree BSD.usr.dist src/etc/rc.d Makefile isdnd pcvt syscons src/release/picobsd/build picobsd src/share/man/man4 Makefile atkbd.4 kbdmux.4 pcvt.4 splash.4 vkbd.4 ... Message-ID: <1147977063.76767.8.camel@realtime.exit.com> In-Reply-To: <20060518.122122.71180479.imp@bsdimp.com> References: <m2ejyrl0gd.wl%gnn@neville-neil.com> <39977.1147973989@critter.freebsd.dk> <20060518.122122.71180479.imp@bsdimp.com>
next in thread | previous in thread | raw e-mail | index | archive | help
[Doxygen] Once upon a time, Back In The Day(tm), I worked on a mainframe OS called CP6. CP6 had a lot of cool attributes, but the one that is relevant here is that we kept our entire API documentation (including multiple levels of error messages) in the code itself. Every distinct type of documentation had a special comment-code (like, for example, /*E* to start an error message block) and we had a munger that would crawl the source, extract the marked commentary and assemble it into a formatted manual. A tech writer wrote the introduction and a few other things, but those tended to remain static with only minor tweaks from release to release. The really big changes were done in the marked commentary by the developers involved. It worked, but of course it required discipline, both personal and imposed. That's the tricky part in an all-volunteer effort. -- Frank Mayhar frank@exit.com http://www.exit.com/ Exit Consulting http://www.gpsclock.com/ http://www.exit.com/blog/frank/
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1147977063.76767.8.camel>