From owner-freebsd-current Sun Jan 23 18:24:36 2000 Delivered-To: freebsd-current@freebsd.org Received: from khavrinen.lcs.mit.edu (khavrinen.lcs.mit.edu [18.24.4.193]) by hub.freebsd.org (Postfix) with ESMTP id BD32415607; Sun, 23 Jan 2000 18:24:25 -0800 (PST) (envelope-from wollman@khavrinen.lcs.mit.edu) Received: (from wollman@localhost) by khavrinen.lcs.mit.edu (8.9.3/8.9.3) id VAA02060; Sun, 23 Jan 2000 21:24:19 -0500 (EST) (envelope-from wollman) Date: Sun, 23 Jan 2000 21:24:19 -0500 (EST) From: Garrett Wollman Message-Id: <200001240224.VAA02060@khavrinen.lcs.mit.edu> To: Peter Jeremy Cc: FreeBSD CURRENT Mailing List , doc@FreeBSD.ORG Group-Reply-To: doc@freebsd.org Folowup-To: doc@freebsd.org Subject: Re: With feature freeze being in place In-Reply-To: <00Jan24.111112est.115220@border.alcanet.com.au> References: <20000122210136.B18600@daemon.ninth-circle.org> <00Jan24.111112est.115220@border.alcanet.com.au> Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG < said: > Comparing LINT and GENERIC is made more difficult by the significantly > different ordering. Is there some good reason for this, or would an > offer of GENERIC re-written into the same order as LINT be accepted? Speaking as the person who attempted to impart some semblance of order to LINT after it last outgrew its britches.... LINT was organized so as to group related devices together, along with their options. It is not particularly attempting to ape GENERIC (or vice versa!) but was rather organized so as to assist Jane User in locating the obscure option she needs to make the mumblefrotz driver gronkulate properly. Of course, at the same time, it's also trying to be a tool to enhance test coverage. So, generally speaking, options that users might need to set should be described near the devices or subsystems to which they pertain. Options that users don't need to set shouldn't exist at all. In general, the descriptions should be succinct and descriptive in nature; for more information, the user should be directed to a manual page. (IWBRNI the config manual were updated with information about how config works now, and descriptions of all the options and devices were added. Any troff weenies out there looking to make a heroic landing on SMM:02 atoll?) > Also, what is the best approach to submitting documentation for the > `undocumented' options in LINT? Organized them usefully, and send in one giant patch. Then nag people for a few months (updating the giant patch as required to merge changes) until it gets committed. -GAWollman -- Garrett A. Wollman | O Siem / We are all family / O Siem / We're all the same wollman@lcs.mit.edu | O Siem / The fires of freedom Opinions not those of| Dance in the burning flame MIT, LCS, CRS, or NSA| - Susan Aglukark and Chad Irschick To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message