From owner-freebsd-current Wed Jan 7 02:00:39 1998 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.7/8.8.7) id CAA07530 for current-outgoing; Wed, 7 Jan 1998 02:00:39 -0800 (PST) (envelope-from owner-freebsd-current) Received: from godzilla.zeta.org.au (godzilla.zeta.org.au [203.2.228.19]) by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id CAA07525 for ; Wed, 7 Jan 1998 02:00:34 -0800 (PST) (envelope-from bde@godzilla.zeta.org.au) Received: (from bde@localhost) by godzilla.zeta.org.au (8.8.7/8.8.7) id UAA08688; Wed, 7 Jan 1998 20:56:41 +1100 Date: Wed, 7 Jan 1998 20:56:41 +1100 From: Bruce Evans Message-Id: <199801070956.UAA08688@godzilla.zeta.org.au> To: andreas@klemm.gtn.com, jak@cetlink.net Subject: Re: LINT is missing examples for sio1-3 ? GENERIC does so Cc: bde@zeta.org.au, current@FreeBSD.ORG, jkh@time.cdrom.com Sender: owner-freebsd-current@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk >> Yeah, but some of us dim-witted users benefit from those examples >> which are so uninteresting to the intellectual elite. > >hahaha ;-) Ok, that's another point ;-) > >Ok, what about that ... When reading LINT as it is now, it's >a "real fine thing (tm)". It's a central place of information, >that tells you very quickly, what the kernel with it's driver >and options is able to do for you. > >So, another point of view might be, reading manpages is fine >and I suggest it to every user ... but: > > - time is money (sometime more sometimes less precious ;-) I agree. That's why I don't want extra copies of the documentation :-). > - LINT already is a comprehend/central list of information > - and i think, LINT is kind of user/admin friendly. Isn't the handbook supposed to be central and user-friendly? I don't have time to read it :-). >Since GENERIC contains examples for the serial interfaces, >shouldn't we sync it ... because not every FreeBSD newbee is >an expert in "RTFM" and such ? Newbies shouldn't know to look there. It's never been in sync with GENERIC and has always had a different purpose. It's original purpose wasn't documentation - it was for checking the kernel sources, and tthats all I use it for. See the log message for rev.1.1. Bruce