[src/trunk]: src/usr.bin/uuencode Document today's changes to uudecode:

[apb <apb%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/eea6edff53f2
branches:  trunk
changeset: 784445:eea6edff53f2
user:      apb <apb%NetBSD.org@localhost>
date:      Mon Jan 28 16:08:02 2013 +0000

description:
Document today's changes to uudecode:
* Add "-o outfile" option.  This is required by POSIX.1-2008.
* Recognise "/dev/stdout" as a magic filename, both when embedded in the
  data stream and when specified via "-o".  This is also required by
  POSIX.1-2008.

diffstat:

 usr.bin/uuencode/uuencode.1 |  40 +++++++++++++++++++++++++++++++++-------
 1 files changed, 33 insertions(+), 7 deletions(-)

diffs (84 lines):

diff -r 2f82e2e65a42 -r eea6edff53f2 usr.bin/uuencode/uuencode.1
--- a/usr.bin/uuencode/uuencode.1       Mon Jan 28 16:06:42 2013 +0000
+++ b/usr.bin/uuencode/uuencode.1       Mon Jan 28 16:08:02 2013 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: uuencode.1,v 1.21 2009/03/10 19:54:43 joerg Exp $
+.\"    $NetBSD: uuencode.1,v 1.22 2013/01/28 16:08:02 apb Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)uuencode.1 8.1 (Berkeley) 6/6/93
 .\"
-.Dd November 30, 2008
+.Dd January 28, 2012
 .Dt UUENCODE 1
 .Os
 .Sh NAME
@@ -42,7 +42,8 @@
 .Op Ar inputfile
 .Ar outputname
 .Nm uudecode
-.Op Fl m | Fl p
+.Op Fl m
+.Op Fl p | Fl o Ar outputfile
 .Op Ar encoded-file ...
 .Sh DESCRIPTION
 .Nm
@@ -57,6 +58,25 @@
 .Bl -tag -width ".Fl m"
 .It Fl m
 Use base64 encoding.
+The default is that
+.Nm
+uses the historical uuencode algorithm,
+and
+.Nm uudecode
+automatically detects the encoding.
+.It Fl o Ar outputname
+.Po Nm uudecode No only . Pc
+Use the specified
+.Ar outputname
+as the name of the output file.
+The default is that
+.Nm uudecode
+obtains the name of the output file from the data stream, where
+.Nm
+would have recorded it.
+.It Fl p
+.Po Nm uudecode No only . Pc
+Write the decoded file to stdout instead of to a named file.
 .El
 .Pp
 .Nm
@@ -79,11 +99,17 @@
 The resulting file is named
 .Ar outputname
 as recorded in the encoded file,
+or as specified by the
+.Fl o
+option,
 and will have the mode of the original file except that setuid
-and execute bits are not retained; if the
+and execute bits are not retained.
+If the
 .Fl p
-option is specified, the data will be written to the standard output
-instead.
+option is specified, or if the output file name is given as
+.Pa /dev/stdout ,
+then the data will be written to the standard output
+instead of to a named file.
 .Nm uudecode
 ignores any leading and trailing lines.
 .Sh EXIT STATUS
@@ -122,7 +148,7 @@
 and
 .Nm
 utilities conform to
-.St -p1003.2-92 .
+.St -p1003.1-2008 .
 .Sh HISTORY
 The
 .Nm uudecode