Subject: bin/35409: bin/chmod(1) manpage update
To: None <gnats-admin@netbsd.org, netbsd-bugs@netbsd.org>
From: Andreas Wiese <aw-netbsd@instandbesetzt.net>
List: netbsd-bugs
Date: 01/11/2007 21:35:02
>Number:         35409
>Category:       bin
>Synopsis:       documenting undocumented chmod(1)-features
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Thu Jan 11 21:35:01 +0000 2007
>Originator:     Andreas Wiese
>Release:        NetBSD 4.99.8
>Organization:
	BSD-Crew Dresden
>Environment:
System: NetBSD schroeder.lan.instandbesetzt.net 4.99.8 NetBSD 4.99.8 (SCHROEDER) #0: Thu Jan 11 21:37:15 CET 2007 root@schroeder.lan.instandbesetzt.net:/usr/obj/sys/arch/i386/compile/SCHROEDER i386
Architecture: i386
Machine: i386
>Description:
Hey.

I spotted some »undocumented features« in chmod(1) and tried to
eliminate this deficit ;)
>How-To-Repeat:
n/a
>Fix:
diff -ur chmod.o/chmod.1 chmod/chmod.1
--- chmod.o/chmod.1	2007-01-09 22:45:56.000000000 +0100
+++ chmod/chmod.1	2007-01-09 22:46:45.000000000 +0100
@@ -73,6 +73,10 @@
 .It Fl R
 Change the modes of the file hierarchies rooted in the files
 instead of just the files themselves.
+.It Fl f
+Do not display a diagnostic message or modify the exit status to
+reflect errors happening during
+.Xr chmod 2 .
 .It Fl h
 If
 .Ar file
diff -ur chmod.o/chmod.c chmod/chmod.c
--- chmod.o/chmod.c	2007-01-09 22:45:56.000000000 +0100
+++ chmod/chmod.c	2007-01-09 22:48:01.000000000 +0100
@@ -91,7 +91,7 @@
 		case 'R':
 			Rflag = 1;
 			break;
-		case 'f':		/* XXX: undocumented. */
+		case 'f':
 			fflag = 1;
 			break;
 		case 'h':
@@ -207,7 +207,7 @@
 usage(void)
 {
 	(void)fprintf(stderr,
-	    "usage: %s [-R [-H | -L | -P]] [-h] mode file ...\n",
+	    "usage: %s [-R [-H | -L | -P]] [-fh] mode file ...\n",
 	    getprogname());
 	exit(1);
 	/* NOTREACHED */

HAND & LG -- aw
np: Kaizers Orchestra (Ompa til du dør) -- 05. Rullett
-- 
Unnützes Wissen: 200 skurile Fakten, die du nie mehr vergißt (»neon«, 08/05):
 120. Die Mafia ist das größte Wirtschaftsunternehmen Italiens.  Laut
      einem der führenden Ermittler macht sie mittlerweile 100 Milliarden
      Euro Umsatz -- doppelt so viel wie Fiat.