home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume26 / banners-1.1 / part01 / README < prev   
Text File  |  1993-04-11  |  20KB  |  563 lines
  1.  
  2.             _-_ _,,
  3.                -/  )    _
  4.               ~||_<    < \, \\/\\ \\/\\  _-_  ,._-_  _-_,
  5.                || \\   /-|| || || || || || \\  ||   ||_.
  6.                ,/--|| (( || || || || || ||/    ||    ~ ||
  7.               _--_-'   \/\\ \\ \\ \\ \\ \\,/   \\,  ,-_-
  8.              (
  9.  
  10. ********************************************************************************
  11. *              BANNERS - the ultimative banner program collection              *
  12. *                   (created and maintained by Frank Kaefer)                   *
  13. ********************************************************************************
  14.  
  15. This is banners version 1.1.
  16.  
  17. The sources you find in this directory tree are different from other
  18. source packages: this directory holds the source to several different
  19. "banner" programs. These banner programms all serve the same purpose
  20. as the "normal" unix banner(1) programm: print banners to stdout. But
  21. there is a big difference between banner(1) and these banner programs.
  22. The banner programs in this directory are far more flexible and have
  23. many nice features. So if you allways wanted a better banner program,
  24. this is what you have been waiting for!
  25.  
  26. History:
  27. The idea of putting together a banner collection was born some years ago.
  28. Several smaller collections were posted to alt.sources and a call for
  29. contribution of banner programs was posted to many other groups.
  30. Banners version 1.0 was posted to comp.sources.unix: v26i109 - v26i113.
  31. Banners version 1.1 will also be submitted to comp.sources.unix.
  32.  
  33. In this package you should find the following files:
  34.  
  35. Makefile    a simple makefile to compile all banners
  36. README        the file you are just reading
  37. banner-01/    see below
  38. banner-02/    see below
  39. banner-03/    see below
  40. banner-04/    see below
  41. banner-05/    see below
  42. banner-06/    see below
  43. banner-07/    see below
  44. banner-08/    see below
  45. banner-09/    see below
  46. banner-10/    see below
  47. banner-11/    see below
  48. banner-12/    see below
  49. banner-13/    see below
  50. cursive-01/    see below
  51. cursive-02/    see below
  52. gothic/        see below
  53.  
  54. Some of these banner programs do not contain any manual page, so I am giving
  55. you a description of all these programs in this file.
  56.  
  57. If you have a nice banner program, please contact me. Also if you have
  58. found a bug in these banner programs, I'd like to encourage you to send
  59. me not only a note about the bug but also a fix for it (preferably in
  60. context diff format).
  61.  
  62. Email: frank.kaefer@Germany.Sun.COM (<- please use this address)
  63.        (frank.kaefer@sta.sub.org, frank.kaefer@sta.com)
  64.  
  65. Here is a more detailed description of the banner programs:
  66. ===========================================================
  67.  
  68. SYNOPSIS: how to start the banner program
  69. OPTIONS: command line options of the banner
  70. DESCRIPTION: some more info on this banner
  71. HISTORY: some background information
  72. EXAMPLES: sample banner output
  73.  
  74. banner-01
  75. ---------
  76. SYNOPSIS: banner [<opts>] {<string>} [<opts>]
  77. OPTIONS:
  78.           -i          prints italic 
  79.           -d          double size 
  80.           -c=<char>   character 
  81.           -s          use same character 
  82.           -z          read strings from standard input 
  83.           -z=<file>   read strings from <file> 
  84. DESCRIPTION: This banner can be used as a drop in replacement of the standard
  85.              banner.
  86. HISTORY: This was the very first banner on OS-9/68000 and it also compiled
  87.          fine on Unix, so it was one of the few programs that transitioned
  88.          with me from OS-9/68000 to Unix. Banner-12 is based on this banner.
  89. EXAMPLES:
  90. % bin/banner-01 Test
  91.  
  92. ******                     *    
  93. * ** *                    **    
  94.   **     ****    *****   *****  
  95.   **    **  **  **        **    
  96.   **    ******   ****     **    
  97.   **    **          **    ** *  
  98.  ****    ****   *****      **   
  99.  
  100. % bin/banner-01 -si Test
  101.  
  102.        TTTTTT                     t    
  103.       T TT T                    tt    
  104.        TT     eeee    sssss   ttttt  
  105.       TT    ee  ee  ss        tt    
  106.      TT    eeeeee   ssss     tt    
  107.     TT    ee          ss    tt t  
  108.   TTTT    eeee   sssss      tt   
  109.  
  110. % bin/banner-01 -d Test
  111.  
  112. ************                                          **        
  113. ************                                          **        
  114. **  ****  **                                        ****        
  115. **  ****  **                                        ****        
  116.     ****          ********        **********      **********    
  117.     ****          ********        **********      **********    
  118.     ****        ****    ****    ****                ****        
  119.     ****        ****    ****    ****                ****        
  120.     ****        ************      ********          ****        
  121.     ****        ************      ********          ****        
  122.     ****        ****                    ****        ****  **    
  123.     ****        ****                    ****        ****  **    
  124.   ********        ********      **********            ****      
  125.   ********        ********      **********            ****      
  126.  
  127.  
  128. banner-02
  129. ---------
  130. SYNOPSIS: banner /<option1> /<opt2> /<opt3> <text>
  131. OPTIONS:
  132.  /?          : Help text in German
  133.  /h          : Help text in German
  134.  /S:<breite> : Width of banner output, Default: 80
  135.  /D:<path>   : Specify different font file
  136.  /F:<path>   : banner the specified file
  137.  /#          : Use same char for bannering a letter
  138.  /P          : Read text from stdin
  139.  /U          : Convert all to capital letters
  140.  /R          : Reverse banner
  141.  /I          : Italics
  142.  /Cxy!z      : x = "Front-Color", y = "Background-Color" (optional)
  143.              : "!" = Enable shadowing (optional), x = Shadow char (optional)
  144. DESCRIPTION: Although this banner uses a DOS-like option syntax it is one
  145.              of the most powerful banners in this collection.
  146. HISTORY:
  147. EXAMPLES:
  148. % bin/banner-02 Test
  149.  ######                   ##
  150.  # ## #                   ##
  151.    ##     ####    ####   #####
  152.    ##    ##  ##  ##       ##
  153.    ##    ######   ####    ##
  154.    ##    ##          ##   ## ##
  155.   ####    ####   #####     ###
  156.  
  157. bin/banner-02 /c\+\_\!\` Test
  158. _++++++`__________________++`___
  159. _+`++`+`__________________++`___
  160. ___++`____++++`___++++`__+++++`_
  161. ___++`___++`_++`_++`______++`___
  162. ___++`___++++++`__++++`___++`___
  163. ___++`___++`_________++`__++`++`
  164. __++++`___++++`__+++++`____+++`_
  165. ________________________________
  166.  
  167.  
  168. banner-03
  169. ---------
  170. SYNOPSIS: banr [-n]
  171. OPTIONS:
  172.           -n  Forces no underlining to be used even if the capability exists
  173. DESCRIPTION: banr prints its standard input in large letters (but smaller than
  174.              banner(1)) on the standard output
  175. HISTORY: Written by Art Messenger (art@wilbur.coyote.trw.com)
  176. EXAMPLES:
  177. % bin/banner-03 -n 
  178. This is a test
  179. ___                                    
  180.  |  |_  . _    . _     _.    |  _  _ | 
  181.  |  | | | \    | \    (_|    | (-' \ | 
  182.                                        
  183.  
  184. banner-04
  185. ---------
  186. SYNOPSIS: banner <text>
  187. OPTIONS: none
  188. DESCRIPTION: simple but also nice banner
  189. HISTORY:
  190. EXAMPLES:
  191. % bin/banner-04 Test
  192. @@@@@@@
  193.    @     @@@@@@   @@@@    @@@@@
  194.    @     @       @          @
  195.    @     @@@@@    @@@@      @
  196.    @     @            @     @
  197.    @     @       @    @     @
  198.    @     @@@@@@   @@@@      @
  199.  
  200.  
  201. banner-05
  202. ---------
  203. SYNOPSIS:
  204. OPTIONS:
  205. DESCRIPTION: This is a banner collection. Important notice: bin/banner-05 is
  206.              a zero length touched file, the executables are named
  207.              banner-05-[1-9]. Banner-05-2 is the same as cursive.
  208.              Please look at the files in banner-05 for more information.
  209. HISTORY: A banner collection from Han YoonSoo KAIST
  210. EXAMPLES:
  211. % bin/banner-05-1 Test
  212. TTTTTTTTTT  EEEEEEEEEE   SSSSSSSS   TTTTTTTTTT  
  213. TTTTTTTTTT  EEEEEEEEEE  SSSSSSSSSS  TTTTTTTTTT  
  214.     TT      EE          SS       S      TT      
  215.     TT      EE          SS              TT      
  216.     TT      EEEEE       SSSSSSSSS       TT      
  217.     TT      EEEEE        SSSSSSSSS      TT      
  218.     TT      EE                  SS      TT      
  219.     TT      EE          S       SS      TT      
  220.     TT      EEEEEEEEEE  SSSSSSSSSS      TT      
  221.     TT      EEEEEEEEEE   SSSSSSSS       TT      
  222.  
  223. % bin/banner-05-2 Test
  224.   ______
  225.     /       _/_
  226.  --/ _  _   /
  227. (_/ </_/_)_<__
  228.  
  229. % bin/banner-05-3 Test
  230.  |''||''|                  .  
  231.     ||      ....   ....  .||. 
  232.     ||    .|...|| ||. '   ||  
  233.     ||    ||      . '|..  ||  
  234.    .||.    '|...' |'..|'  '|.'
  235.                               
  236.  '''''''' ''''''' '''''' '''''
  237.  
  238. % bin/banner-05-7 Test
  239.  _______________   __________      _____     _______________ 
  240. /______________/  /_________/    /____ / \  /______________/ 
  241.        | |       | |           /|      \ /         | |       
  242.        | |       | |______    |/ \ _____           | |       
  243.        | |       |/______/     \ /____ / \         | |       
  244.        | |       | |                   \ /|        | |       
  245.        | |       | |_________  / \ _____|/         | |       
  246.        |/        |/_________/  \ /_____/           |/      
  247.  
  248. % bin/banner-05-8 Test
  249.  _________   _______    _____    _________  
  250. |___   ___| |  _____|  / ____|  |___   ___| 
  251.     | |     | |___    | |____       | |     
  252.     | |     |  ___|    \____ \      | |     
  253.     | |     | |_____    ____| |     | |     
  254.     |_|     |_______|  |_____/      |_|     
  255.  
  256. bin/banner-05-9 Test
  257.  ___         
  258.   |   _   _|_
  259.   |  (= S  |_
  260.  
  261.  
  262. banner-06
  263. ---------
  264. SYNOPSIS: banner [-w#] [-d] [-t] message ...
  265. OPTIONS:
  266. DESCRIPTION:
  267.      Banner prints a large, high quality banner on  the  standard
  268.      output.  If the message is omitted, it prompts for and reads
  269.      one line of its standard input.  If -w is given, the  output
  270.      is  scrunched down from a width of 132 to n , suitable for a
  271.      narrow terminal.  If n is omitted, it defaults to 80.
  272.  
  273.      The output should be printed on a hard-copy  device,  up  to
  274.      132  columns  wide,  with  no  breaks between the pages. The
  275.      volume is great enough that you may want a printer or a fast
  276.      hardcopy  terminal,  but  if you are patient, a decwriter or
  277.      other 300 baud terminal will do.
  278. HISTORY: This is the BSD banner: "@(#)banner.c    4.3 (Berkeley) 6/1/90"
  279. EXAMPLES:
  280. % bin/banner-06 a
  281.                          ######## 
  282.                      ################ 
  283.                    #################### 
  284.                  ########################             ##### 
  285.                 ##########################          ########## 
  286.                ############################        ############# 
  287.               ##############################       ############## 
  288.               #########            #########       ############### 
  289.              ########                ########       ############## 
  290.              #######                  #######         ####   ###### 
  291.              ######                    ######                 ##### 
  292.              ######                    ######                  #### 
  293.              ######                    ######                  #### 
  294.               #####                    #####                   #### 
  295.               #####                    #####                  ##### 
  296.                #####                  #####                  ###### 
  297.                 #####                #####                  ####### 
  298.                  ######            ######                ######### 
  299.                   ################################################ 
  300.                 ################################################# 
  301.                ################################################# 
  302.               ################################################# 
  303.              ################################################# 
  304.              ############################################### 
  305.              ############################################# 
  306.              ######################################### 
  307.              ###### 
  308.              #### 
  309.              ### 
  310.              ## 
  311.  
  312.  
  313. banner-07
  314. ---------
  315. SYNOPSIS: banner <text>
  316. OPTIONS: none
  317. DESCRIPTION: And just another small banner variation.
  318. HISTORY:
  319. EXAMPLES:
  320. % bin/banner-07 test
  321.  _____  ___  __   _____
  322.    |   |__  |  \    |  
  323.    |   |     \__    |  
  324.    |   |___ \___|   |  
  325.  
  326.  
  327. banner-08
  328. ---------
  329. SYNOPSIS: banner [-h] [-s] <text>
  330. OPTIONS:  -h = convert to hebrew (compile with -DHEBREW)
  331.           -s = shadow mode on
  332. DESCRIPTION: Nice shadow function.
  333. HISTORY: Submitted by Amos Shapir <amos@cs.huji.ac.il>
  334. EXAMPLES:
  335. % ../bin/banner-08 Test
  336. ######                     #    
  337. # ## #                    ##    
  338.   ##     ####    #####   #####  
  339.   ##    ##  ##  ##        ##    
  340.   ##    ######   ####     ##    
  341.   ##    ##          ##    ## #  
  342.  ####    ####   #####      ##   
  343.                                 
  344. % ../bin/banner-08 -s Test
  345.         _  _ /                        /    
  346.       _/  /_/                        /    
  347.          /      __ /     ____/   _  __/  
  348.         /      /   /  _ /          /    
  349.        /      ____/   ___ /       /    
  350.       /    _ /           _/    _ /_/  
  351.   ____/    ____/   _____/      __/   
  352.                                     
  353.  
  354. banner-09
  355. ---------
  356. SYNOPSIS: banner <text>
  357. OPTIONS: none
  358. DESCRIPTION: And another banner. Has also nice output.
  359. HISTORY:
  360. EXAMPLES:
  361. % bin/banner-09 Test
  362.  @@@@@@@@@                       
  363.      @                       @   
  364.      @  @@@@@@@   @@@@@@@ @@@@@@@
  365.      @ @       @ @           @   
  366.      @ @@@@@@@@@  @@@@@@@    @   
  367.      @ @                 @   @  @
  368.      @  @@@@@@@   @@@@@@@     @@ 
  369.  
  370.  
  371. banner-10
  372. ---------
  373. SYNOPSIS: scripto <text >output
  374. OPTIONS: none
  375. DESCRIPTION: I didn't test this program because I have no pascal compiler,
  376.              it is included here only for completeness.
  377. HISTORY:
  378. EXAMPLES: none
  379.  
  380.  
  381. banner-11
  382. ---------
  383. SYNOPSIS:  mb [<opts>] [<text>] [<opts>]
  384. OPTIONS: 
  385.      -o=<file>      use <file> instead of the default font file.
  386.      -l             use the 16x8 font instead of the  8x8  font  (producing
  387.                     larger banners).
  388.      -w=<num>       print banner with a larger width. Default is 1.
  389.      -h=<num>       print banner with a larger height. Default is 1.
  390.      -c             print the banner cursive.
  391.      -C             print the banner back cursive.
  392.      -i             invert the banner.
  393.  
  394.      -f=<char>      use <char> as the foreground character. Default is `*'.
  395.      -b=<char>      use <char> as  the  background  character.  Default  is
  396.                     Space.
  397.      -s             use the character  as  foreground  which  is  currently
  398.                     printed.
  399. DESCRIPTION: Also a very nice banner program. See also Read.Me.
  400. HISTORY: This banner was written by a good friend of mine. This is
  401.          the latest version I got from him and although Read.Me says that
  402.          there is no manpage included, Ulli wrote a small manpage for me.
  403. EXAMPLES:
  404.  
  405. % bin/banner-11 -o=bin/banner-11.font Test
  406. ******                     *    
  407. * ** *                    **    
  408.   **     ****    *****   *****  
  409.   **    **  **  **        **    
  410.   **    ******   ****     **    
  411.   **    **          **    ** *  
  412.  ****    ****   *****      **   
  413.                                 
  414. % bin/banner-11 -o=bin/banner-11.font -l Test
  415.                                 
  416.                                 
  417.                                 
  418.  ******                         
  419.    **                     **    
  420.    **                     **    
  421.    **    *****   *****  ******  
  422.    **   **   ** **   **   **    
  423.    **   **   ** **        **    
  424.    **   *******  *****    **    
  425.    **   **           **   **    
  426.    **   **      **   **   **    
  427.    **    ******  *****     ***  
  428.                                 
  429.                                 
  430.                                 
  431. % bin/banner-11 -o=bin/banner-11.font -C Test  
  432. ******                     *           
  433.  * ** *                    **          
  434.     **     ****    *****   *****       
  435.      **    **  **  **        **        
  436.       **    ******   ****     **       
  437.        **    **          **    ** *    
  438.        ****    ****   *****      **    
  439.                                        
  440.  
  441. banner-12
  442. ---------
  443. SYNOPSIS: banner [<opts>] {<string>} [<opts>]
  444. OPTIONS:
  445.      -i         prints italic
  446.      -d         double size
  447.      -c=<char>  character
  448.      -s         use same character
  449.      -z         read strings from standard input
  450.      -z=<file>  read strings from <file>
  451. DESCRIPTION: This banner program is based on banner-01.
  452. HISTORY:
  453. 1.00 -- Written in 1987 by Wolfgang Ocker, reccoware systems, Puchheim.
  454. 1.01 -- Tested on OS-9/68000, SunOS, System V 3.2.
  455. 1.02 -- Some cleanups by Frank Kaefer (fkk@stasys.sta.sub.org).
  456. 1.10 -- Paul E. Black (paul@delfin.com):
  457.         - Added a C interface to the banner routine itself so it
  458.           can be linked with an application.  The user interface now
  459.           sets flags and calls the C interface.
  460.         - Letters can be any height, not just single or double.
  461.         - Multi-height italic are smoother: it shifts one column per
  462.           printed row rather than one double-column per double-row.
  463.         - Cleaned up and sped up some of the low level loops some what.
  464. 1.11 -- Banner is now under the GNU GENERAL PUBLIC LICENSE,
  465.         Version 2, June 1991 (fkk)
  466. EXAMPLES:
  467. % bin/banner-12 -d Test
  468. ************                                          **        
  469. ************                                          **        
  470. **  ****  **                                        ****        
  471. **  ****  **                                        ****        
  472.     ****          ********        **********      **********    
  473.     ****          ********        **********      **********    
  474.     ****        ****    ****    ****                ****        
  475.     ****        ****    ****    ****                ****        
  476.     ****        ************      ********          ****        
  477.     ****        ************      ********          ****        
  478.     ****        ****                    ****        ****  **    
  479.     ****        ****                    ****        ****  **    
  480.   ********        ********      **********            ****      
  481.   ********        ********      **********            ****      
  482.  
  483.  
  484. banner-13
  485. ---------
  486. SYNOPSIS: cyrban <text>
  487. OPTIONS: none
  488. DESCRIPTION: Print cyrillic banners.
  489. HISTORY:
  490. EXAMPLES:
  491. % bin/banner-13 Test
  492.  #####  #####   ####  ##### 
  493.    #    #      #        #   
  494.    #    ####   #        #   
  495.    #    #      #        #   
  496.    #    #####   ####    #   
  497.  
  498. % bin/banner-13 abcdefg
  499.    #    ####   #   #  #####  #####    #    ##### 
  500.   # #    #     #   #   #  #  #       ###   #   # 
  501.  #####   ####   ####   #  #  ####   # # #  #     
  502.  #   #   #  #      #   ####  #       ###   #     
  503.  #   #  #####      #  #    # #####    #    #     
  504.  
  505.  
  506. cursive-01
  507. ----------
  508. SYNOPSIS: cursive [ -in ] [ -tn ] [message]
  509. OPTIONS:
  510. DESCRIPTION:
  511.      Cursive prints a line of text  in  a  rather  crude  cursive
  512.      script.  It is intended for use mainly for the generation of
  513.      decorative signatures for electronic mail.  If message  text
  514.      is  given on the command line, that text is used.  Otherwise
  515.      the text will be read from standard input up to  an  end  of
  516.      file.   The -i option sets the minimum spacing between adja-
  517.      cent characters.  The default is -i1 . The  -t  option  sets
  518.      the  length  of  the trailing lines on the end of each word.
  519.      The default is -t1 .
  520.  
  521.      The '_' character is treated in a special way.   It  may  be
  522.      inserted  in  the  text anywhere you wish to lengthen a con-
  523.      necting line between two letters.
  524. HISTORY: Written by Jan Wolter.
  525. EXAMPLES:
  526. % bin/cursive-01 Test
  527.   ______
  528.     /       _/_
  529.  --/ _  _   /
  530. (_/ </_/_)_<__
  531.  
  532.  
  533. cursive-02
  534. ----------
  535. SYNOPSIS: see cursive-01
  536. OPTIONS: see cursive-01
  537. DESCRIPTION: see cursive-01 (The difference to cursive-01 is a different
  538.              character set.)
  539. HISTORY: see cursive-01
  540. EXAMPLES:
  541. % bin/cursive-02 Test
  542.   ______
  543.     /       _/_
  544.  --/ _  _   /
  545. (_/ (<_/_)_(__
  546.  
  547.  
  548. gothic
  549. ------
  550. SYNOPSIS: gothic
  551. OPTIONS: none
  552. DESCRIPTION: Print a line of text in Gothic (Black) Script.
  553. HISTORY:
  554. EXAMPLES:
  555. % bin/gothic Test
  556.  ___
  557. -   ---___-               ,
  558.    (' ||                 ||
  559.   ((  ||     _-_   _-_, =||=
  560.  ((   ||    || \\ ||_.   ||
  561.   (( //     ||/    ~ ||  ||
  562.     -____-  \\,/  ,-_-   \\,
  563.