From owner-freebsd-doc Sun Oct 6 21:40: 6 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C3D8737B404 for ; Sun, 6 Oct 2002 21:40:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id F0DB743E6A for ; Sun, 6 Oct 2002 21:40:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id g974e2Co023939 for ; Sun, 6 Oct 2002 21:40:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id g974e2K3023938; Sun, 6 Oct 2002 21:40:02 -0700 (PDT) Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B34FF37B401 for ; 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 ; 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 ; 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 ; 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: Date: 06 Oct 2002 21:41:02 -0700 From: "Gary W. Swearingen" Reply-To: swear@attbi.com To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/43756: chpass(1) manual unclear about alternate name behavior Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 43756 >Category: docs >Synopsis: chpass(1) manual unclear about alternate name behavior >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Oct 06 21:40:02 PDT 2002 >Closed-Date: >Last-Modified: >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: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message