diff options
author | wiz <wiz@NetBSD.org> | 2012-02-26 21:06:59 +0000 |
---|---|---|
committer | wiz <wiz@NetBSD.org> | 2012-02-26 21:06:59 +0000 |
commit | bcbc46f191b73fe1b817d448571b248466e49272 (patch) | |
tree | 3ab28e8a854342488529d159742facb8e645a2c7 /banner/banner.6 | |
parent | 6d80e805c700c9ffb05d5280da76c91ba0f2d039 (diff) | |
download | bsdgames-darwin-bcbc46f191b73fe1b817d448571b248466e49272.tar.gz bsdgames-darwin-bcbc46f191b73fe1b817d448571b248466e49272.tar.zst bsdgames-darwin-bcbc46f191b73fe1b817d448571b248466e49272.zip |
Man page and usage cleanups from Bug Hunting in PR 46103.
Diffstat (limited to 'banner/banner.6')
-rw-r--r-- | banner/banner.6 | 33 |
1 files changed, 22 insertions, 11 deletions
diff --git a/banner/banner.6 b/banner/banner.6 index 77ad5f01..a6e171ee 100644 --- a/banner/banner.6 +++ b/banner/banner.6 @@ -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 |