Module Name: src
Committed By: wiz
Date: Sun Feb 26 21:06:59 UTC 2012
Modified Files:
src/games/banner: banner.6 banner.c
Log Message:
Man page and usage cleanups from Bug Hunting in PR 46103.
To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/games/banner/banner.6
cvs rdiff -u -r1.19 -r1.20 src/games/banner/banner.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/games/banner/banner.6
diff -u src/games/banner/banner.6:1.17 src/games/banner/banner.6:1.18
--- src/games/banner/banner.6:1.17 Fri May 14 19:02:28 2010
+++ src/games/banner/banner.6 Sun Feb 26 21:06:59 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: banner.6,v 1.17 2010/05/14 19:02:28 joerg Exp $
+.\" $NetBSD: banner.6,v 1.18 2012/02/26 21:06:59 wiz Exp $
.\"
.\" Copyright (c) 1980, 1993, 1995
.\" The Regents of the University of California. All rights reserved.
@@ -29,32 +29,43 @@
.\"
.\" @(#)banner.6 8.2 (Berkeley) 4/29/95
.\"
-.Dd December 14, 2006
+.Dd February 26, 2012
.Dt BANNER 6
.Os
.Sh NAME
.Nm banner
-.Nd print large banner on printer
+.Nd print large banners
.Sh SYNOPSIS
.Nm
.Op Fl w Ar width
-.Ar message ...
+.Op Ar message
.Sh DESCRIPTION
.Nm
-prints a large, high quality banner on the standard output.
-If the message is omitted, it prompts for and
-reads one line of its standard input.
+prints a large, high quality banner on standard output.
+If
+.Ar message
+is omitted, one line of standard input is read for it.
+A prompt is written to standard error in case standard input is
+connected to a terminal.
+.Pp
If
.Fl w
-is given, the output is scrunched down from a width of 132 to
+is given, the output is scrunched down from a width of 132 (the default) to
.Ar width ,
suitable for a narrow terminal.
-For example:
-.Pp
-.Dl "/usr/games/banner -w 80 Hello"
.Pp
The output should be printed on paper of the appropriate width,
with no breaks between the pages.
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+The following command will print the current date as a banner on
+standard output, using a width of 80:
+.Pp
+.Dl "/usr/games/banner -w 80 `date`"
+.Sh SEE ALSO
+.Xr banner 1 ,
+.Xr lpr 1
.Sh AUTHORS
.An Mark Horton
.Sh BUGS
Index: src/games/banner/banner.c
diff -u src/games/banner/banner.c:1.19 src/games/banner/banner.c:1.20
--- src/games/banner/banner.c:1.19 Mon Aug 29 20:30:36 2011
+++ src/games/banner/banner.c Sun Feb 26 21:06:59 2012
@@ -1,4 +1,4 @@
-/* $NetBSD: banner.c,v 1.19 2011/08/29 20:30:36 joerg Exp $ */
+/* $NetBSD: banner.c,v 1.20 2012/02/26 21:06:59 wiz Exp $ */
/*
* Copyright (c) 1980, 1993, 1994
@@ -39,13 +39,13 @@ __COPYRIGHT("@(#) Copyright (c) 1980, 19
#if 0
static char sccsid[] = "@(#)banner.c 8.4 (Berkeley) 4/29/95";
#else
-__RCSID("$NetBSD: banner.c,v 1.19 2011/08/29 20:30:36 joerg Exp $");
+__RCSID("$NetBSD: banner.c,v 1.20 2012/02/26 21:06:59 wiz Exp $");
#endif
#endif /* not lint */
/*
* banner - prints large signs
- * banner [-w width] [-d] [-t] message ...
+ * banner [-dt] [-w width] [message]
*/
#include <err.h>
@@ -1051,7 +1051,7 @@ main(int argc, char *argv[])
break;
case '?':
default:
- (void)fprintf(stderr, "usage: banner [-w width]\n");
+ (void)fprintf(stderr, "usage: banner [-w width] [message]\n");
exit(1);
}
argc -= optind;
