Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 14 Oct 2011 01:36:20 +0300
From:      "Luchesar V. ILIEV" <luchesar.iliev@gmail.com>
To:        freebsd-doc@freebsd.org
Subject:   Missing "-l" option from pw(8) USER section
Message-ID:  <4E9767E4.8070000@gmail.com>

next in thread | raw e-mail | index | archive | help

[-- Attachment #1 --]
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Hi everyone,

Apologies if that has been discussed before; the search didn't yield
anything useful, but I might have missed something.

I noticed today that the "-l" option is missing from pw.8 man page, at
least in HEAD, stable/9 and stable/8. The option is mentioned in the
SYNOPSIS, but there's no information about it in the USER OPTIONS
section, unlike the respective option in GROUP OPTIONS.

I went briefly through both pw.8's and pw.c's history, but could not
find any clues. The option itself is working as expected, and pw.c's
short help also mentions it, so I assume it somehow got overlooked,
rather than being intentionally omitted.

If that's indeed the case, I'm attaching a dirty patch, but please
bear in mind that I've never worked with roff documents before, so
don't get too mad at me if it's not quite all right (it seemed to
produce a fine output in man(1), at least).

Cheers,
Luchesar

P.S. I inserted the information between the userdel and usershow
notes, because that seems to be the order in SYNOPSIS. The text itself
is shamelessly stolen from the GROUP OPTIONS section; it's pretty
brief, but probably enough. I guess the whole page might benefit from
some examples, but that's obviously a separate topic for discussion.

- -- 
i.dea.is/luchesar

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.18 (FreeBSD)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBCAAGBQJOl2fZAAoJENvaS4iaH+7/KzAH/0inWSmTUFLWByowXPMBXjaC
QgRUU7ePow8w/YbQE5nJzxFMNHitk91qp1X5AVFsLS07MaHMMgXU52GUwMCtG/jI
dnN5ew1EaRMb0WfR+xKBr4x6wmUD3VfbZzhYBiJcc6MQCPjHl42sVeOGFB42BYS9
gl5i5gKTXYnIgg8O2Kh+gpH5IJDG7QvrqkCaEr5ENhQryTn7I9m8qiOKOGmXGZkd
DkEu+A2EODTHR1a0sLTTcvpa9hLJCZxY4S+HaffJ3P27ye7R2LxGUFr4ojpofJwO
RGHhxXZCxGWzJNVx0M+N96ioGzHiGszt3+EEw1auz5PkAtCrDpLEoRdwzheUKEk=
=444I
-----END PGP SIGNATURE-----

[-- Attachment #2 --]
--- 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

[-- Attachment #3 --]
Ng
	K ,?ǭD'n-	~qY:27fxUv"X7iCk(!׋}la޽t1Qt7xꘃs%K	+!bgroTG7܀59YF`p⁂5xKoVIooE DZVC;EB6AK@$эN8HaA~T~,ΆǏ@.*[	

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4E9767E4.8070000>