xref: /netbsd-src/usr.bin/banner/banner.1 (revision 219fc162e3fc8b3b1aa2aacc1018da8878fde626)
1.\"	$NetBSD: banner.1,v 1.10 2020/04/07 17:57:33 sevan Exp $
2.\"
3.\"	@(#)Copyright (c) 1995, Simon J. Gerraty.
4.\"
5.\"	This is free software.	It comes with NO WARRANTY.
6.\"	Permission to use, modify and distribute this source code
7.\"	is granted subject to the following conditions.
8.\"	1/ that the above copyright notice and this notice
9.\"	are preserved in all copies and that due credit be given
10.\"	to the author.
11.\"	2/ that any changes to this code are clearly commented
12.\"	as such so that the author does not get blamed for bugs
13.\"	other than his own.
14.\"
15.\"	Please send copies of changes and bug-fixes to:
16.\"	sjg@zen.void.oz.au
17.\"
18.Dd April 7, 2020
19.Dt BANNER 1
20.Os
21.Sh NAME
22.Nm banner
23.Nd print strings in large letters
24.Sh SYNOPSIS
25.Nm
26.Op Fl l
27.Op Fl b Ar bg
28.Op Fl f Ar fg
29.Ar string ...
30.Sh DESCRIPTION
31.Nm
32prints up to 10 chars of each
33.Ar string
34in large letters on the standard output.
35.Pp
36The options are:
37.Bl -tag -width Ds
38.It Fl b Ar bg
39Use
40.Ar bg
41as the background color (character) rather than the default
42.Dq \  .
43.It Fl f Ar fg
44Use
45.Ar fg
46as the foreground color (character) rather than the default
47.Dq # .
48If
49.Ar fg
50is
51.Dq - ,
52then the actual letter being printed is used as the
53foreground color in the same way that LPD does it.
54The results are quite variable.
55.It Fl l
56Use the more attractive LPD font instead of the traditional
57.Nm
58font.
59.El
60.Sh EXIT STATUS
61.Ex -std
62.Sh SEE ALSO
63.Xr banner 6
64.Sh HISTORY
65The
66.Nm
67utility first appeared in
68.Nx 1.2 .
69