From owner-cvs-src@FreeBSD.ORG Thu May 18 17:40:02 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 1720316A530; Thu, 18 May 2006 17:40:02 +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 BFBE343D6E; Thu, 18 May 2006 17:39:55 +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 5DA47170DE; Thu, 18 May 2006 17:39:53 +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 k4IHdnTk039978; Thu, 18 May 2006 19:39:49 +0200 (CEST) (envelope-from phk@critter.freebsd.dk) To: "George V. Neville-Neil" From: "Poul-Henning Kamp" In-Reply-To: Your message of "Thu, 18 May 2006 10:14:26 PDT." Date: Thu, 18 May 2006 19:39:49 +0200 Message-ID: <39977.1147973989@critter.freebsd.dk> Sender: phk@critter.freebsd.dk Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org, Julian Elischer , cvs-all@FreeBSD.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 17:40:03 -0000 In message , "George V. Neville-Neil" write s: >At Thu, 18 May 2006 15:47:30 +0200, >Poul-Henning Kamp wrote: >> Part of the problem is that there will never be a "definitive kernel >> API manual" for FreeBSD, it will always be in flux and therefore >> drivers will need to be updated to keep abreast. > >I so hate to chime in on this thread, but I really think we need to >start putting things into the code and using Doxygen, or a moral >equivalent, to at least have a chance of keeping such things up to >date. Someone a while back set up a proper Doxygen file for use with >FreeBSD and we might simply pursue that tack. 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. -- 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.