Subject: Re: CVS commit: src
To: Elad Efrat <elad@NetBSD.org>
From: Daniel Carosone <dan@geek.com.au>
List: source-changes
Date: 09/20/2006 08:19:23
--1Esft9Qf9QCvZ1MH
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Sep 20, 2006 at 01:03:17AM +0200, Elad Efrat wrote:
> >> Remove securelevel-related text from init(8) man-page as they're now in
> >> secmodel_bsd44(9).
> >=20
> > That was not documentation for kernel programmers. Please fix this comm=
it
> > so the documentation remains available for those who don't have comp.tgz
> > installed.
> >=20
> > (maybe move the man page to secmodel_bsd44.7 ?)
>=20
> Let's wait for others voice in; I don't really mind.

init(8) was always a kind of odd / non-obvious place for securelevel
to be documented, but I agree with Pavel too - this is not programmer
info in section 9 either.  Wherever it ends up, the most important
thing is that it's well cross-referenced from sysctl(8), init(8) (for
historical reasons), secmodel(9), etc. so that people can find it.

maybe a sysctl.conf(4) similar to options(4) that can document the
important knobs and act as an index to other more specific pages?

--
Dan.

--1Esft9Qf9QCvZ1MH
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (NetBSD)

iD8DBQFFEGzqEAVxvV4N66cRAiAgAKDFIo8QhWRsw70dTuqOwZSbZS6KUQCfY6tW
p+0MxJfe4jh7yrjhopfF7lg=
=JIQH
-----END PGP SIGNATURE-----

--1Esft9Qf9QCvZ1MH--