xref: /freebsd/usr.bin/banner/banner.6 (revision 1b659bfe0b98cd0667db5aaadacea323544a42e0)
1630d2a93SBruce Evans.\" Copyright (c) 1980, 1993, 1995
2630d2a93SBruce Evans.\"	The Regents of the University of California.  All rights reserved.
3630d2a93SBruce Evans.\"
4630d2a93SBruce Evans.\" Redistribution and use in source and binary forms, with or without
5630d2a93SBruce Evans.\" modification, are permitted provided that the following conditions
6630d2a93SBruce Evans.\" are met:
7630d2a93SBruce Evans.\" 1. Redistributions of source code must retain the above copyright
8630d2a93SBruce Evans.\"    notice, this list of conditions and the following disclaimer.
9630d2a93SBruce Evans.\" 2. Redistributions in binary form must reproduce the above copyright
10630d2a93SBruce Evans.\"    notice, this list of conditions and the following disclaimer in the
11630d2a93SBruce Evans.\"    documentation and/or other materials provided with the distribution.
12630d2a93SBruce Evans.\" 3. All advertising materials mentioning features or use of this software
13630d2a93SBruce Evans.\"    must display the following acknowledgement:
14630d2a93SBruce Evans.\"	This product includes software developed by the University of
15630d2a93SBruce Evans.\"	California, Berkeley and its contributors.
16630d2a93SBruce Evans.\" 4. Neither the name of the University nor the names of its contributors
17630d2a93SBruce Evans.\"    may be used to endorse or promote products derived from this software
18630d2a93SBruce Evans.\"    without specific prior written permission.
19630d2a93SBruce Evans.\"
20630d2a93SBruce Evans.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21630d2a93SBruce Evans.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22630d2a93SBruce Evans.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23630d2a93SBruce Evans.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24630d2a93SBruce Evans.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25630d2a93SBruce Evans.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26630d2a93SBruce Evans.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27630d2a93SBruce Evans.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28630d2a93SBruce Evans.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29630d2a93SBruce Evans.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30630d2a93SBruce Evans.\" SUCH DAMAGE.
31630d2a93SBruce Evans.\"
321b659bfeSJoerg Wunsch.\"	From: @(#)banner.6	8.2 (Berkeley) 4/29/95
331b659bfeSJoerg Wunsch.\"	$Id$
34630d2a93SBruce Evans.\"
351b659bfeSJoerg Wunsch.Dd April 29, 1995
36630d2a93SBruce Evans.Dt BANNER 6
37630d2a93SBruce Evans.Os
38630d2a93SBruce Evans.Sh NAME
39630d2a93SBruce Evans.Nm banner
40630d2a93SBruce Evans.Nd print large banner on printer
41630d2a93SBruce Evans.Sh SYNOPSIS
42630d2a93SBruce Evans.Nm banner
43630d2a93SBruce Evans.Op Fl w Ar n
44630d2a93SBruce Evans.Ar message ...
45630d2a93SBruce Evans.Sh DESCRIPTION
46630d2a93SBruce Evans.Nm Banner
47630d2a93SBruce Evansprints a large, high quality banner on the standard output.
48630d2a93SBruce EvansIf the message is omitted, it prompts for and reads one line of its
49630d2a93SBruce Evansstandard input.
50630d2a93SBruce EvansIf
51630d2a93SBruce Evans.Fl w
52630d2a93SBruce Evansis given, the output is changed from a width of 132 to
53630d2a93SBruce Evans.Ar n ,
54630d2a93SBruce Evanssuitable for a narrow terminal.
55630d2a93SBruce Evans.Pp
56630d2a93SBruce EvansThe output should be printed on paper of the appropriate width,
57630d2a93SBruce Evanswith no breaks between the pages.
58630d2a93SBruce Evans.Sh BUGS
59630d2a93SBruce EvansSeveral ASCII characters are not defined, notably <, >, [, ], \\,
60630d2a93SBruce Evans^, _, {, }, |, and ~.
61630d2a93SBruce EvansAlso, the characters ", ', and & are funny looking (but in a useful way.)
62630d2a93SBruce Evans.Pp
63630d2a93SBruce EvansThe
64630d2a93SBruce Evans.Fl w
65630d2a93SBruce Evansoption is implemented by skipping some rows and columns.
66630d2a93SBruce EvansThe smaller it gets, the grainier the output.
67630d2a93SBruce EvansSometimes it runs letters together.
68630d2a93SBruce Evans.Sh AUTHOR
69630d2a93SBruce EvansMark Horton
70