Aligning GENERIC with NOTES?

[Quincey Koziol]

Hi David,

> Date: Sat, 21 Feb 2004 22:52:39 -0800
> From: David Syphers <dsyphers at u.washington.edu>
> Subject: Re: Aligning GENERIC with NOTES?
> To: freebsd-current at freebsd.org
> Message-ID: <200402212252.39420.dsyphers at u.washington.edu>
> Content-Type: text/plain;  charset="iso-8859-1"
> 
> Since you seem determined to do this...
    Not at all - I don't have a commit bit after all... :-)  I just wanted to
give something back to FreeBSD after being happy to use it all these years and
this was something straightforward I could help with.

> On Saturday 21 February 2004 10:21 pm, Quincey Koziol wrote:
> >     I've tried to add information from the NOTES files where appropriate,
> 
> This is nice info to have, but absolutely _not_ in GENERIC. Making a file like 
> GENERIC.comments might not be a bad idea. Having these comments in GENERIC 
> makes it a pain to edit by hand, which I do often (so many lines that have 
> nothing to do with real content). Having a separate file with these would 
> still help out beginners (would have helped me back then), but wouldn't 
> severely inconvenience people who know what they're doing, like your current 
> setup does.
> 
> Also... everyone has their own idea of logical. Example: you don't have 
> WITNESS under debugging options. And SMP debugging options are next to 
> neither regular debugging options nor SMP options. Maybe that makes sense to 
> you.
    The order doesn't totally seem "logical" to me - I was just trying to make
it closer to the order and format of things in the NOTES files.

> Still, you do have a decent case that GENERIC could be put in slightly more 
> logical order, and I agree with some of your changes. Here's hoping that it 
> turns out well,
    It doesn't have to be this order, I'm just offering my suggestions.

        Quincey