Skip site navigation (1)Skip section navigation (2)
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>