From nobody@FreeBSD.org  Sun Jan  4 09:16:10 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id C1333106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  4 Jan 2009 09:16:10 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id B0FB38FC08
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  4 Jan 2009 09:16:10 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n049GAQk081534
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 4 Jan 2009 09:16:10 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n049GA33081533;
	Sun, 4 Jan 2009 09:16:10 GMT
	(envelope-from nobody)
Message-Id: <200901040916.n049GA33081533@www.freebsd.org>
Date: Sun, 4 Jan 2009 09:16:10 GMT
From: Marian Cerny <jojo@matfyz.cz>
To: freebsd-gnats-submit@FreeBSD.org
Subject: The adding_user(8) man page should be moved to section 7
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         130151
>Category:       docs
>Synopsis:       The adding_user(8) man page should be moved to section 7
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gabor
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jan 04 09:20:01 UTC 2009
>Closed-Date:    Tue Feb 03 14:33:11 UTC 2009
>Last-Modified:  Tue Feb  3 14:40:08 UTC 2009
>Originator:     Marian Cerny
>Release:        6.3-RELEASE-p2
>Organization:
>Environment:
6.3-RELEASE-p2
>Description:
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.
>How-To-Repeat:
check the adding_user(8) manual page
>Fix:
1. move the man page to section 7
2. use different wording in HISTORY section
3. remove the BUGS section

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: gabor 
State-Changed-When: Fri Jan 30 15:15:29 UTC 2009 
State-Changed-Why:  
Fixed in HEAD, grab as an MFC reminder. 


Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Fri Jan 30 15:15:29 UTC 2009 
Responsible-Changed-Why:  
Fixed in HEAD, grab as an MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=130151 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/130151: commit references a PR
Date: Fri, 30 Jan 2009 15:15:15 +0000 (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"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gabor 
State-Changed-When: Tue Feb 3 14:32:58 UTC 2009 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=130151 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/130151: commit references a PR
Date: Tue,  3 Feb 2009 14:31:14 +0000 (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"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/130151: commit references a PR
Date: Tue,  3 Feb 2009 14:32:23 +0000 (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"
 
>Unformatted:
