From owner-cvs-all Fri Jan 3 12:14: 7 2003 Delivered-To: cvs-all@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 931) id 3861A37B401; Fri, 3 Jan 2003 12:14:06 -0800 (PST) Date: Fri, 3 Jan 2003 12:14:06 -0800 From: Juli Mallett To: Tony Finch Cc: Peter Wemm , "Alan L. Cox" , John Baldwin , Nate Lawson , cvs-committers@freebsd.org, cvs-all@freebsd.org, Alan Cox Subject: Re: cvs commit: src/sys/nfsclient nfs_vnops.c Message-ID: <20030103121406.A88673@FreeBSD.org> References: <3E14985A.35AB67F4@imimic.com> <20030103192950.0FC392A7EA@canning.wemm.org> <20030103195209.A15025@chiark.greenend.org.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20030103195209.A15025@chiark.greenend.org.uk>; from dot@dotat.at on Fri, Jan 03, 2003 at 07:52:09PM +0000 Organisation: The FreeBSD Project X-Alternate-Addresses: , , , , X-Towel: Yes X-LiveJournal: flata, jmallett X-Negacore: Yes Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG * De: Tony Finch [ 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 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