home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / tad111.zip / TAGADAY.DOC < prev    next >
Text File  |  1993-08-25  |  8KB  |  171 lines
  1.                                     [ TAGADAY ]
  2.  
  3.                             « A Tagline a Day Program »
  4.  
  5.                                    Version 1.11
  6.  
  7.                              (c) 1993 Robert N. Payes
  8.  
  9.  
  10. SO WHAT'S A TAGLINE?
  11.      Taglines (aka one-liners, fortune cookies, etc.) are pithy little
  12.      sayings typically found at the end of messages posted on BBS's.  The
  13.      growth of message networks such as RelayNet led to the development of
  14.      off-line mail readers (SLMR/OLX, BlueWave, et. al) to allow BBS'ers
  15.      to read and reply to new messages without the meter ticking.  Most of
  16.      these off-line readers allow the attaching of a tagline (either
  17.      random or user-selected) to the messages they create.  More recently,
  18.      a subset of programs arose for the sole purpose of maintaining
  19.      taglines (such as John Hancock and Tag Line Express).  Additionally,
  20.      the nets themselves have conferences dedicated exclusively to the
  21.      posting, critiquing, and swiping of taglines!
  22.  
  23. SO THEN, WHAT'S "TAGADAY?"
  24.      TAGADAY randomly selects a tagline from an ASCII-text tagline file,
  25.      such as the TAGLINES.TXT file included with TAGADAY and either
  26.      displays it on your computer screen or writes it to a text file
  27.      (either "plain vanilla" text or with ANSI color codes).  If
  28.      displaying the tagline, TAGADAY waits for you to press either "Enter"
  29.      (to display another tagline) or "Esc" (to quit).  You can run TAGADAY
  30.      from the DOS prompt, or include it in your AUTOEXEC.BAT file for a
  31.      smile (or two!  Or three!) every time you reboot.  BBS sysops can use
  32.      the write-to-file option to create a daily tagline file to be
  33.      displayed when users log in.
  34.  
  35. HOW DOES IT WORK?
  36.      As simply as possible.  If you simply run TAGADAY with no parameters,
  37.      it will attempt to use a file called TAGLINES.TXT in the current
  38.      drive\directory and set the screen colors to bright-white-on-cyan
  39.      (for color systems) or bright-white-on-black (for monochrome
  40.      systems).  If there's a problem (i.e. TAGADAY can't find the tagline
  41.      file), it'll politely quit and display an error/help  message.
  42.  
  43.      TAGADAY accepts one or more of the following command-line options:
  44.  
  45.      /help 
  46.       or
  47.      /?   Displays the error/help  message.
  48.  
  49.      /t   Specifies the drive\path\name of the tagline file to use. 
  50.           For example:
  51.  
  52.           /tc:\olx\tags.txt
  53.  
  54.           will tell TAGADAY to look for the file "tags.txt" in the
  55.           directory "c:\olx".
  56.  
  57.      /o
  58.       or
  59.      /a   Writes the selected tagline to a text file instead of
  60.           displaying it on the screen.  The primary difference
  61.           between the two options is that "/a" also writes ANSI color
  62.           codes to the text file (you must have ANSI.SYS or an
  63.           equivalent device driver loaded in your CONFIG.SYS file in
  64.           order to properly display the file).  Unless the "/f"
  65.           and/or "/b" parameters are set (see below), the color codes
  66.           used will be the system defaults.
  67.  
  68.      /f   Sets the foreground text color.  For example:
  69.  
  70.           /fLIGHTGREEN
  71.  
  72.      /b   Sets the background text color. For example:
  73.  
  74.           /bMAGENTA
  75.  
  76.      Acceptable colors are:
  77.  
  78.      Color            FG/BG   Color            FG/BG
  79.      ──────────────────────   ──────────────────────
  80.      BLACK             both   DARKGRAY       FG only
  81.      BLUE              both   LIGHTBLUE      FG only
  82.      GREEN             both   LIGHTGREEN     FG only
  83.      CYAN              both   LIGHTCYAN      FG only
  84.      RED               both   LIGHTRED       FG only
  85.      MAGENTA           both   LIGHTMAGENTA   FG only
  86.      BROWN             both   YELLOW         FG only
  87.      LIGHTGRAY         both   WHITE          FG only
  88.  
  89.      (Note: All command-line switches and parameters are case-insensitive,
  90.      i.e. they can be entered in upper-case, lower-case, or any
  91.      combination you feel like.  Needless to say, setting the foreground
  92.      and background to the same color will make your tagline *extremely*
  93.      hard to read!  :-> )
  94.  
  95. THE TAGADAY.CFG FILE
  96.      The first time you run TAGADAY, it creates a configuration file
  97.      called TAGADAY.CFG, which contains the number of taglines in the
  98.      selected tagline file and the file size.  Once TAGADAY.CFG is
  99.      created, on subsequent runs TAGADAY checks to see if the tagline file
  100.      has been modified; if it hasn't, TAGADAY can go right ahead and pick
  101.      a tagline out of the file.  Otherwise TAGADAY must re-read the
  102.      tagline file to get the current tagline count and update TAGADAY.CFG.
  103.  
  104.      Unless otherwise specified, TAGADAY.CFG is created (and looked for by
  105.      TAGADAY) in the current drive\subdirectory.  If you wish to keep
  106.      TAGADAY.CFG in a different drive\directory, you can set the
  107.      environmental variable TAGADAY to point to TAGADAY.CFG's location. 
  108.      For example:
  109.  
  110.      SET TAGADAY=C:\DOS
  111.  
  112.      would look for TAGADAY.CFG in C:\DOS.  It's best to place the SET
  113.      TAGADAY command in your AUTOEXEC.BAT file; if you're also running
  114.      TAGADAY from AUTOEXEC.BAT, make sure the SET TAGADAY command comes
  115.      FIRST!
  116.  
  117. HOW CAN I ADD TO/MODIFY THE TAGLINE TEXT FILE?
  118.      1)   Do it yourself!  Any text editor can be used to
  119.           add/remove/edit taglines.  This includes EDLIN, EDIT (DOS 5
  120.           and up), Windows Notepad, Qedit, Brief, etc.  One caveat:
  121.           taglines must be no more than 72 characters in length; you
  122.           can go ahead and *write* longer tags, TAGADAY just won't
  123.           use 'em.  (Note: I didn't set these limits, the mail nets
  124.           and tagline manager programs did...)
  125.  
  126.      2)   Let your off-line mail reader and/or tagline manager do it
  127.           for you!  These programs either keep their taglines in
  128.           ASCII format to begin with, or allow you to dump the
  129.           taglines to a text file.
  130.  
  131. HOW MUCH DOES TAGADAY COST TO REGISTER?
  132.      Are you kidding?  :->  I banged this together in two weeks for my own
  133.      entertainment (and to further teach myself Turbo C programming).  If
  134.      you have as much fun running TAGADAY as I had GETTING it to run, I'm
  135.      a happy camper.
  136.  
  137. REVISION HISTORY
  138.      August 11, 1993 [v1.00]: First public release of TAGADAY.
  139.      August 16, 1993 [v1.10]: Added "/o" and "/a" options (thanks to
  140.           David Kaufman, sysop of Brooklyn Broadcasting System BBS
  141.           [RIP], for the suggestion).
  142.      August 17, 1993 [v1.11]: Minor bug revision; rewrote screen/file
  143.           output routines to better scale the frame to tagline size.
  144.  
  145. SEMI-LEGALESE
  146.      The TAGADAY.EXE program and TAGADAY.DOC documentation file are (c)
  147.      1993 Robert N. Payes.
  148.  
  149.      TAGADAY is being distributed as freeware.  You are permitted (nay,
  150.      encouraged!) to pass copies of this program to friends, colleagues,
  151.      and bulletin board systems.  TAGADAY may be included on disk
  152.      collections of public domain/shareware/freeware in which a minimal
  153.      disk-copying fee is charged to the purchaser; any other fee
  154.      collection in regards to the program is frowned upon (unless you kick
  155.      back some to me, ho ho!)
  156.  
  157. QUESTIONS?  COMMENTS?  
  158.  
  159. E-mail:
  160.      Running Board BBS             718-654-1349
  161.      Moondog's Free BBS            718-692-2498
  162.      Off Hour Rockers BBS          908-591-2673
  163.  
  164. Snail Mail:
  165.      Robert Payes
  166.      1070 Bloomfield Ave. 1C
  167.      West Caldwell, NJ 07006
  168.  
  169. CLOSING REMARKS:
  170.      Calm down, it's only ones and zeros.
  171.