Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Man page and usage cleanups from Bug Hunting in PR 46103.

Browse Source
This commit is contained in:
wiz 2012-02-26 21:06:59 +00:00
parent 6e31cc7bbd
commit a19484822f
2 changed files with 26 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
games/banner/banner.6
View File

@ -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

8
games/banner/banner.c
View File

@ -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, 1993, 1994\
#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;