From owner-cvs-src@FreeBSD.ORG  Thu May 18 23:37:20 2006
Return-Path: <owner-cvs-src@FreeBSD.ORG>
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 EAA5A16A40E;
	Thu, 18 May 2006 23:37:20 +0000 (UTC) (envelope-from imp@bsdimp.com)
Received: from harmony.bsdimp.com (vc4-2-0-87.dsl.netrack.net [199.45.160.85])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 83CDA43D45;
	Thu, 18 May 2006 23:37:20 +0000 (GMT) (envelope-from imp@bsdimp.com)
Received: from localhost (localhost.village.org [IPv6:::1] (may be forged))
	by harmony.bsdimp.com (8.13.4/8.13.4) with ESMTP id k4INZZai095467;
	Thu, 18 May 2006 17:35:38 -0600 (MDT) (envelope-from imp@bsdimp.com)
Date: Thu, 18 May 2006 17:35:35 -0600 (MDT)
Message-Id: <20060518.173535.70130518.imp@bsdimp.com>
To: phk@phk.freebsd.dk
From: Warner Losh <imp@bsdimp.com>
In-Reply-To: <40194.1147976664@critter.freebsd.dk>
References: <20060518.122122.71180479.imp@bsdimp.com>
	<40194.1147976664@critter.freebsd.dk>
X-Mailer: Mew version 3.3 on Emacs 21.3 / Mule 5.0 (SAKAKI)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
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 <cvs-src.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-src>,
	<mailto:cvs-src-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-src>
List-Post: <mailto:cvs-src@freebsd.org>
List-Help: <mailto:cvs-src-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-src>,
	<mailto:cvs-src-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 18 May 2006 23:37:21 -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.

Yes.  It takes everyone pulling together to make it work.

Warner