From swear@attbi.com  Wed Jan 15 10:07:47 2003
Return-Path: <swear@attbi.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 95EBE37B401
	for <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; Wed, 15 Jan 2003 10:07:47 -0800 (PST)
	(envelope-from swear@attbi.com)
Received: from localhost.localdomain (<unknown.domain>[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 <FreeBSD-gnats-submit@freebsd.org>; 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: <gau1gathhm.1ga@localhost.localdomain>
Date: 15 Jan 2003 10:06:45 -0800
From: "Gary W. Swearingen" <swear@attbi.com>
Reply-To: swear@attbi.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: chmod(1) manpage is wrong about -vv behavior.
X-GNATS-Notify:

>Number:         47114
>Category:       docs
>Synopsis:       chmod(1) manpage is wrong about -vv behavior.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 15 10:10:08 PST 2003
>Closed-Date:    Thu Jan 23 18:58:05 PST 2003
>Last-Modified:  Thu Jan 23 18:58:05 PST 2003
>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:

From: Giorgos Keramidas <keramida@freebsd.org>
To: "Gary W. Swearingen" <swear@attbi.com>
Cc: bug-followup@freebsd.org
Subject: Re: docs/47114: chmod(1) manpage is wrong about -vv behavior.
Date: Thu, 16 Jan 2003 03:31:53 +0200

 On 2003-01-15 10:06, swear@attbi.com (Gary W. Swearingen) wrote:
 > 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".)
 
 Good catch!  But you are obviously talking about chmod.c in the
 4-STABLE branch.  If you look at the source code of chmod.c in
 5.0-CURRENT you will see the special behavior is there.
 
 > Patch this:
 > .\" $FreeBSD: src/bin/chmod/chmod.1,v 1.17.2.12 2002/09/18 23:40:35 trhodes Exp $
 
 I think that the manpage is a result of an MFC (version 1.17.2.10 was
 the one that introduced the changes to chmod.1) which failed to update
 the source code too.  IMHO, the best thing to do would be to keep the
 manpage as it is now and merge the chmod.c stuff too.
 
 What do you think?
 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Thu Jan 23 18:56:34 PST 2003 
State-Changed-Why:  
Change 1.17.2.14, that I committed a short while ago, fixed this 
for RELENG_4.  Thanks for reporting this and helping me find out 
why the manpage was wrong. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Thu Jan 23 18:56:34 PST 2003 
Responsible-Changed-Why:  

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