From nobody@FreeBSD.org  Fri Oct 14 15:36:56 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 51E6A106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 14 Oct 2011 15:36:56 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 414168FC13
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 14 Oct 2011 15:36:56 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p9EFatZa032611
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 14 Oct 2011 15:36:55 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p9EFatHd032610;
	Fri, 14 Oct 2011 15:36:55 GMT
	(envelope-from nobody)
Message-Id: <201110141536.p9EFatHd032610@red.freebsd.org>
Date: Fri, 14 Oct 2011 15:36:55 GMT
From: "Luchesar V. ILIEV" <luchesar.iliev@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Missing "-l name" option from pw(8) USER section
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         161588
>Category:       docs
>Synopsis:       Missing "-l name" option from pw(8) USER section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Oct 14 15:40:03 UTC 2011
>Closed-Date:    Sat Jan 07 04:10:00 UTC 2012
>Last-Modified:  Sat Jan 07 04:10:00 UTC 2012
>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:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Thu Dec 22 03:01:46 UTC 2011 
Responsible-Changed-Why:  
I'll take it - keep in mind .Dd has to be changed too 

http://www.freebsd.org/cgi/query-pr.cgi?pr=161588 
State-Changed-From-To: open->patched 
State-Changed-By: eadler 
State-Changed-When: Thu Dec 22 03:38:27 UTC 2011 
State-Changed-Why:  
committed in r228795 

http://www.freebsd.org/cgi/query-pr.cgi?pr=161588 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/161588: commit references a PR
Date: Thu, 22 Dec 2011 03:37:03 +0000 (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"
 
State-Changed-From-To: patched->closed 
State-Changed-By: eadler 
State-Changed-When: Sat Jan 7 04:09:59 UTC 2012 
State-Changed-Why:  
committed to 9 

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