From owner-cvs-all Fri Jan 3 11:52:43 2003 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3969237B401; Fri, 3 Jan 2003 11:52:42 -0800 (PST) Received: from chiark.greenend.org.uk (chiark.greenend.org.uk [193.201.200.170]) by mx1.FreeBSD.org (Postfix) with ESMTP id AF70D43ED4; Fri, 3 Jan 2003 11:52:40 -0800 (PST) (envelope-from fanf@chiark.greenend.org.uk) Received: from fanf by chiark.greenend.org.uk with local (Exim 3.12 #1) id 18UXrV-00084Y-00 (Debian); Fri, 03 Jan 2003 19:52:09 +0000 Date: Fri, 3 Jan 2003 19:52:09 +0000 From: Tony Finch To: Peter Wemm Cc: "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: <20030103195209.A15025@chiark.greenend.org.uk> References: <3E14985A.35AB67F4@imimic.com> <20030103192950.0FC392A7EA@canning.wemm.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20030103192950.0FC392A7EA@canning.wemm.org>; from peter@wemm.org on Fri, Jan 03, 2003 at 11:29:50AM -0800 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 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. Tony. -- f.a.n.finch http://dotat.at/ BISCAY: SOUTHWESTERLY 6 TO GALE 8, OCCASIONALLY SEVERE GALE 9 IN SOUTH AT FIRST, DECREASING NORTHERLY 3 OR 4. THUNDERY SHOWERS. MODERATE OR GOOD. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message