Date: 15 Jan 2003 10:06:45 -0800 From: "Gary W. Swearingen" <swear@attbi.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/47114: chmod(1) manpage is wrong about -vv behavior. Message-ID: <gau1gathhm.1ga@localhost.localdomain>
next in thread | raw e-mail | index | archive | help
>Number: 47114 >Category: docs >Synopsis: chmod(1) manpage is wrong about -vv behavior. >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: Wed Jan 15 10:10:08 PST 2003 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.7-STABLE i386 >Organization: none >Environment: n/a ================ >Description: The chmod(1) manpage's -v description says that the option can be used more than once for some special behavior, while the program doesn't care how many times you use it. (Confirmed by looking at "/usr/src/bin/chmod/chmod.c".) The -v description says the verbosity occurs "as the mode is modified", which is easily mis-interpreted to mean "as the mode is set" or "as the command processes the file". ================ >How-To-Repeat: n/a ================ >Fix: 1) Remove the offending sentence. 2) Make the verbosity switch description more verbose. Patch this: .\" $FreeBSD: src/bin/chmod/chmod.1,v 1.17.2.12 2002/09/18 23:40:35 trhodes Exp $ with this: --- /pr/work/chmod..orig.1 Tue Jan 14 15:55:43 2003 +++ /pr/work/chmod.1 Tue Jan 14 16:12:24 2003 @@ -89,11 +89,8 @@ .It Fl v Cause .Nm -to be verbose, showing filenames as the mode is modified. -If the -.Fl v -flag is specified more than once, the old and new modes of the file -will also be printed, in both octal and symbolic notation. +to be verbose, which means that filenames +are output (to stdout) if the mode changes. .El .Pp The >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?gau1gathhm.1ga>