home *** CD-ROM | disk | FTP | other *** search
/ 1st Canadian Shareware Disc / 1st_Canadian_Shareware_Disc_1991.ISO / graphics / bl101 / bl.doc < prev    next >
Text File  |  1990-08-04  |  12KB  |  234 lines
  1.  
  2.  
  3.      BigLetters 1.01
  4.      Program and documentation Copyright 1990 Robert Hoffmann
  5.      --------------------------------------------------------
  6.      [Note major documentation change.  Page 1 is now following page 2, so
  7.      that you can scan it online and see how it works before reading my
  8.      life story.]
  9.  
  10.      [For ease, convenience, and kindness to Atlanta-based programmers,
  11.      BigLetters is referred to as BL from this point forward.]
  12.  
  13.      [Also note that there are several interesting changes from 1.00.
  14.      They're marked with pipe symbols ('|') in column 1.  So are the less
  15.      interesting changes.]
  16.  
  17.      Page 2
  18.      ------
  19.           Now then, how does it work?
  20.           Easily.
  21.           1. Unpack the archive (ZIP, LZH, whatever?) into a directory
  22.      that's on your path.
  23.           2. Decide what wondrous saying you want to immortalize in 8-line
  24.      type.
  25. |         3. Pick an option and run the program.
  26.  
  27.              Option 1 allows you to do all the dirty work at the command
  28.              line.
  29.  
  30. |            Option 2 asks you three questions interactively - in the same
  31. |            order and for the same functions as the command line options
  32. |            in Option 1.
  33.  
  34.      ┌Option 1────────────────────────────────────────────────────────────┐
  35.      │BL [B|M|T] Your Saying >Outfile                                     │
  36.      └────────────────────────────────────────────────────────────────────┘
  37. |    ┌Option 2────────────────────────────────────────────────────────────┐
  38. |    │BL                                                                  │
  39. |    └────────────────────────────────────────────────────────────────────┘
  40. |         The B, M, or T are REQUIRED if you use option 1.  BL will ask you
  41. |    which one to use in Option 2.  Either way, it tells BL which of the
  42.      three available sizes to use:
  43.  
  44.       ▓▓▓▓▓▓    ▓▓
  45.        ▓▓  ▓▓
  46.        ▓▓  ▓▓  ▓▓▓     ▓▓▓ ▓▓
  47.        ▓▓▓▓▓    ▓▓    ▓▓  ▓▓
  48.        ▓▓  ▓▓   ▓▓    ▓▓  ▓▓
  49.        ▓▓  ▓▓   ▓▓     ▓▓▓▓▓
  50.       ▓▓▓▓▓▓   ▓▓▓▓       ▓▓ (sorry, STILL no shadows)
  51.                       ▓▓▓▓▓
  52.  
  53.       ██▄ ▄██   ▀▀       ▀██            ▀▀
  54.       ███████  ▀██    ▄█▀▀██  ▄█▀▀▀▀   ▀██    █▀▀██▀  ▄█▀▀█▄
  55.       ██ ▀ ██   ██    ██  ██   ▀▀▀█▄    ██     ▄█▀ ▄  ██▀▀▀▀
  56.       ▀▀   ▀▀  ▀▀▀▀    ▀▀▀ ▀▀ ▀▀▀▀▀    ▀▀▀▀   ▀▀▀▀▀▀   ▀▀▀▀
  57.  
  58.       ▐██▌     █▌  █▌
  59.       ▐▐▌▌     ▐▌  ▐▌
  60.        ▐▌  ██  ▐▌  ▐▌
  61.        ▐▌   ▐▌ ▐▌  ▐▌
  62.        ▐▌  ██▌ ▐▌  ▐▌
  63.        ▐▌ ▐▌▐▌ ▐▌  ▐▌
  64.        ██  █▌█ ██  ██
  65.                 
  66.        (or, respectively, 8 lines high by 8 characters wide, 4x8, and 8x4)
  67.  
  68.      Page 3
  69.      ------
  70.      (You still haven't reached page 1 yet)
  71.  
  72.           The ">Outfile" part isn't strictly required, but if you want to
  73.      save your handiwork, that's how.  Without it, output goes right to
  74.      Standard Output (your screen) -- and thence to the bitbucket...
  75.           Certain characters (">","<", for example) can't be typed in a
  76.      string on the DOS command line.  Use the following methods to get
  77.      them (just type the substitute commands right into the string):
  78.      ┌────────────────────────────────────────────────────────────────────┐
  79.      │    &N - New line   && - "&"      &C - ","                          │
  80.      │    &G - ">"        &P - "|"      &S - ";"                          │
  81.      │    &L - "<"        &E - "="                                        │
  82.      │    &Annn - ASCII character #nnn (good for characters below ASCII   │
  83.      │            32) - nnn MUST be 3 characters long (lead with zeroes!).│
  84.      └────────────────────────────────────────────────────────────────────┘
  85.           For most of you, some of the above substitutions are a waste of
  86.      time.  However, some DOSes are weirder than others, and I didn't want
  87.      to be the cause of someone's distress 'cause they couldn't get a comma
  88.      into their obscene 8-line ranting!
  89.           BL will attempt to write the entire string across one "line"
  90.      unless you insert Newlines with &N (I can do a lot of things,
  91.      mindreading isn't one of them!).
  92.  
  93. |         In Option 2, you just run the program.  BL will ask you the type
  94. |    size, the message you want made BIG (use the &-substitutions if
  95. |    needed!), and what file to save it to.  You *can* hit <Enter> for the
  96. |    file to save, and your work will roll up the screen in front of you
  97. |    and (again) find the bitbucket.
  98.  
  99. |         ADVANCED STUFF:  By default, BL searches your DOS PATH for
  100. |    BL.DAT, the bitmap file.  However, if you're the kind of person who
  101. |    renames everything, you can force BL to look in your secret hiding
  102. |    place by setting the DOS environment variable BL to the pathname of
  103. |    your .DAT file.  For example, if you're a Carol Whitney fan, try:
  104. |    ┌────────────────────────────────────────────────────────────────────┐
  105. |    │SET BL=D:\QUE_QUE\PRANCY.DAT                                        │
  106. |    └────────────────────────────────────────────────────────────────────┘
  107. |    if that's where the bitmap file is.  Just don't tell me about it.
  108.  
  109. |         OPTION 2 NOTE: If your requested output file exists, BL will
  110. |    append your text to the end of it.  Be careful with this option if
  111. |    you're going to try to append BL text to the end of a file which may
  112. |    not be fully written to disk.  Use your editor's write-to-disk command
  113. |    immediately before running BL.  Also be warned that some text editors,
  114. |    such as Qedit (although we're not naming names!), don't ordinarily
  115. |    reload files from disk after a shell to DOS.  Qedit can be coerced into
  116. |    doing so (use the macro language!), but watch for this in other
  117. |    editors, too.
  118.  
  119.  
  120.      Page 1
  121.      ------
  122.      (You should know better than to expect logic from a LUCIFERnet
  123.       official...)
  124.  
  125.           Those of you who know me from the National ByteBrothers Support
  126.      Conference (fondly known as LUCIFERnet) know that I like to use
  127.      oversized letters -- of my own (?!) creation -- to make my point
  128.      occasionally in conference messages.
  129.           Some of you have gone so far as to capture (read: "steal") my
  130.      handiwork and use it yourself.
  131.           When I was asked how I did it, I told you it was with a program
  132.      that was machine-specific (at the time, it was) and that I really
  133.      didn't see the need to release BL.
  134.           Then, a couple of Canadians came out with Quick Titles.  It was
  135.      time-bombed, I was unhappy... so I released version 1.00 of BL.
  136. |         Then, Harris Minter, Valeria Palmer, and Fast Logic Outlaws
  137. |    released BBIG'UNS.  It's got a beg screen (for $5???) and some
  138. |    glaring bugs... I was unhappy, so I added a couple of bells and
  139. |    whistles to BL and unloaded version 1.01 on an unsuspecting
  140. |    (and uncaring?) world.  For what it's worth, *this* program is 40K
  141. |    smaller than its southern cousin!
  142.           It's NOT fancy, and it certainly doesn't have a lot of bells and
  143.      whistles, and it does require your editor to be able to run a DOS
  144.      command-line program and import text, but for those moments when 80x25
  145.      text just doesn't cut it... here's BL!
  146.  
  147.           The legalities:
  148.      -- The program is free (it's too trivial to charge for!).  Therefore,
  149.         I am asking subscription BBSes to place this archive in a
  150.         non-subscriber-level file directory.
  151.      -- However, I retain copyrights to the program.  The .DAT file is
  152.         of more dubious legality, but why not live dangerously?
  153.      -- The program is guaranteed to take up space on your disk.  It's
  154.         certainly not guaranteed in any other way.  As Dan Moore says, "If
  155.         it breaks, you own both parts".  It is rather unlikely to run amok
  156.         and sabotage your hard drive, but if you're the paranoid type, be
  157.         careful.
  158.      -- There should be exactly THREE files in the archive:
  159.         ■ BL.EXE - the program, natch.
  160.         ■ BL.DAT - the bitmaps for the characters.
  161.         ■ BL.DOC - I think you figured this one out.
  162.         No other files may be added to the archive.  Period.  If there are
  163.         any other files in there, I can't guarantee that *my* files have
  164.         been unaltered.  You can get a clean version of this program from
  165.         Thunder Road BBS in New York (718-392-8836).
  166.      -- If, for some deranged reason, you feel so moved by the program that
  167.         you want to send me money, you need serious help.  However, if you
  168.         DO want to send someone money, why not try a charity?  Send the
  169.         dough (in my name) and tell me about it.  My favorite charity is
  170.         the Big Brothers/Sisters of America - send donations to the chapter
  171.         serving your county.  (Thanks to Raymond Hugh for making me rewrite
  172.         that for the subtlety-impaired)
  173.  
  174.           If you want to ask me something about BL (like "Why did
  175.      you bother?"), you can reach me on Interlink's Shareware conference or
  176.      on LUCIFERnet.
  177.  
  178.  
  179.      Page 4
  180.      ------
  181.      (Yeah - after page 1!)
  182.  
  183.      Version History
  184.      ---------------
  185.      1.01 - 5 August 1990
  186.             ■ Added BL environment variable.
  187.             ■ Added "Option 2" interactive mode.
  188.             ■ Added creative page-numbering in the .DOC file.
  189.             ■ Renamed files to avoid name conflicts with BBIG'UNS.
  190.      1.00 - 23 July 1990
  191.             ■ Got it out just in time to make Harris, Valeria, and
  192.               F.L.O. unhappy by grabbing the BigLetters name first.
  193.  
  194.      Final Stuff
  195.      -----------
  196.           To my knowledge, it does most of what it is supposed to do.  As
  197.      stated on page 1 (wherever page 1 is), it is NOT guaranteed or
  198.      warranted. Use it at your own risk.  Your mileage may vary.
  199.           If it doesn't, let me know and I'll release 1.10.  For that
  200.      matter, if you have some wizard idea that (1) I can code and (2) is
  201.      worth my time, I could still be convinced to release a version 1.10
  202.      with your idea in it.  The suggestion that I not release version 1.10
  203.      will NOT be considered a "wizard idea".
  204.           Oh yeah, parts of the program are Copyright 1983-1990 Borland
  205.      International.  I used their Turbo Pascal 5.5 to create BL.
  206.           The BL.DAT file is lifted from copyrighted material by the Tandy
  207.      Corporation and Phoenix Compatibility Co.  They can sue me for all of
  208.      the proceeds if they want ("nothin' from nothin' leaves nothin'...").
  209.           LUCIFERnet is a wholly-owned subsidiary of the Rectaltronic
  210.      Corporation.  If you are a sysop of a PCBoard 14.x board with Qnet or
  211.      Rnet software, or a Wildcat! 2.1x sysop with Tnet, contact Jimmy
  212.      Pearson care of Bill Nolan's Mid-West Information Exchange, (316)
  213.      682-5548, for info on how a daily 5-to-10-minute mail run could change
  214.      your BBS forever.  (There are vicious rumors that the MINX number here
  215.      is wrong.  If it is, I'm sorry, but that's the one on the InterLink
  216.      membership list, so it's Andy Keeves' fault.)
  217.           Interlink is a figment of Andy Keeves' imagination.  You can call
  218.      Interlink World Headquarters at The Executive Network at (914)
  219.      667-4567 for membership information, or leave a message to Mark Rapp
  220.      in the IL NetUsers conference to start the process.
  221.           BBIG'UNS is a Long Communications release, distributed by Fast
  222.      Logic Outlaws.  All kidding aside, it'll be worth a look-see when
  223.      version 2.01 comes out.  Version 2.00 gots bugs...
  224.           You can contact me at: Robert Hoffmann
  225.                                  76-53 271 Street
  226.                                  New Hyde Park, NY 11040
  227.           If you read this far, and you like the program, drop me a
  228.      postcard or a short note (or a complaint masquerading as a disk). This
  229.      is what the 3-piece-suit types call a marketing test... personally, I
  230.      just want to see if anyone reads these silly things.
  231.           After 12 days, the above paragraph from Version 1.00 got me just
  232.      the one disk -- ASKING FOR A REFUND!!!  Sheesh!(tm)  It's enough to
  233.      make you sane...
  234.