Bug 130151

Summary: The adding_user(8) man page should be moved to section 7
Product: Documentation Reporter: Marian Cerny <jojo>
Component: Books & ArticlesAssignee: Gabor Kovesdan <gabor>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Marian Cerny 2009-01-04 09:20:01 UTC
The adding_user(8) man page describes the process of adding a new user, so it should be probably placed into the section 7 (miscellaneous information pages), because there is no *utility* adding_user.

The HISTORY section of the adding_user(8) man page contains the following text:

    The adding_user utility appeared in 3.0BSD.

However there is no adding_user *utility*, so a different wording should be used. Probably something like:

    The adding_user manual page first appeared in 3.0BSD.

(Or without the word "first" if we don't know.)

Also the BUGS section probably does not give any sense and should be removed. For example intro(*), security(7) or hier(7) do not have the BUGS section.

Fix: 

1. move the man page to section 7
2. use different wording in HISTORY section
3. remove the BUGS section
How-To-Repeat: check the adding_user(8) manual page
Comment 1 dfilter service freebsd_committer freebsd_triage 2009-01-30 15:15:15 UTC
Author: gabor (doc,ports committer)
Date: Fri Jan 30 15:14:58 2009
New Revision: 187916
URL: http://svn.freebsd.org/changeset/base/187916

Log:
  - Rename adding_user(8) to adding_user(7). There's no adding_user utility,
    but the man page describes conceptual information about the process of
    adding a user, thus it should belong to section 7.
  - Remove HISTORY and BUGS sections because of the aforementioned reason.
  
  PR:		docs/130151
  Submitted by:	Marian Cerny <jojo@matfyz.cz>
  MFC after:	3 days

Added:
  head/share/man/man7/adding_user.7
     - copied, changed from r187915, head/share/man/man8/adding_user.8
Deleted:
  head/share/man/man8/adding_user.8
Modified:
  head/share/man/man7/Makefile
  head/share/man/man8/Makefile

Modified: head/share/man/man7/Makefile
==============================================================================
--- head/share/man/man7/Makefile	Fri Jan 30 14:28:50 2009	(r187915)
+++ head/share/man/man7/Makefile	Fri Jan 30 15:14:58 2009	(r187916)
@@ -2,7 +2,8 @@
 # $FreeBSD$
 
 #MISSING: eqnchar.7 ms.7 term.7
-MAN=	ascii.7 \
+MAN=	adding_user.7 \
+	ascii.7 \
 	bsd.snmpmod.mk.7 \
 	build.7 \
 	clocks.7 \

Copied and modified: head/share/man/man7/adding_user.7 (from r187915, head/share/man/man8/adding_user.8)
==============================================================================
--- head/share/man/man8/adding_user.8	Fri Jan 30 14:28:50 2009	(r187915, copy source)
+++ head/share/man/man7/adding_user.7	Fri Jan 30 15:14:58 2009	(r187916)
@@ -32,7 +32,7 @@
 .\"     @(#)adduser.8	8.1 (Berkeley) 6/5/93
 .\" $FreeBSD$
 .\"
-.Dd June 5, 1993
+.Dd Jan 30, 2009
 .Dt ADDING_USER 8
 .Os
 .Sh NAME
@@ -108,10 +108,3 @@ skeletal login directory
 .Xr adduser 8 ,
 .Xr pwd_mkdb 8 ,
 .Xr vipw 8
-.Sh HISTORY
-The
-.Nm
-utility appeared in
-.Bx 3.0 .
-.Sh BUGS
-User information should (and eventually will) be stored elsewhere.

Modified: head/share/man/man8/Makefile
==============================================================================
--- head/share/man/man8/Makefile	Fri Jan 30 14:28:50 2009	(r187915)
+++ head/share/man/man8/Makefile	Fri Jan 30 15:14:58 2009	(r187916)
@@ -1,8 +1,7 @@
 #	@(#)Makefile	8.1 (Berkeley) 6/5/93
 # $FreeBSD$
 
-MAN=	adding_user.8 \
-	crash.8 \
+MAN=	crash.8 \
 	diskless.8 \
 	intro.8 \
 	MAKEDEV.8 \
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 2 Gabor Kovesdan freebsd_committer freebsd_triage 2009-01-30 15:15:29 UTC
State Changed
From-To: open->patched

Fixed in HEAD, grab as an MFC reminder. 


Comment 3 Gabor Kovesdan freebsd_committer freebsd_triage 2009-01-30 15:15:29 UTC
Responsible Changed
From-To: freebsd-doc->gabor

Fixed in HEAD, grab as an MFC reminder.
Comment 4 dfilter service freebsd_committer freebsd_triage 2009-02-03 14:31:14 UTC
Author: gabor (doc,ports committer)
Date: Tue Feb  3 14:30:59 2009
New Revision: 188072
URL: http://svn.freebsd.org/changeset/base/188072

Log:
  MFC: r187916
    - Rename adding_user(8) to adding_user(7). There's no adding_user utility,
      but the man page describes conceptual information about the process of
      adding a user, thus it should belong to section 7.
    - Remove HISTORY and BUGS sections because of the aforementioned reason.
  
  PR:		docs/130151
  Submitted by:	Marian Cerny <jojo@matfyz.cz>

Added:
  stable/7/share/man/man7/adding_user.7
     - copied, changed from r188071, stable/7/share/man/man8/adding_user.8
Deleted:
  stable/7/share/man/man8/adding_user.8
Modified:
  stable/7/share/man/man7/Makefile
  stable/7/share/man/man8/Makefile

Modified: stable/7/share/man/man7/Makefile
==============================================================================
--- stable/7/share/man/man7/Makefile	Tue Feb  3 14:26:55 2009	(r188071)
+++ stable/7/share/man/man7/Makefile	Tue Feb  3 14:30:59 2009	(r188072)
@@ -2,7 +2,8 @@
 # $FreeBSD$
 
 #MISSING: eqnchar.7 ms.7 term.7
-MAN=	ascii.7 \
+MAN=	adding_user.7 \
+	ascii.7 \
 	bsd.snmpmod.mk.7 \
 	build.7 \
 	clocks.7 \

Copied and modified: stable/7/share/man/man7/adding_user.7 (from r188071, stable/7/share/man/man8/adding_user.8)
==============================================================================
--- stable/7/share/man/man8/adding_user.8	Tue Feb  3 14:26:55 2009	(r188071, copy source)
+++ stable/7/share/man/man7/adding_user.7	Tue Feb  3 14:30:59 2009	(r188072)
@@ -32,7 +32,7 @@
 .\"     @(#)adduser.8	8.1 (Berkeley) 6/5/93
 .\" $FreeBSD$
 .\"
-.Dd June 5, 1993
+.Dd Jan 30, 2009
 .Dt ADDING_USER 8
 .Os
 .Sh NAME
@@ -108,10 +108,3 @@ skeletal login directory
 .Xr adduser 8 ,
 .Xr pwd_mkdb 8 ,
 .Xr vipw 8
-.Sh HISTORY
-The
-.Nm
-utility appeared in
-.Bx 3.0 .
-.Sh BUGS
-User information should (and eventually will) be stored elsewhere.

Modified: stable/7/share/man/man8/Makefile
==============================================================================
--- stable/7/share/man/man8/Makefile	Tue Feb  3 14:26:55 2009	(r188071)
+++ stable/7/share/man/man8/Makefile	Tue Feb  3 14:30:59 2009	(r188072)
@@ -1,8 +1,7 @@
 #	@(#)Makefile	8.1 (Berkeley) 6/5/93
 # $FreeBSD$
 
-MAN=	adding_user.8 \
-	crash.8 \
+MAN=	crash.8 \
 	diskless.8 \
 	intro.8 \
 	MAKEDEV.8 \
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 5 dfilter service freebsd_committer freebsd_triage 2009-02-03 14:32:23 UTC
Author: gabor (doc,ports committer)
Date: Tue Feb  3 14:32:06 2009
New Revision: 188073
URL: http://svn.freebsd.org/changeset/base/188073

Log:
  MFC: r187916
    - Rename adding_user(8) to adding_user(7). There's no adding_user utility,
      but the man page describes conceptual information about the process of
      adding a user, thus it should belong to section 7.
    - Remove HISTORY and BUGS sections because of the aforementioned reason.
  
  PR:		docs/130151
  Submitted by:	Marian Cerny <jojo@matfyz.cz>

Added:
  stable/6/share/man/man7/adding_user.7
     - copied, changed from r188071, stable/6/share/man/man8/adding_user.8
Deleted:
  stable/6/share/man/man8/adding_user.8
Modified:
  stable/6/share/man/man7/Makefile
  stable/6/share/man/man8/Makefile

Modified: stable/6/share/man/man7/Makefile
==============================================================================
--- stable/6/share/man/man7/Makefile	Tue Feb  3 14:30:59 2009	(r188072)
+++ stable/6/share/man/man7/Makefile	Tue Feb  3 14:32:06 2009	(r188073)
@@ -2,7 +2,8 @@
 # $FreeBSD$
 
 #MISSING: eqnchar.7 ms.7 term.7
-MAN=	ascii.7 \
+MAN=	adding_user.7 \
+	ascii.7 \
 	bsd.snmpmod.mk.7 \
 	build.7 \
 	clocks.7 \

Copied and modified: stable/6/share/man/man7/adding_user.7 (from r188071, stable/6/share/man/man8/adding_user.8)
==============================================================================
--- stable/6/share/man/man8/adding_user.8	Tue Feb  3 14:26:55 2009	(r188071, copy source)
+++ stable/6/share/man/man7/adding_user.7	Tue Feb  3 14:32:06 2009	(r188073)
@@ -32,7 +32,7 @@
 .\"     @(#)adduser.8	8.1 (Berkeley) 6/5/93
 .\" $FreeBSD$
 .\"
-.Dd June 5, 1993
+.Dd Jan 30, 2009
 .Dt ADDING_USER 8
 .Os
 .Sh NAME
@@ -108,10 +108,3 @@ skeletal login directory
 .Xr adduser 8 ,
 .Xr pwd_mkdb 8 ,
 .Xr vipw 8
-.Sh HISTORY
-The
-.Nm
-utility appeared in
-.Bx 3.0 .
-.Sh BUGS
-User information should (and eventually will) be stored elsewhere.

Modified: stable/6/share/man/man8/Makefile
==============================================================================
--- stable/6/share/man/man8/Makefile	Tue Feb  3 14:30:59 2009	(r188072)
+++ stable/6/share/man/man8/Makefile	Tue Feb  3 14:32:06 2009	(r188073)
@@ -1,8 +1,7 @@
 #	@(#)Makefile	8.1 (Berkeley) 6/5/93
 # $FreeBSD$
 
-MAN=	adding_user.8 \
-	crash.8 \
+MAN=	crash.8 \
 	diskless.8 \
 	intro.8 \
 	MAKEDEV.8 \
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 6 Gabor Kovesdan freebsd_committer freebsd_triage 2009-02-03 14:32:58 UTC
State Changed
From-To: patched->closed

Committed, thanks!