From owner-freebsd-doc Wed Jan 15 10:10:14 2003 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 37CEA37B405 for ; Wed, 15 Jan 2003 10:10:11 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D74BC43F3F for ; Wed, 15 Jan 2003 10:10:08 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id h0FIA8NS069347 for ; Wed, 15 Jan 2003 10:10:08 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id h0FIA8SQ069346; Wed, 15 Jan 2003 10:10:08 -0800 (PST) Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 95EBE37B401 for ; Wed, 15 Jan 2003 10:07:47 -0800 (PST) Received: from rwcrmhc52.attbi.com (rwcrmhc52.attbi.com [216.148.227.88]) by mx1.FreeBSD.org (Postfix) with ESMTP id 13A0C43EB2 for ; Wed, 15 Jan 2003 10:07:47 -0800 (PST) (envelope-from swear@attbi.com) Received: from localhost.localdomain ([12.242.158.67]) by rwcrmhc52.attbi.com (rwcrmhc52) with ESMTP id <20030115180746052008tesde>; Wed, 15 Jan 2003 18:07:46 +0000 Received: from localhost.localdomain (localhost [127.0.0.1]) by localhost.localdomain (8.12.6/8.12.5) with ESMTP id h0FI6om9084313 for ; Wed, 15 Jan 2003 10:06:50 -0800 (PST) (envelope-from swear@attbi.com) Received: (from jojo@localhost) by localhost.localdomain (8.12.6/8.12.5/Submit) id h0FI6jtS084310; Wed, 15 Jan 2003 10:06:45 -0800 (PST) (envelope-from swear@attbi.com) Message-Id: Date: 15 Jan 2003 10:06:45 -0800 From: "Gary W. Swearingen" Reply-To: swear@attbi.com To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/47114: chmod(1) manpage is wrong about -vv behavior. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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