From owner-cvs-src@FreeBSD.ORG Thu May 18 18:24:30 2006 Return-Path: X-Original-To: cvs-src@FreeBSD.org Delivered-To: cvs-src@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 467BD16A464; Thu, 18 May 2006 18:24:30 +0000 (UTC) (envelope-from phk@critter.freebsd.dk) Received: from phk.freebsd.dk (phk.freebsd.dk [130.225.244.222]) by mx1.FreeBSD.org (Postfix) with ESMTP id 546B243D5D; Thu, 18 May 2006 18:24:28 +0000 (GMT) (envelope-from phk@critter.freebsd.dk) Received: from critter.freebsd.dk (unknown [192.168.48.2]) by phk.freebsd.dk (Postfix) with ESMTP id AF9FF170DE; Thu, 18 May 2006 18:24:25 +0000 (UTC) Received: from critter.freebsd.dk (localhost [127.0.0.1]) by critter.freebsd.dk (8.13.6/8.13.6) with ESMTP id k4IIOOgu040195; Thu, 18 May 2006 20:24:25 +0200 (CEST) (envelope-from phk@critter.freebsd.dk) To: Warner Losh From: "Poul-Henning Kamp" In-Reply-To: Your message of "Thu, 18 May 2006 12:21:22 MDT." <20060518.122122.71180479.imp@bsdimp.com> Date: Thu, 18 May 2006 20:24:24 +0200 Message-ID: <40194.1147976664@critter.freebsd.dk> Sender: phk@critter.freebsd.dk Cc: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, gnn@neville-neil.com, cvs-all@FreeBSD.org, 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 ... X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 May 2006 18:24:34 -0000 In message <20060518.122122.71180479.imp@bsdimp.com>, Warner Losh writes: >> I've not been very impressed with what I've seen from sources using >> this approach, but I guess having the prototypes with one line >> comments is better than nothing. > >Doxygen does more than one line, and you get out of it the effort that >you put into it as far as quality goes. That was sort of what I hinted at: most places I've seen don't seem to have the follow-through to actually get more than the prototypes out. -- Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 phk@FreeBSD.ORG | TCP/IP since RFC 956 FreeBSD committer | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence.