NetBSD Problem Report #40063

From www@NetBSD.org  Sat Nov 29 02:15:04 2008
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id 0688C63B8BD
	for <gnats-bugs@gnats.netbsd.org>; Sat, 29 Nov 2008 02:15:04 +0000 (UTC)
Message-Id: <20081129021503.A494F63B11D@narn.NetBSD.org>
Date: Sat, 29 Nov 2008 02:15:03 +0000 (UTC)
From: bughunting@xs4all.nl
Reply-To: bughunting@xs4all.nl
To: gnats-bugs@NetBSD.org
Subject: `usage'-line of uuencode(1) and the `SYNOPSIS' line of its manpage differ
X-Send-Pr-Version: www-1.0

>Number:         40063
>Category:       misc
>Synopsis:       `usage'-line of uuencode(1) and the `SYNOPSIS' line of its manpage differ
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Nov 29 02:20:00 +0000 2008
>Closed-Date:    Sun Nov 30 04:16:48 +0000 2008
>Last-Modified:  Sun Nov 30 04:16:48 +0000 2008
>Originator:     Bug Hunting
>Release:        5.99.3
>Organization:
>Environment:
>Description:
The `usage'-line of uuencode(1) does not match the `SYNOPSIS'
line of its manpage.

The naming of the manpage should probably be kept, since there
isn't really a `remotefile', as the `usage'-line calls it.
>How-To-Repeat:
$ uuencode    
usage: uuencode [-m] [infile] remotefile
$ man -h 1 uuencode|head -n1
uuencode [-m] [file] name
>Fix:
Apply the following (proposed) patch:

$ diff -u /usr/src/usr.bin/uuencode/uuencode.c uuencode.c.new
--- /usr/src/usr.bin/uuencode/uuencode.c        2008-07-21 16:19:27.000000000 +0200
+++ uuencode.c.new      2008-11-29 02:54:04.000000000 +0100
@@ -196,7 +196,7 @@
 static void
 usage(void)
 {
-       (void)fprintf(stderr, "usage: %s [-m] [infile] remotefile\n",
+       (void)fprintf(stderr, "usage: %s [-m] [file] name\n",
                      getprogname());
        exit(1);
 }

>Release-Note:

>Audit-Trail:
From: "David A. Holland" <dholland@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/40063 CVS commit: src/usr.bin/uuencode
Date: Sat, 29 Nov 2008 22:36:13 +0000 (UTC)

 Module Name:	src
 Committed By:	dholland
 Date:		Sat Nov 29 22:36:13 UTC 2008

 Modified Files:
 	src/usr.bin/uuencode: uuencode.1 uuencode.c

 Log Message:
 Clarify man page with respect to input and output files, and sync usage
 message. Prompted by PR 40063 about the usage message.


 To generate a diff of this commit:
 cvs rdiff -r1.16 -r1.17 src/usr.bin/uuencode/uuencode.1
 cvs rdiff -r1.13 -r1.14 src/usr.bin/uuencode/uuencode.c

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: "David A. Holland" <dholland@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/40063 CVS commit: src/usr.bin/uudecode
Date: Sat, 29 Nov 2008 22:36:57 +0000 (UTC)

 Module Name:	src
 Committed By:	dholland
 Date:		Sat Nov 29 22:36:57 UTC 2008

 Modified Files:
 	src/usr.bin/uudecode: uudecode.c

 Log Message:
 Sync usage message with man page. PR 40063.


 To generate a diff of this commit:
 cvs rdiff -r1.23 -r1.24 src/usr.bin/uudecode/uudecode.c

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->pending-pullups
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Sat, 29 Nov 2008 22:49:46 +0000
State-Changed-Why:
pullup-5 #149.


From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/40063 CVS commit: [netbsd-5] src/usr.bin/uuencode
Date: Sat, 29 Nov 2008 23:14:56 +0000 (UTC)

 Module Name:	src
 Committed By:	snj
 Date:		Sat Nov 29 23:14:56 UTC 2008

 Modified Files:
 	src/usr.bin/uuencode [netbsd-5]: uuencode.1 uuencode.c

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #149):
 	usr.bin/uuencode/uuencode.c: revision 1.14
 	usr.bin/uuencode/uuencode.1: revision 1.17
 Clarify man page with respect to input and output files, and sync usage
 message. Prompted by PR 40063 about the usage message.


 To generate a diff of this commit:
 cvs rdiff -r1.16 -r1.16.24.1 src/usr.bin/uuencode/uuencode.1
 cvs rdiff -r1.13 -r1.13.4.1 src/usr.bin/uuencode/uuencode.c

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/40063 CVS commit: [netbsd-5] src/usr.bin/uudecode
Date: Sat, 29 Nov 2008 23:15:49 +0000 (UTC)

 Module Name:	src
 Committed By:	snj
 Date:		Sat Nov 29 23:15:49 UTC 2008

 Modified Files:
 	src/usr.bin/uudecode [netbsd-5]: uudecode.c

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #194):
 	usr.bin/uudecode/uudecode.c: revision 1.24
 Sync usage message with man page. PR 40063.


 To generate a diff of this commit:
 cvs rdiff -r1.23 -r1.23.4.1 src/usr.bin/uudecode/uudecode.c

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: pending-pullups->closed
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Sun, 30 Nov 2008 04:16:48 +0000
State-Changed-Why:
Fixed, thanks.
I changed it to say "inputfile" and "remotename", because, while it isn't
a file as such, it *is* remote, since uuencode is normally used for transfers.
I also clarified the man page a bit.


>Unformatted:

Home	PR Database Search