From bcbc46f191b73fe1b817d448571b248466e49272 Mon Sep 17 00:00:00 2001 From: wiz Date: Sun, 26 Feb 2012 21:06:59 +0000 Subject: Man page and usage cleanups from Bug Hunting in PR 46103. --- banner/banner.6 | 33 ++++++++++++++++++++++----------- 1 file changed, 22 insertions(+), 11 deletions(-) (limited to 'banner/banner.6') 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 -- cgit v1.2.3-56-ge451