Bug 161588

Summary: Missing "-l name" option from pw(8) USER section
Product: Documentation Reporter: Luchesar V. ILIEV <luchesar.iliev>
Component: Books & ArticlesAssignee: Eitan Adler <eadler>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Luchesar V. ILIEV 2011-10-14 16:40:03 UTC 
The "-l name" option to "pw usermod" is mentioned in the SYNOPSIS section of usr.sbin/pw/pw.8 man page, but there's no detailed information about it in the USER OPTIONS section -- unlike the respective option to "pw groupmod", which is documented in GROUP OPTIONS. The option itself is working as expected, and usr.sbin/pw/pw.c's short help also lists it.

Fix: A basic patch for usr.sbin/pw/pw.8 is attached.

Patch attached with submission follows:
How-To-Repeat: % man 8 pw
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2011-12-22 03:01:46 UTC 
Responsible Changed
From-To: freebsd-doc->eadler

I'll take it - keep in mind .Dd has to be changed too
Comment 2 dfilter service freebsd_committer freebsd_triage 2011-12-22 03:37:03 UTC 
Author: eadler (ports committer)
Date: Thu Dec 22 03:36:54 2011
New Revision: 228795
URL: http://svn.freebsd.org/changeset/base/228795

Log:
  - document the -l option to usermod
  
  PR:		docs/161588
  Submitted by:	"Luchesar V. ILIEV" <luchesar.iliev@gmail.com>
  Approved by:	gjb
  MFC after:	1 week

Modified:
  head/usr.sbin/pw/pw.8

Modified: head/usr.sbin/pw/pw.8
==============================================================================
--- head/usr.sbin/pw/pw.8	Wed Dec 21 22:49:16 2011	(r228794)
+++ head/usr.sbin/pw/pw.8	Thu Dec 22 03:36:54 2011	(r228795)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 30, 2007
+.Dd December 21, 2011
 .Dt PW 8
 .Os
 .Sh NAME
@@ -714,6 +714,17 @@ are also removed if the user's uid is un
 system.
 .Pp
 The
+.Ar usermod
+command adds one additional option:
+.Bl -tag -width "-G grouplist"
+.It Fl l Ar name
+This option allows changing of an existing account name to
+.Ql \&name .
+The new name must not already exist, and any attempt to duplicate an
+existing account name will be rejected.
+.El
+.Pp
+The
 .Ar usershow
 command allows viewing of an account in one of two formats.
 By default, the format is identical to the format used in
_______________________________________________
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"
Comment 3 Eitan Adler freebsd_committer freebsd_triage 2011-12-22 03:38:27 UTC 
State Changed
From-To: open->patched

committed in r228795
Comment 4 Eitan Adler freebsd_committer freebsd_triage 2012-01-07 04:09:59 UTC 
State Changed
From-To: patched->closed

committed to 9