1banner(1)                    Kenneth J. Pronovici                    banner(1)
2
3
4

NAME

6       banner - prints a short string to the console in very large letters
7

SYNOPSIS

9       banner string
10

DESCRIPTION

12       This  is a classic-style banner program similar to the one found in So‐
13       laris or AIX in the late 1990s.  It prints a short string to  the  con‐
14       sole in very large letters.
15
16       Banners that do not fit in the terminal will be truncated.  If $COLUMNS
17       is exported in the environment, it is taken to be the width of the ter‐
18       minal.  If $COLUMNS is not exported, and TIOCGWINSZ is available on the
19       platform, then its idea of the terminal size  is  used.   Otherwise,  a
20       terminal width of 80 characters is assumed.
21
22       Usage  is straightforward.  For instance, a single word is printed like
23       this:
24
25          > banner ken
26
27          #    #  #######  #     #
28          #   #   #        ##    #
29          #  #    #        # #   #
30          ###     #####    #  #  #
31          #  #    #        #   # #
32          #   #   #        #    ##
33          #    #  #######  #     #
34
35       Multiple arguments are printed on separate lines:
36
37          > banner one two
38
39          #######  #     #  #######
40          #     #  ##    #  #
41          #     #  # #   #  #
42          #     #  #  #  #  #####
43          #     #  #   # #  #
44          #     #  #    ##  #
45          #######  #     #  #######
46
47
48          #######  #     #  #######
49             #     #  #  #  #     #
50             #     #  #  #  #     #
51             #     #  #  #  #     #
52             #     #  #  #  #     #
53             #     #  #  #  #     #
54             #      ## ##   #######
55
56       To get a single long line containing whitespace,  you  must  quote  the
57       string:
58
59          > banner "one two"
60
61          #######  #     #  #######        #######  #     #  #######
62          #     #  ##    #  #                 #     #  #  #  #     #
63          #     #  # #   #  #                 #     #  #  #  #     #
64          #     #  #  #  #  #####             #     #  #  #  #     #
65          #     #  #   # #  #                 #     #  #  #  #     #
66          #     #  #    ##  #                 #     #  #  #  #     #
67          #######  #     #  #######           #      ## ##   #######
68
69

COMPATIBILITY

71       From  time to time, people assert that this program is buggy because it
72       doesn't do something that some other banner implementation  does.   The
73       behavior  of the program is based on what I saw on Solaris and AIX sys‐
74       tems at the time I wrote it in the late 1990s.  I make no  claims  that
75       the behavior is identical to that of any other contemporary system, es‐
76       pecially any non-free system that I may or may not have access to.
77
78       If you don't like the behavior, you can either submit a patch,  or  you
79       can  use  an  alternative program such as figlet.  I am always happy to
80       accept patches, and I promise to integrate  patches  promptly  if  pro‐
81       vided.   So  far,  no  one who's complained has bothered to provide any
82       patches, so the behavior remains the same.
83

BUGS

85       Report bugs to <support@cedar-solutions.com>.
86

AUTHOR

88       Written by Kenneth J. Pronovici <pronovic@ieee.org>.
89
91       Copyright (c) 2000-2004.2007,2013,2014 Kenneth J. Pronovici.
92       This is free software; see the source for copying conditions.  There is
93       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
94       PURPOSE.
95
96
97
98Banner                             Oct 2020                          banner(1)
Impressum