xref: /freebsd/usr.bin/banner/banner.6 (revision eb257e6ec546a962b89bb2740a1760a7ec064040)
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
33c3aac50fSPeter Wemm.\" $FreeBSD$
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
43eb257e6eSPhilippe Charnier.Op Fl d
44eb257e6eSPhilippe Charnier.Op Fl t
45eb257e6eSPhilippe Charnier.Op Fl w Ar width
46630d2a93SBruce Evans.Ar message ...
47630d2a93SBruce Evans.Sh DESCRIPTION
48630d2a93SBruce Evans.Nm Banner
49630d2a93SBruce Evansprints a large, high quality banner on the standard output.
50630d2a93SBruce EvansIf the message is omitted, it prompts for and reads one line of its
51630d2a93SBruce Evansstandard input.
52630d2a93SBruce Evans.Pp
53630d2a93SBruce EvansThe output should be printed on paper of the appropriate width,
54630d2a93SBruce Evanswith no breaks between the pages.
55eb257e6eSPhilippe Charnier.Pp
56eb257e6eSPhilippe CharnierThe following options are available:
57eb257e6eSPhilippe Charnier.Bl -tag -width indent
58eb257e6eSPhilippe Charnier.It Fl d
59eb257e6eSPhilippe CharnierEnable debug.
60eb257e6eSPhilippe Charnier.It Fl t
61eb257e6eSPhilippe CharnierEnable trace.
62eb257e6eSPhilippe Charnier.It Fl w Ar width
63eb257e6eSPhilippe CharnierChange the output from a width of 132 to
64eb257e6eSPhilippe Charnier.Ar width ,
65eb257e6eSPhilippe Charniersuitable for a narrow terminal.
66eb257e6eSPhilippe Charnier.El
67630d2a93SBruce Evans.Sh BUGS
68eb257e6eSPhilippe CharnierSeveral
69eb257e6eSPhilippe Charnier.Tn ASCII
70eb257e6eSPhilippe Charniercharacters are not defined, notably <, >, [, ], \\,
71630d2a93SBruce Evans^, _, {, }, |, and ~.
72630d2a93SBruce EvansAlso, the characters ", ', and & are funny looking (but in a useful way.)
73630d2a93SBruce Evans.Pp
74630d2a93SBruce EvansThe
75630d2a93SBruce Evans.Fl w
76630d2a93SBruce Evansoption is implemented by skipping some rows and columns.
77630d2a93SBruce EvansThe smaller it gets, the grainier the output.
78630d2a93SBruce EvansSometimes it runs letters together.
79306005e7SPhilippe Charnier.Sh AUTHORS
80306005e7SPhilippe Charnier.An Mark Horton
81