From owner-freebsd-current Wed Jan 7 10:25:04 1998 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.7/8.8.7) id KAA24564 for current-outgoing; Wed, 7 Jan 1998 10:25:04 -0800 (PST) (envelope-from owner-freebsd-current) Received: from news1.gtn.com (news1.gtn.com [194.77.0.15]) by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id KAA24519 for ; Wed, 7 Jan 1998 10:24:31 -0800 (PST) (envelope-from andreas@klemm.gtn.com) Received: (from uucp@localhost) by news1.gtn.com (8.8.6/8.8.6) with UUCP id TAA17164; Wed, 7 Jan 1998 19:15:15 +0100 (MET) Received: (from andreas@localhost) by klemm.gtn.com (8.8.8/8.8.7) id SAA08784; Wed, 7 Jan 1998 18:12:22 +0100 (CET) (envelope-from andreas) Message-ID: <19980107181222.37726@klemm.gtn.com> Date: Wed, 7 Jan 1998 18:12:22 +0100 From: Andreas Klemm To: "Jordan K. Hubbard" Cc: Bruce Evans , jak@cetlink.net, current@FreeBSD.ORG Subject: Re: LINT is missing examples for sio1-3 ? GENERIC does so References: <199801070956.UAA08688@godzilla.zeta.org.au> <18215.884173374@time.cdrom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.88 In-Reply-To: <18215.884173374@time.cdrom.com>; from Jordan K. Hubbard on Wed, Jan 07, 1998 at 03:42:54AM -0800 X-Disclaimer: A free society is one where it is safe to be unpopular X-Operating-System: FreeBSD 3.0-CURRENT SMP Sender: owner-freebsd-current@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk On Wed, Jan 07, 1998 at 03:42:54AM -0800, Jordan K. Hubbard wrote: > > Unfortunately, I have to note in regard to this last point that it > very definitely *has* become documentation and whether that was > anyone's original intentions or not. It has simply evolved, like so > many things in FreeBSD. I and many other people use "see LINT" as > a popular answer to kernel configuration questions ... Hmm, to second that, it's certainly easier for a developer, to add a quick note into LINT in ASCII, if a new feature comes up, than to think about writing/changing documentation in SGML. That should/could be done by people, who have committed themselves to write documentation. I'll wait some time before I'm going to commit the changes, I respect all of your pros and cons. But I think what Jordan lastly said reflects every days practice. I always dig around in LINT if I'm going to configure the kernel .... And I'm really happy, if I find a good piece of information .... That's indeed user friendly. Andreas /// -- Andreas Klemm powered by ,,symmetric multiprocessor FreeBSD''