Subject: misc/14959: description for kpasswd is inconsistent.
To: None <gnats-bugs@gnats.netbsd.org>
From: None <hiramatu@boreas.dti.ne.jp>
List: netbsd-bugs
Date: 12/16/2001 02:18:19
>Number:         14959
>Category:       misc
>Synopsis:       description for kpasswd is inconsistent.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Dec 15 09:20:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Hiramatsu Yoshifumi
>Release:        -current 'Sun Dec 16'
>Organization:
	
>Environment:
	<machine, os, target, libraries (multiple lines)>
System: NetBSD river.my.domain 1.5Z NetBSD 1.5Z (River) #0: Mon Dec 10 20:46:10 JST 2001     hiramatsu@river.my.domain:/usr/src/sys/arch/i386/compile/River i386
Architecture: i386
Machine: i386
>Description:
SYNOPSIS section of passwd.1 have these lines

     kpasswd [-4] [-k] [-i instance] [-r realm] [-u fullname] [user]
     kpasswd [-5] [-k] [-u fullname] [user]

but kpasswd.1 have only

     kpasswd [principal]

And when you try kpasswd

% kpasswd -5 -k
Usage: kpasswd [--version] [--help] [principal]

it doesn't support '-5' or '-k', shows different usage.

>How-To-Repeat:
	
>Fix:
These are patch for manuals, to explain kpasswd correctly.

--- usr.bin/passwd/passwd.1.orig       Sun Dec 16 01:38:14 2001
+++ usr.bin/passwd/passwd.1    Sun Dec 16 01:42:48 2001
@@ -60,18 +60,6 @@
 .Op Fl k
 .Op Fl u Ar fullname
 .Op Ar user
-.Nm kpasswd
-.Op Fl 4
-.Op Fl k
-.Op Fl i Ar instance
-.Op Fl r Ar realm
-.Op Fl u Ar fullname
-.Op Ar user
-.Nm kpasswd
-.Op Fl 5
-.Op Fl k
-.Op Fl u Ar fullname
-.Op Ar user
 .Nm yppasswd
 .Op Ar user
 .Sh DESCRIPTION


--- crypto/dist/heimdal/kpasswd/kpasswd.1.orig  Sun Dec 16 01:43:41 2001
+++ crypto/dist/heimdal/kpasswd/kpasswd.1       Sun Dec 16 02:01:46 2001
@@ -8,10 +8,24 @@
 .Nd Kerberos 5 password changing program
 .Sh SYNOPSIS
 .Nm
+.Op Fl -help
+.Op Fl -version
 .Op Ar principal
 .Sh DESCRIPTION
 .Nm
 is the client for changing passwords.
+.Pp
+The following options are available:
+.Bl -tag -width Ds
+.It Xo
+.Fl -help
+.Xc
+Display usage and quit.
+.It Xo
+.Fl -version
+.Xc
+Display the version number and copyright then quit.
+.El
 .Sh DIAGNOSTICS
 If the password quality check fails or some other error occurs, an
 explanation is printed.
>Release-Note:
>Audit-Trail:
>Unformatted: