From swear@attbi.com  Sun Oct  6 21:38:24 2002
Return-Path: <swear@attbi.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B34FF37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  6 Oct 2002 21:38:24 -0700 (PDT)
Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 182B543E91
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  6 Oct 2002 21:38:24 -0700 (PDT)
	(envelope-from swear@attbi.com)
Received: from localhost.localdomain ([12.242.158.67])
          by sccrmhc03.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20021007043823.QNJB22381.sccrmhc03.attbi.com@localhost.localdomain>
          for <FreeBSD-gnats-submit@freebsd.org>;
          Mon, 7 Oct 2002 04:38:23 +0000
Received: from localhost.localdomain (localhost [127.0.0.1])
	by localhost.localdomain (8.12.5/8.12.5) with ESMTP id g974f8oS065940
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 6 Oct 2002 21:41:08 -0700 (PDT)
	(envelope-from swear@attbi.com)
Received: (from jojo@localhost)
	by localhost.localdomain (8.12.5/8.12.5/Submit) id g974f24g065937;
	Sun, 6 Oct 2002 21:41:02 -0700 (PDT)
	(envelope-from swear@attbi.com)
Message-Id: <f2r8f27tep.8f2@localhost.localdomain>
Date: 06 Oct 2002 21:41:02 -0700
From: "Gary W. Swearingen" <swear@attbi.com>
Reply-To: swear@attbi.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: chpass(1) manual unclear about alternate name behavior
X-GNATS-Notify:

>Number:         43756
>Category:       docs
>Synopsis:       chpass(1) manual unclear about alternate name behavior
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 06 21:40:02 PDT 2002
>Closed-Date:    Fri Dec 20 10:22:46 PST 2002
>Last-Modified:  Fri Dec 20 10:22:46 PST 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The chpass(1) manual is unclear about whether, for example, chfn(1) and
chsh(1) behave the same as each other and chpass(1), or if the manual is
just incomplete about their possible differing behavior.  (It's rather
hard to believe that "chfn" and "chsh" do the same thing, without it being
stated more explicitly than just that they are linked to chpass.)

Also, the descriptions of most of the commands in the "NAME" section are
inappropriately relegated to a "NOTES" section near the end of the
manual, instead of in the "DESCRIPTIONS" section.

================
>How-To-Repeat:
n/a
================
>Fix:

In
$FreeBSD: src/usr.bin/chpass/chpass.1,v 1.23.2.8 2002/06/20 23:45:22 charnier Exp $
move the description and say that the commands behave identically.

--- /tmp/chpass..orig.1	Sun Oct  6 20:25:55 2002
+++ /tmp/chpass.1	Sun Oct  6 21:30:39 2002
@@ -63,11 +63,23 @@
 .Sh DESCRIPTION
 The
 .Nm
-program
+command
 allows editing of the user database information associated
 with
 .Ar user
 or, by default, the current user.
+.Pp
+The
+.Xr chfn 1 ,
+.Xr chsh 1 ,
+.Xr ypchpass 1 ,
+.Xr ypchfn 1
+and
+.Xr ypchsh 1
+commands behave identically to
+.Nm .
+.Pq There is only one program.
+.Pp
 The information is formatted and supplied to an editor for changes.
 .Pp
 Only the information that the user is allowed to change is displayed.
@@ -469,16 +481,6 @@
 .%A Ken Thompson
 .%T "UNIX Password security"
 .Re
-.Sh NOTES
-The
-.Xr chfn 1 ,
-.Xr chsh 1 ,
-.Xr ypchpass 1 ,
-.Xr ypchfn 1
-and
-.Xr ypchsh 1
-commands are really only links to
-.Nm .
 .Sh BUGS
 User information should (and eventually will) be stored elsewhere.
 .Sh HISTORY
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Thu Dec 19 17:17:34 PST 2002 
State-Changed-Why:  
Patched in current and I'll MFC soon.  Thanks for the submission! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Thu Dec 19 17:17:34 PST 2002 
Responsible-Changed-Why:  
Patched in current and I'll MFC soon.  Thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=43756 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Fri Dec 20 10:22:18 PST 2002 
State-Changed-Why:  
MFC Complete!  Thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=43756 
>Unformatted:
