Subject: Re: CVS commit: src/sbin/init
To: None <salo@Xtrmntr.org>
From: M. Warner Losh <imp@bsdimp.com>
List: source-changes
Date: 05/23/2007 20:52:48
In message: <20070324000920.GU27487@Xtrmntr.org>
            Lubomir Sedlacik <salo@Xtrmntr.org> writes:
: On Sat, Mar 24, 2007 at 12:57:43AM +0100, Hubert Feyrer wrote:
: > On Fri, 23 Mar 2007, Lubomir Sedlacik wrote:
: > >the point is, it's _not_ similar.  as mrg mentioned it tries to solve
: > >the same problem but in a different way.  i am not sure it's
: > >appropriate to refer to features of other operating systems in our
: > >manual pages, where would it stop?
: > 
: > Just there: I often see people ask "how can I do X in NetBSD?", and
: > the answer usually is "X is not available in NetBSD, your problem can
: > be solved by using Y".
: > 
: > Pointing people with "pivot root" on their mind to the right place was
: > the idea for this change.
: > 
: > And eventually getting one less complaint that our documentation
: > sucks...
: 
: i understand what you intent is and what you describe would be fine for
: e.g., the Guide or some FAQ, but not for the manual page.  our manual
: pages should describe the functionality of our operating system, not how
: similar problems are solved in other systems.  you don't see iptables
: terminology mentioned in ipf manual pages, neither you see lilo features
: listed in boot(8).
: 
: one last time i ask you to back it out, please.

But we have 'see also' sections for that.

Warner