Subject: Re: misc/35718: security(8) should be renamed to not be confused as
To: None <,,>
From: Jeremy C. Reed <>
List: netbsd-bugs
Date: 02/19/2007 21:20:02
The following reply was made to PR misc/35718; it has been noted by GNATS.

From: "Jeremy C. Reed" <>
Subject: Re: misc/35718: security(8) should be renamed to not be confused as
 a man page for the /etc/security script
Date: Mon, 19 Feb 2007 15:18:46 -0600 (CST)

 On Mon, 19 Feb 2007, Greg A. Woods wrote:
 > 	The new security(8) manual page should be renamed such that it
 > 	cannot be confused as a manual page for the /etc/security
 > 	script.
 > 	There should also be a section-8 manual page for all the
 > 	standard cron-driven system management and maintenance scripts
 > 	too I suppose.
 I recently proposed that. At first my diff has security.8 also because I 
 forgot about existing security(8).
 Index: share/man/man5/Makefile
 RCS file: /cvsroot/src/share/man/man5/Makefile,v
 retrieving revision 1.56
 diff -u -r1.56 Makefile
 --- share/man/man5/Makefile	12 Dec 2005 22:26:53 -0000	1.56
 +++ share/man/man5/Makefile	19 Feb 2007 21:15:31 -0000
 @@ -20,6 +20,9 @@
  MLINKS=	dir.5 dirent.5 fs.5 inode.5 hosts.equiv.5 rhosts.5
  MLINKS+=utmp.5 wtmp.5 utmp.5 lastlog.5 passwd.5 master.passwd.5
  MLINKS+=utmpx.5 wtmpx.5 utmpx.5 lastlogx.5
 +MLINKS+=daily.conf.5 daily.8 monthly.conf.5 monthly.8 weekly.conf.5 weekly.8
 +# No symlink is done for security.conf.5 because we have a
 +# different security.8 already.
  .include <>
  .include <>
 > >Fix:
 > 	One possibility to dealing with the security(8) conflict would
 > 	be to move the page about systems security into section 7.
 That is what I am thinking also:
 > 	The problem with section 8 of BSD's manual is that it is
 > 	over-loaded in meaning.  That was one of the really nice
 > 	things about the UNIX manuals having *m sections for
 > 	maintenance and management related programs and files and such
 > 	and not cluttering any section with both references for
 > 	specific commands and files along with other general
 > 	information.
 > 	In fact it might be nice if all the manual pages similar to
 > 	this new security(8) manual page, i.e. the ones which don't
 > 	explicitly deal with files, programs, or APIs, were moved into
 > 	share/doc where they could be made chapters in the relevant
 > 	book.  It would also be nice if "man" or some similar tool
 > 	(e.g. "doc") could display (and search!) online readable
 > 	copies of the share/doc books too of course.
 > 	I could provide the missing cron-script manual pages as
 > 	starters if that would help.
 What are they?
 > 	I'd be happy to help edit some existing documents into
 > 	suitable form to be used as chapters in share/doc books too.
 > 	I could even help convert some of the share/doc books into
 > 	mdoc intput too, since that might help make them more usable
 > 	and easier to maintain and add onto in the ways I'm suggesting.
 Can you bring that up on maybe tech-userlevel list instead of proposing 
 that part in a PR?
   Jeremy C. Reed