docs/161588: Missing "-l name" option from pw(8) USER section

[Luchesar V. ILIEV]

>Number:         161588
>Category:       docs
>Synopsis:       Missing "-l name" option from pw(8) USER section
>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:   Fri Oct 14 15:40:03 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Luchesar V. ILIEV
>Release:        stable/8, stable/9, head
>Organization:
i.dea.is
>Environment:
Irrelevant.
>Description:
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.
>How-To-Repeat:
% man 8 pw
>Fix:
A basic patch for usr.sbin/pw/pw.8 is attached.

Patch attached with submission follows:

--- pw.8.orig	2011-09-29 22:07:38.644980000 +0300
+++ pw.8	2011-10-14 01:06:09.154416254 +0300
@@ -714,6 +714,17 @@
 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


>Release-Note:
>Audit-Trail:
>Unformatted: