NetBSD Problem Report #40071

From www@NetBSD.org  Sun Nov 30 18:46:15 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 6A1A863B8BD
	for <gnats-bugs@gnats.netbsd.org>; Sun, 30 Nov 2008 18:46:15 +0000 (UTC)
Message-Id: <20081130184615.2D47863B11D@narn.NetBSD.org>
Date: Sun, 30 Nov 2008 18:46:15 +0000 (UTC)
From: bughunting@xs4all.nl
Reply-To: bughunting@xs4all.nl
To: gnats-bugs@NetBSD.org
Subject: uuencode(1)/uudecode(1) manpage has an inaccurate `SEE ALSO' section
X-Send-Pr-Version: www-1.0

>Number:         40071
>Category:       misc
>Synopsis:       uuencode(1)/uudecode(1) manpage has an inaccurate `SEE ALSO' section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Nov 30 18:50:06 +0000 2008
>Closed-Date:    Tue Dec 02 08:25:56 +0000 2008
>Last-Modified:  Tue Dec 02 08:25:56 +0000 2008
>Originator:     Bug Hunting
>Release:        5.99.4
>Organization:
>Environment:
>Description:
As a fix to PR #40063, the uuencode(1)/uudecode(1) manpage was changed.
Usage of compress(1) in the example in the `EXAMPLES' section was
replaced by usage of tar(1), but the `SEE ALSO' section wasn't updated
along with this change. Also, the reference to uucp(1) in the `SEE ALSO'
section should be removed since the example now uses an SMTP e-mail
address instead of an UUCP address (plus, uucp(1) was removed from
NetBSD with the release 4.0 anyway; see
http://www.NetBSD.org/releases/formal-4/NetBSD-4.0.html).

Optionally, gzip(1) might be put into the `SEE ALSO' section, since
tar(1)'s `-z' parameter is used in the example.
>How-To-Repeat:
"man 1 uuencode" (or "man 1 uudecode");
look up the `EXAMPLES' and `SEE ALSO' sections.
>Fix:
(Proposed) patch:

$ diff -u usr.bin/uuencode/uuencode.1 usr.bin/uuencode/uuencode.1.new
--- usr.bin/uuencode/uuencode.1 2008-11-30 18:44:04.000000000 +0100
+++ usr.bin/uuencode/uuencode.1.new     2008-11-30 18:48:52.000000000 +0100
@@ -111,9 +111,9 @@
 tar xzf src_tree.tgz
 .Ed
 .Sh SEE ALSO
-.Xr compress 1 ,
+.Xr gzip 1 ,
 .Xr mail 1 ,
-.Xr uucp 1 ,
+.Xr tar 1 ,
 .Xr uuencode 5
 .Sh STANDARDS
 The

>Release-Note:

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

 Module Name:	src
 Committed By:	dholland
 Date:		Sun Nov 30 23:22:46 UTC 2008

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

 Log Message:
 Update SEE ALSO per PR 40071: compress -> gzip, add missing tar, comment
 out uucp because uucp was removed from base. (Though maybe it should be
 left in anyway - it belongs as a crossreference for historical reasons.)

 It doesn't seem to me that every tool used in an example must
 necessarily appear in SEE ALSO, but it doesn't particularly hurt.


 To generate a diff of this commit:
 cvs rdiff -r1.18 -r1.19 src/usr.bin/uuencode/uuencode.1

 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: Mon, 01 Dec 2008 05:27:50 +0000
State-Changed-Why:
pullup-5 #155


From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/40071 CVS commit: [netbsd-5] src/usr.bin/uuencode
Date: Tue,  2 Dec 2008 01:22:44 +0000 (UTC)

 Module Name:	src
 Committed By:	snj
 Date:		Tue Dec  2 01:22:44 UTC 2008

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

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #155):
 	usr.bin/uuencode/uuencode.1: revision 1.19
 Update SEE ALSO per PR 40071: compress -> gzip, add missing tar, comment
 out uucp because uucp was removed from base. (Though maybe it should be
 left in anyway - it belongs as a crossreference for historical reasons.)
 It doesn't seem to me that every tool used in an example must
 necessarily appear in SEE ALSO, but it doesn't particularly hurt.


 To generate a diff of this commit:
 cvs rdiff -r1.16.24.2 -r1.16.24.3 src/usr.bin/uuencode/uuencode.1

 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: Tue, 02 Dec 2008 08:25:56 +0000
State-Changed-Why:
fixed.


>Unformatted:

Home	PR Database Search