NetBSD Problem Report #40293

From www@NetBSD.org  Tue Dec 30 02:16:35 2008
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id 41EA163B8BD
	for <gnats-bugs@gnats.netbsd.org>; Tue, 30 Dec 2008 02:16:35 +0000 (UTC)
Message-Id: <20081230021635.0789F63B121@narn.NetBSD.org>
Date: Tue, 30 Dec 2008 02:16:35 +0000 (UTC)
From: bughunting@xs4all.nl
Reply-To: bughunting@xs4all.nl
To: gnats-bugs@NetBSD.org
Subject: afterboot(8) manpage contains minor error(s) and needs updating
X-Send-Pr-Version: www-1.0

>Number:         40293
>Category:       misc
>Synopsis:       afterboot(8) manpage contains minor error(s) and needs updating
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Dec 30 02:20:01 +0000 2008
>Closed-Date:    Wed Feb 17 00:51:35 +0000 2010
>Last-Modified:  Wed Feb 17 00:51:35 +0000 2010
>Originator:     Bug Hunting
>Release:        5.99.5
>Organization:
>Environment:
>Description:
The following commands/manpages are, in order of appearance,
mentioned in the text, and could (or: should) therefore be
mentioned in the `SEE ALSO'-section as well:

   ssh(1), sshd_config(5), wscons.conf(5), dhclient(8),
   dhclient.conf(5), ifconfig.if(5), nsswitch.conf(5), rpcbind(8),
   yp(8), ntpdate(8), ntpd(8), rdate(8), timed(8), groupadd(8),
   user(8), xdm(1), lpd(8), printcap(5), pkg_add(1), ps(1), fstat(1),
   systat(1), top(1), dmesg(8)

(The ls(1) manpage, mentioned in the beginning of the manpage, is
left out of this list since it is only referenced as an example.)

The following manpages are mentioned in the `SEE ALSO'-section but
not in the text; it could be deciced whether or not they are to be
kept in that section (however, most, if not all, can be kept indeed):

   config(1), crontab(1), make(1), man(1), aliases(5), exports(5),
   krb.conf(5), krb.realms(5), mailer.conf(5), hier(7), hostname(7),
   pkgsrc(7), bootparamd(8), inetd(8), rbootd(8), rc(8), rmt(8),
   ypbind(8)

Additionally, although not explicitly mentioned in the text, sshd(8)
could be listed in the `SEE ALSO'-section as well.

`adduser(8)', mentioned in the `SEE ALSO'-section, could better be
changed to `useradd(8)' since that is what the command is actually
called.

A `,' is proposed to be changed to a `;'.
>How-To-Repeat:
"man 8 afterboot"
>Fix:
Proposed patch:


$ cvs diff -u share/man/man8/afterboot.8
Index: share/man/man8/afterboot.8
===================================================================
RCS file: /cvsroot/src/share/man/man8/afterboot.8,v
retrieving revision 1.38
diff -u -r1.38 afterboot.8
--- share/man/man8/afterboot.8  21 Oct 2008 08:43:15 -0000      1.38
+++ share/man/man8/afterboot.8  30 Dec 2008 02:13:37 -0000
@@ -575,7 +575,7 @@
 To add new users and groups, there are
 .Xr useradd 8
 and
-.Xr groupadd 8 ,
+.Xr groupadd 8 ;
 see also
 .Xr user 8
 for further programs for user and group manipulation.
@@ -981,47 +981,72 @@
 .Xr date 1 ,
 .Xr df 1 ,
 .Xr domainname 1 ,
+.Xr fstat 1 ,
 .Xr hostname 1 ,
 .Xr make 1 ,
 .Xr man 1 ,
 .Xr netstat 1 ,
 .Xr newaliases 1 ,
 .Xr passwd 1 ,
+.Xr pkg_add 1 ,
+.Xr ps 1 ,
+.Xr ssh 1 ,
 .Xr su 1 ,
+.Xr systat 1 ,
+.Xr top 1 ,
+.Xr xdm 1 ,
 .Xr ccd 4 ,
 .Xr aliases 5 ,
 .Xr crontab 5 ,
+.Xr dhclient.conf 5 ,
 .Xr exports 5 ,
 .Xr fstab 5 ,
 .Xr group 5 ,
+.Xr ifconfig.if 5 ,
 .Xr krb.conf 5 ,
 .Xr krb.realms 5 ,
 .Xr mailer.conf 5 ,
+.Xr nsswitch.conf 5 ,
 .Xr passwd 5 ,
+.Xr printcap 5 ,
 .Xr rc.conf 5 ,
 .Xr resolv.conf 5 ,
+.Xr sshd_config 5 ,
+.Xr wscons.cfg 5 ,
 .Xr hier 7 ,
 .Xr hostname 7 ,
 .Xr pkgsrc 7 ,
-.Xr adduser 8 ,
 .Xr amd 8 ,
 .Xr bootparamd 8 ,
 .Xr ccdconfig 8 ,
 .Xr chown 8 ,
+.Xr dhclient 8 ,
 .Xr dhcpd 8 ,
+.Xr dmesg 8 ,
+.Xr groupadd 8 ,
 .Xr ifconfig 8 ,
 .Xr inetd 8 ,
 .Xr kerberos 8 ,
+.Xr lpd 8 ,
 .Xr mount 8 ,
 .Xr mrouted 8 ,
 .Xr mtree 8 ,
 .Xr named 8 ,
+.Xr ntpd 8 ,
+.Xr ntpdate 8 ,
 .Xr rbootd 8 ,
 .Xr rc 8 ,
+.Xr rdate 8 ,
 .Xr rmt 8 ,
 .Xr route 8 ,
+.Xr rpcbind 8 ,
+.Xr sshd 8 ,
+.Xr timed 8 ,
 .Xr umount 8 ,
+.Xr user 8 ,
+.Xr useradd 8 ,
 .Xr vipw 8 ,
+.Xr yp 8 ,
 .Xr ypbind 8
 .Sh HISTORY
 This document first appeared in

>Release-Note:

>Audit-Trail:
From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/40293 CVS commit: src/share/man/man8
Date: Wed, 17 Feb 2010 00:49:21 +0000

 Module Name:	src
 Committed By:	snj
 Date:		Wed Feb 17 00:49:21 UTC 2010

 Modified Files:
 	src/share/man/man8: afterboot.8

 Log Message:
 Fix punctuation and update "SEE ALSO" section.  From Bug Hunting in
 PR misc/40293.


 To generate a diff of this commit:
 cvs rdiff -u -r1.45 -r1.46 src/share/man/man8/afterboot.8

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: snj@NetBSD.org
State-Changed-When: Wed, 17 Feb 2010 00:51:35 +0000
State-Changed-Why:
Slightly modified version committed.  Thanks!


>Unformatted:

Home	PR Database Search