| Summary: | The adding_user(8) man page should be moved to section 7 | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Marian Cerny <jojo> |
| Component: | Books & Articles | Assignee: | Gabor Kovesdan <gabor> |
| Status: | Closed FIXED | ||
| Severity: | Affects Only Me | ||
| Priority: | Normal | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
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: open->patched Fixed in HEAD, grab as an MFC reminder. Responsible Changed From-To: freebsd-doc->gabor Fixed in HEAD, grab as an MFC reminder. 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" 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" State Changed From-To: patched->closed Committed, thanks! |
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