home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 19 Printer / 19-Printer.zip / banos2.zip / ENGLISH.TXT < prev    next >
Text File  |  1995-08-13  |  8KB  |  279 lines
  1.  
  2.  
  3. OS/2 Banner English Information file - ENGLISH.TXT
  4. __________________________________________________
  5.  
  6.  
  7. Title :  UNIX-style Banner command for OS/2, Version 1.0
  8. Author:  (c) 1995, Mr Antonino Iannella
  9. Date  :  August 13, 1995
  10.  
  11. CONTENTS
  12. ________
  13.  
  14.  
  15. Description
  16. Installation
  17. Usage
  18. The power of the UNIX Banner command
  19. Limitations
  20. Future plans
  21. License agreement
  22. Acknowledgments
  23. Author contact details
  24.  
  25.  
  26. ------------ OS/2 : A better DOS than DOS -------------
  27.  
  28. Description
  29. ___________
  30.  
  31. This is a UNIX-style Banner command for OS/2.  It
  32. prints the words input as arguments in big text letters
  33. using asterisks.  Each expression is printed on one line.
  34. Expressions longer than 9 characters are split.
  35. It is fully-operational.
  36.  
  37. Each argument must be delimited in quotes (") if they
  38. contain whitespaces (" "), circumflexes (^), or
  39. relations; (<) and (>), or (|).  A quote can be printed
  40. within the argument using \".  However, this means that \"
  41. will not print as \" but ".
  42.  
  43. It is not a complex nor exciting program, but it is my
  44. first piece of software for the OS/2 general public
  45. (see License agreement section).
  46. I sincerely hope that somebody benefits from it!
  47.  
  48.  
  49. ------------ OS/2 : A better DOS than DOS -------------
  50.  
  51.  
  52. Installation
  53. ____________
  54.  
  55.  
  56. Ideally, place all files in your PATH, preferably in
  57. \OS2\APPS.  Or add Banner's location to your path.
  58. The information files can be safely deleted (but not
  59. when distributing; see License agreement section).
  60.  
  61. You might also need the EMX runtime library in your path.
  62.  
  63.  
  64. ------------ OS/2 : A better DOS than DOS -------------
  65.  
  66. Usage
  67. _____
  68.  
  69.  
  70. Banner operates at the command line.  It must have arguments.
  71.  
  72. For example,
  73.  
  74. Banner "Hi, sexy!"
  75.  
  76.  *    *                                                            **   
  77.  *    *    *                      ****    ****           *    *    **   
  78.  *    *                          *       *    *  *    *  *    *    **   
  79.  ******    *       **             ****   *****     **     *****    **   
  80.  *    *    *       **                 *  *         **         *         
  81.  *    *    *      **              ****    ****   *    *   ****     **   
  82.  
  83. excluding the quotes yields
  84.  
  85. banner Hi, sexy!
  86.  
  87.  *    *                 
  88.  *    *    *            
  89.  *    *                 
  90.  ******    *       **   
  91.  *    *    *       **   
  92.  *    *    *      **    
  93.  
  94.                                    **   
  95.   ****    ****           *    *    **   
  96.  *       *    *  *    *  *    *    **   
  97.   ****   *****     **     *****    **   
  98.       *  *         **         *         
  99.   ****    ****   *    *   ****     **   
  100.  
  101. To see things one screen at a time,
  102.  
  103. banner Smashing Pumpkins: \"Siamese Dream\" | more
  104.  
  105.  
  106.   ****                                                          
  107.  *    *           ***     ****   *         *              ****  
  108.  *        ** *       *   *       *                ****   *    * 
  109.   ****   *  * *   ****    ****   *****     *     *    *   ***** 
  110.  *    *  *  * *  *   *        *  *    *    *     *    *       * 
  111.   ****   *  * *   *** *   ****   *    *    *     *    *   ****  
  112.  
  113.  *****                                                                  
  114.  *    *                          *         *              ****     **   
  115.  *    *  *    *   ** *   *****   *   *            ****   *         **   
  116.  *****   *    *  *  * *  *    *  * *       *     *    *   ****          
  117.  *       *    *  *  * *  *****   * *       *     *    *       *    **   
  118.  *        ****   *  * *  *       *   *     *     *    *   ****     **   
  119.  
  120.    *  *   ****                                                  
  121.    *  *  *    *    *      ***             ****    ****    ****  
  122.   *  *   *                   *    ** *   *    *  *       *    * 
  123.           ****     *      ****   *  * *  *****    ****   *****  
  124.          *    *    *     *   *   *  * *  *            *  *      
  125.           ****     *      *** *  *  * *   ****    ****    ****  
  126.  
  127.  *****                                     *  * 
  128.  *    *           ****    ***              *  * 
  129.  
  130. -- More --
  131.  
  132.  *    *   ****   *    *      *    ** *    *  *  
  133.  *    *  *       *****    ****   *  * *         
  134.  *    *  *       *       *   *   *  * *         
  135.  *****   *        ****    *** *  *  * *         
  136.  
  137.  
  138. To redirect the output to a printer,
  139.  
  140. banner "I'm a" lumberjack and "I'm OK" > prn
  141.  
  142. To redirect the output to a file,
  143.  
  144. banner Do to me what your eyes say you wanna do! > Stimulating_experience.ohh
  145.  
  146. The supported ASCII characters are
  147.  
  148.  !"#$%&'()*+,-./0123456789:;<=>?@
  149. ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`
  150. abcdefghijklmnopqrstuvwxyz{|}~
  151.  
  152.  
  153. ------------ OS/2 : A better DOS than DOS -------------
  154.  
  155.  
  156. The power of the UNIX Banner command
  157. ____________________________________
  158.  
  159.  
  160. On a UNIX system, one way to shock your best friend is to type
  161.  
  162. Banner "Do your work" | write <username>
  163.  
  164. The recipient must have set messages on first.  They achieve
  165. this by typing
  166.  
  167. mesg y
  168.  
  169. Hence Banner's power lies in making the recipient's heart stop.
  170. I love the UNIX Banner command.
  171.  
  172. ------------ OS/2 : A better DOS than DOS -------------
  173.  
  174. Limitations
  175. ___________
  176.  
  177.  
  178. I compiled this with EMX/GCC 0.9a, using OS/2 2.1 .
  179. I guess this is a minimum requirement.
  180.  
  181. If it's just not working, you may need the EMX.DLL file
  182. in your path.  This may be available from various OS/2 ftp
  183. sites (try ftp.latrobe.edu.au), as part of the EMX/GCC package.
  184. If this is the case, I would like to be informed (Preferably
  185. by someone who knows the solution...), because this is an
  186. compilation error.
  187. on
  188. one who knows the solution...
  189.  
  190. \ and " cannot be printed consecutively since they are interpreted
  191. as a ".  All control characters are printed as solid squares.
  192. The <CTRL><J> character within an argument, inhibits ALL
  193. characters following it from being read.  European characters
  194. are not supported.
  195.  
  196. The default command shell resolution is the only one
  197. supported (80 characters across).  Smaller resolutions may
  198. result in distorted output.
  199.  
  200. ------------ OS/2 : A better DOS than DOS -------------
  201.  
  202. Future plans
  203. ____________
  204.  
  205. I would like to turn it into a PM shell, desktop publishing
  206. application, with full support for fonts, SOM, pictures, and
  207. printing.  Pretty good, eh?
  208.  
  209.  
  210. ------------ OS/2 : A better DOS than DOS -------------
  211.  
  212.  
  213. License agreement
  214. _________________
  215.  
  216.  
  217. Mr Bill Gates is rich, so he can afford to pay me
  218. US $1,000,000.00 .  However, Microsoft employees and their
  219. families can pay a mere US $999,999.99 because I am lenient.
  220.  
  221. The rest of the cosmos can use Banner for FREE!  I relinquish
  222. it to the Public Domain.  All associated text files must be
  223. distributed with the executable file.  However, I do not
  224. guarantee the software's reliability.  Any damage or loss
  225. incurred as a result of this software is NOT the author's
  226. responsibility!
  227.  
  228. For registration purposes, I shall follow a fad; I would
  229. really appreciate a postcard of your home city, or a more
  230. interesting one.  Or else, send me an Email to the address
  231. at the bottom.  Include your name and contact details.
  232.  
  233.  
  234. ------------ OS/2 : A better DOS than DOS -------------
  235.  
  236.  
  237. Acknowledgments
  238. _______________
  239.  
  240.  
  241. My cousin Ms Patricia Manzitti for helping me with the
  242. Italian and French translations.
  243.  
  244. Johannes Schwabe for helping me compile it.
  245.  
  246. To the EMX/GCC user group members for putting up with
  247. my stupid questions :-)
  248.  
  249.  
  250. ------------ OS/2 : A better DOS than DOS -------------
  251.  
  252.  
  253. Author contact details
  254. ______________________
  255.  
  256. I may be contacted at the following addresses.
  257. Please send postcards, software, bug reports, or any of
  258. your thoughts of Banner! to
  259.  
  260. Postal address:
  261.  
  262. Mr Antonino Iannella
  263. 6 Bolingbroke Avenue
  264. DEVON PARK SA 5008
  265. AUSTRALIA
  266.  
  267. Email address: (emergency only)
  268. PS- I really would prefer a postcard!
  269.  
  270.        ****    ****       *  ****     Operate at a higher level.
  271.      *    *  *    *     *  *    *
  272.     *    *  *         *       *       Mr Antonino Iannella
  273.    *    *   ****    *      *          Computer Systems Engineering
  274.   *    *  *    *  *     *
  275.   ****    ****  *      ******         9308390r@lux.levels.unisa.edu.au
  276.  
  277.  General Application Error in Module MS:WIN-95.
  278.  This version will now self-destruct!
  279.