home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / B_DAY10.ZIP / BIRTHDAY.TXT < prev    next >
Text File  |  1993-11-16  |  7KB  |  177 lines
  1.                           BIRTHDAY GREETER 1.0
  2.                            Copyright 1993 by:
  3.                         Studio, Eh? Productions
  4.                           All rights reserved
  5.  
  6.  
  7.                            -=*What it does*=-
  8.  
  9.         Birthday Greeter will automatically create a logon screen or
  10. bulletin with the current months birthdays of your users.  It is
  11. designed for use with TriBBS 5.x and will create the bulletin/logon
  12. screen in the .bbs format using the @-codes for color.
  13.  
  14.         As sysop you may configure four color choices, whether to use
  15. aliases or the user's names, and whether to make a bulletin or a logon
  16. screen from it.
  17.  
  18.                          -=*The legal stuff*=-
  19.  
  20.         Birthday Greeter 1.0 is a copyrighted program and may not be
  21. sold, altered, or otherwised messed with without the written permission
  22. of either the author or Studio, Eh? Productions.  Please see later in
  23. this file for cost.
  24.  
  25.                             -=*Guarantee*=-
  26.  
  27.         This program is released "as is" and is not guaranteed to do
  28. ANYTHING but take up space on your harddrive.  The author has tested it
  29. on his own system and it works fine... but neither the author nor
  30. Studio, Eh? Productions will be held liable for any damages whatsoever
  31. that may arise from the use of this program.
  32.  
  33.                           -=*How to use it*=-
  34.  
  35.         First create a directory for Birthday Greeter and copy the files
  36. into the directory.  The only needed files in the directory are the .exe
  37. and .cfg file.
  38.  
  39.         Next, edit the config file for your board.  This is a simple
  40. textfile and you may edit it with any text editor.  I've included a
  41. sample, BIRTHDAY.CFG, but  you may call the config file whatever you
  42. wish. Below is a line-by-line description of the .cfg file...
  43.  
  44.                 BBSName=THE LEFT-HAND PATH
  45.                 NameFlag=U
  46.                 Month=11
  47.                 Color1=*GREEN
  48.                 Color2=YELLOW
  49.                 Color3=*MAGENTA
  50.                 Color4=*BLUE
  51.                 DatPath=C:\TRIBBS\MWORK\USERS.DAT
  52.                 ScreenPath=C:\TRIBBS\DISPLAY\LOGON#.BBS
  53.  
  54.         Please make sure that there are no spaces between the equal sign
  55. (=) and your entry.  Also, everthing to the left of the equal sign must
  56. be EXACTLY as printed above.
  57.  
  58.         Line 1 is pretty self explanatory.  Substitute your bbs's name
  59. for mine!  :)
  60.  
  61.         Line 2 is for which name to use.  Put a U there if you want to
  62. use the User name and an A there if you want the screen/bulletin to use
  63. the alias.
  64.  
  65.         Line 3 needs to be done in the two-digit format, i.e. January is
  66. 01 NOT 1, February is 02 NOT 2, etc.  When you first set it up put the
  67. current month in there, as you will want to run the program "manually"
  68. the first time.  When it's done making the screen/bulletin it will edit
  69. the .cfg file so that it won't keep overwriting the screen or bulletin
  70. (more on this later).
  71.  
  72.         Lines 4 - 7 are your color choices.  The program produces a
  73. header, the main body of the text (i.e. the birthdays), and then a
  74. footer.  Color1 and Color2 are the two colors that will alternate for
  75. the birthday entries.  Color3 and Color4 are the two colors that will
  76. alternate for the header and footer.  The background color is always
  77. black.  Your color choices for the foreground are as follows...
  78.  
  79. BLUE            GREEN           CYAN            RED             MAGENTA
  80. BROWN           WHITE           YELLOW          *BLUE           *GREEN
  81. *CYAN           *RED            *MAGENTA        *WHITE
  82.  
  83.         Putting the asterisk (*) in front of the colors indicates you
  84. want the bright version of them.  Please make these entries in ALL-CAPS
  85. (as shown).
  86.  
  87.         If you don't want the colors to alternate on the birthday
  88. entries and/or the header/footer, simply put the same color in the two
  89. lines that deal with them.
  90.  
  91.         Line 8 is the path to your USERS.DAT file.  It is located in
  92. your main node's MWORK directory.  Please note that you must include the
  93. complete path AND filename on this line.
  94.  
  95.         Line 9 is the path and filename to your logon screen or
  96. bulletin.  In the example it is to do a LOGON#.BBS, where # is replaced
  97. by whichever logon screen you want it to be.  The same set up goes for
  98. if you wish to make a bulletin, except the filename would be BULLET#.BBS
  99. (or BULLET##.BBS).
  100.  
  101.         Note that you can run the program twice, each with a different
  102. config, and turn out both a logon screen and a bulletin (if you so
  103. desire).
  104.  
  105.                        -=*Running the program*=-
  106.  
  107.         You should run it the first time by changing to the directory
  108. where the .exe and .cfg file are and type in:
  109.  
  110.         birthday birthday.cfg
  111.  
  112. and then hit <ENTER>.  Of course, if you called your config file
  113. something besides birthday.cfg, you'd type that in instead.
  114.  
  115.         This will make a screen or bulletin for the current month and
  116. then edit the config file to reflect the next month.
  117.  
  118.         Now put an entry in your daily maintenance batchfile something
  119. like this:
  120.  
  121. cd c:\tribbs\birthday           <--- change to BIRTHDAY's directory
  122. birthday birthday.cfg           <--- the command line
  123.  
  124. {more batch stuff}              <--- continue with your daily .bat
  125.  
  126.         That's it!  When the daily .bat is run, BIRTHDAY GREETER will
  127. check to see what the current month is.  If it doesn't match what's in
  128. the .cfg file it will simply print "Screen already produced for this
  129. month" and quit, returning control to your batchfile.  So if you start
  130. it up in mid-January for instance, it won't make a new screen or
  131. bulletin until your daily .bat runs on February 1st.
  132.  
  133.         If you want to do both a screen and a bulletin, you make one
  134. config file for each and then the .bat's entry would say something like:
  135.  
  136. cd c:\tribbs\birthday
  137. birthday bday1.cfg
  138. birthday bday2.cfg
  139.  
  140. {more batch stuff}
  141.  
  142.                     -=*So... what does this cost?*=-
  143.  
  144.         Nothing.  I'm releasing this program as FreeWare to all
  145. registered TriBBS sysops.  Enjoy!
  146.  
  147.                              -=*Support*=-
  148.  
  149.         Since it is FreeWare, I'm not going to spend an inordinate
  150. amount of time on support.  If you discover a bug, or if you have some
  151. trouble installing it, you may send me a letter (include an S.A.S.E.
  152. please) and I will do my best to fix the problem.  My address is:
  153.  
  154.                             Mark Alan Pruitt
  155.                             c/o Studio, Eh? Productions
  156.                             2318 - 2nd Ave  #337-A
  157.                             Seattle, WA  98121
  158.  
  159.         I have written (and am writing) a number of programs, both Free
  160. and ShareWare, for BBS's and general computing use.  Sending a disk
  161. (720k minimum) and a pre-paid mailer will get you a copy of all the
  162. latest versions of my programs.
  163.  
  164.                         -=*A quick tech note*=-
  165.  
  166.         The executable has been compressed using Tinyprog (free plug...
  167. Tinyprog is an EXCELLENT and inexpensive program... you other programmer
  168. types should look into it... and no... I didn't write it! :) ) so that
  169. while it only takes up 28592 bytes on your hard drive it's load image
  170. (how much RAM it needs) is 35562 bytes.
  171.  
  172.         Happy computing!!!
  173.  
  174. Mark Alan Pruitt
  175. Seattle, WA
  176. November 16, 1993
  177.