NetBSD/usr.bin/banner/banner.1

.\"	$NetBSD: banner.1,v 1.9 2012/02/29 08:54:55 wiz Exp $
.\"
.\"	@(#)Copyright (c) 1995, Simon J. Gerraty.
.\"
.\"	This is free software.	It comes with NO WARRANTY.
.\"	Permission to use, modify and distribute this source code
.\"	is granted subject to the following conditions.
.\"	1/ that the above copyright notice and this notice
.\"	are preserved in all copies and that due credit be given
.\"	to the author.
.\"	2/ that any changes to this code are clearly commented
.\"	as such so that the author does not get blamed for bugs
.\"	other than his own.
.\"
.\"	Please send copies of changes and bug-fixes to:
.\"	sjg@zen.void.oz.au
.\"
.Dd February 26, 2012
.Dt BANNER 1
.Os
.Sh NAME
.Nm banner
.Nd print strings in large letters
.Sh SYNOPSIS
.Nm
.Op Fl l
.Op Fl b Ar bg
.Op Fl f Ar fg
.Ar string ...
.Sh DESCRIPTION
.Nm
prints up to 10 chars of each
.Ar string
in large letters on the standard output.
.Pp
The options are:
.Bl -tag -width Ds
.It Fl b Ar bg
Use
.Ar bg
as the background color (character) rather than the default
.Dq \  .
.It Fl f Ar fg
Use
.Ar fg
as the foreground color (character) rather than the default
.Dq # .
If
.Ar fg
is
.Dq - ,
then the actual letter being printed is used as the
foreground color in the same way that LPD does it.
The results are quite variable.
.It Fl l
Use the more attractive LPD font instead of the traditional
.Nm
font.
.El
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr banner 6
Remove trailing whitespace. From Bug Hunting in PR 46102. 2012-02-29 12:54:55 +04:00			`.\" $NetBSD: banner.1,v 1.9 2012/02/29 08:54:55 wiz Exp $`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.\"`
			`.\" @(#)Copyright (c) 1995, Simon J. Gerraty.`
Whitespace cleanup. 2001-12-01 19:43:07 +03:00			`.\"`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.\" This is free software. It comes with NO WARRANTY.`
Fix more problems noted in PR 6649 2001-03-08 01:34:35 +03:00			`.\" Permission to use, modify and distribute this source code`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.\" is granted subject to the following conditions.`
Fix more problems noted in PR 6649 2001-03-08 01:34:35 +03:00			`.\" 1/ that the above copyright notice and this notice`
			`.\" are preserved in all copies and that due credit be given`
			`.\" to the author.`
			`.\" 2/ that any changes to this code are clearly commented`
			`.\" as such so that the author does not get blamed for bugs`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.\" other than his own.`
Whitespace cleanup. 2001-12-01 19:43:07 +03:00			`.\"`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.\" Please send copies of changes and bug-fixes to:`
			`.\" sjg@zen.void.oz.au`
			`.\"`
Sort options in man page. Add EXIT STATUS section. Bump date. Sync usage with man page. Mostly from Bug Hunting in PR 46102. 2012-02-27 01:04:10 +04:00			`.Dd February 26, 2012`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.Dt BANNER 1`
			`.Os`
			`.Sh NAME`
Fix problem noted in PR 6649 (nuke trailing whitespace in .Nm) 2001-03-08 01:32:36 +03:00			`.Nm banner`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.Nd print strings in large letters`
			`.Sh SYNOPSIS`
WARNSify, fix .Nm usage 1997-10-18 16:12:38 +04:00			`.Nm`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`.Op Fl l`
Sort options in man page. Add EXIT STATUS section. Bump date. Sync usage with man page. Mostly from Bug Hunting in PR 46102. 2012-02-27 01:04:10 +04:00			`.Op Fl b Ar bg`
			`.Op Fl f Ar fg`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.Ar string ...`
			`.Sh DESCRIPTION`
WARNSify, fix .Nm usage 1997-10-18 16:12:38 +04:00			`.Nm`
Fix more problems noted in PR 6649 2001-03-08 01:34:35 +03:00			`prints up to 10 chars of each`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.Ar string`
			`in large letters on the standard output.`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`.Pp`
			`The options are:`
			`.Bl -tag -width Ds`
			`.It Fl b Ar bg`
Whitespace cleanup. 2001-12-01 19:43:07 +03:00			`Use`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`.Ar bg`
New sentence, new line. Some mdoc cleanup. 2002-09-30 13:33:39 +04:00			`as the background color (character) rather than the default`
			`.Dq \ .`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`.It Fl f Ar fg`
Whitespace cleanup. 2001-12-01 19:43:07 +03:00			`Use`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`.Ar fg`
New sentence, new line. Some mdoc cleanup. 2002-09-30 13:33:39 +04:00			`as the foreground color (character) rather than the default`
			`.Dq # .`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`If`
			`.Ar fg`
New sentence, new line. Some mdoc cleanup. 2002-09-30 13:33:39 +04:00			`is`
			`.Dq - ,`
			`then the actual letter being printed is used as the`
			`foreground color in the same way that LPD does it.`
			`The results are quite variable.`
Allow the LPD font to be selected at runtime rather than compile time. Also added -f fg and -b bg switches to control the fore/back ground "colors". One can now do inverse :-) 2000-05-30 16:03:31 +04:00			`.It Fl l`
			`Use the more attractive LPD font instead of the traditional`
			`.Nm`
			`font.`
			`.El`
Remove trailing whitespace. From Bug Hunting in PR 46102. 2012-02-29 12:54:55 +04:00			`.Sh EXIT STATUS`
			`.Ex -std`
a /usr/bin/banner clone, written by Simon J. Gerraty 1995-04-09 09:53:04 +04:00			`.Sh SEE ALSO`
			`.Xr banner 6`