Date: Fri, 3 Jan 2003 12:14:06 -0800 From: Juli Mallett <jmallett@FreeBSD.org> To: Tony Finch <dot@dotat.at> Cc: Peter Wemm <peter@wemm.org>, "Alan L. Cox" <alc@imimic.com>, John Baldwin <jhb@FreeBSD.org>, Nate Lawson <nate@root.org>, cvs-committers@freebsd.org, cvs-all@freebsd.org, Alan Cox <alc@FreeBSD.org> Subject: Re: cvs commit: src/sys/nfsclient nfs_vnops.c Message-ID: <20030103121406.A88673@FreeBSD.org> In-Reply-To: <20030103195209.A15025@chiark.greenend.org.uk>; from dot@dotat.at on Fri, Jan 03, 2003 at 07:52:09PM %2B0000 References: <3E14985A.35AB67F4@imimic.com> <20030103192950.0FC392A7EA@canning.wemm.org> <20030103195209.A15025@chiark.greenend.org.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
* De: Tony Finch <dot@dotat.at> [ Data: 2003-01-03 ] [ Subjecte: Re: cvs commit: src/sys/nfsclient nfs_vnops.c ] > On Fri, Jan 03, 2003 at 11:29:50AM -0800, Peter Wemm wrote: > > > > One thing that I miss from my (ancient?) Amiga days is Autodoc. It was a > > formalized way of having docs embedded with the code and having them mined > > with a tool and collected into coherent man-page-like docs. > > I've tried to use Doxygen for this. It produces HTML rather than man > pages, but the documentation format is quite nice (similar to JavaDoc) > and the output looks good too. However it has terrible trouble with > typical C -- the author is a C++ programmer and Doxygen assumes the code > is structured OOly rather than modularly -- and it's really hard to fix > the broken assumptions so that it works properly. With a few changes, Apple's HeaderDoc tool becomes SourceDoc rather nicely and is relatively language agnostic. -- Juli Mallett <jmallett@FreeBSD.org> AIM: BSDFlata -- IRC: juli on EFnet. OpenDarwin, Mono, FreeBSD Developer. ircd-hybrid Developer, EFnet addict. FreeBSD on MIPS-Anything on FreeBSD. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030103121406.A88673>