home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / BDAY115.ZIP / BIRTHDAY.DOC < prev    next >
Text File  |  1994-01-10  |  14KB  |  303 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │─═══════────══──═══════──══════════──══────══──═══════──────════───══────══─│
  3. │─══────══───══──══────══─────══──────══────══──══────══────══──══───══──══──│
  4. │─══────══───══──══────══─────══──────══────══──══─────══──══────══───════───│
  5. │─════════───══──═══════──────══──────════════──══─────══──════════────══────│
  6. │─══─────══──══──══───══──────══──────══────══──══─────══──══────══────══────│
  7. │─══─────══──══──══────══─────══──────══────══──══────══───══────══────══────│
  8. │─════════───══──══────══─────══──────══────══──═══════────══────══────══────│
  9. │                                                                            │
  10. │                               Birthday v1.15                               │
  11. │                    Copyright (c) 1992-1994 by Cris McRae                   │
  12. │                            All Rights Reserved                             │
  13. │                                                                            │
  14. │                        A Birthday List Generator for                       │
  15. │                           WWIV v4.22+ BBS Systems                          │
  16. │                                                                            │
  17. └────────────────────────────────────────────────────────────────────────────┘
  18.  
  19. ┌────────────────────────────────────────────────────────────────────────────┐
  20. │░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  21. └────────────────────────────────────────────────────────────────────────────┘
  22.  
  23. What is Birthday v1.15?  It is a program written for WWIV v4.22+ BBS systems,
  24. and it generates a listing of users with birthdays on the current date, the
  25. the day before, and the day after.  Here is a sample file output:
  26.  
  27.            Birthday v1.15 [Unregistered] (c) 1992-1994 by Cris McRae
  28.                          Birthday Listing for 09/18/93
  29.  
  30.         YESTERDAY                    TODAY                    TOMORROW
  31. ─────────────────────────  ─────────────────────────  ─────────────────────────
  32.                            JAFO                       The Painter
  33.                            Phantom Of The Opera       De Bug
  34.                            Pix
  35.                            Iceman
  36.  
  37. I changed my system date to my birthday to generate the above listing.  It is
  38. nice to know who has the same birthday as you.  Generally, you run it once a
  39. day in your daily event batch file.
  40.  
  41. Birthday also supports the TODAY.xxx data files which are widely available.
  42. If you have these files, and wish to have them included in the Birthday lists,
  43. Birthday will print out all celebrity birthdays for the current date.
  44.  
  45. Birthday can be used to generate lists for your G-files area, but beginning
  46. with Birthday v1.10, it can also be used as a logon event.  If a user happens
  47. to log onto the BBS on their birthday, a nice Happy Birthday message is
  48. printed out to them.  You may edit the BDAY.* files to display any message you
  49. like, as long as they use WWIV ANSI codes.  The BDAY.* files must go in the
  50. same directory where the BIRTHDAY.EXE is located.
  51.  
  52. Birthday can give users extra file points on their birthday, as a gift from
  53. the BBS sysop.
  54.  
  55. ┌────────────────────────────────────────────────────────────────────────────┐
  56. │░░░░ PROGRAM AUTHENTICITY ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  57. └────────────────────────────────────────────────────────────────────────────┘
  58.  
  59. Birthday has been archived with PKWARE's PKZIP 2.04g using Authenticity
  60. Verification.  When you unzip the archive, you should see "-AV" displayed
  61. after every file name.  When completed, a message that looks like this will
  62. be displayed:
  63.  
  64. Authentic files Verified!   # KRK282
  65. Cris McRae
  66.  
  67. If this authenticity statement is not displayed, or the authenticity code is
  68. not "KRK282", then you have a copy of Birthday that has been tampered with.
  69. Do >not< use any of the files contained within a tampered archive, as they
  70. may contain viruses, trojans, or other harmful things.
  71.  
  72. Birthday has also been encrypted by a powerful encryption program.  If the
  73. executable file is tampered with, it will display a CRC warning and will not
  74. run.
  75.  
  76. ┌────────────────────────────────────────────────────────────────────────────┐
  77. │░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  78. └────────────────────────────────────────────────────────────────────────────┘
  79.  
  80. To install Birthday v1.15, you must unzip BDAY115.ZIP to your main WWIV BBS
  81. directory.  Here is what should be included in the archive:
  82.  
  83.     BIRTHDAY.CFG - Birthday v1.15 configuration file
  84.     BIRTHDAY.DOC - Birthday v1.15 documentation file
  85.     BIRTHDAY.EXE - Birthday v1.15 executable file
  86.     BDAY    .ANS - Birthday v1.15 Happy Birthday ANSI file
  87.     BDAY    .MSG - Birthday v1.15 Happy Birthday ASCII file
  88.     REGISTER.TXT - Birthday v1.15 registration form
  89.     TODAY   .LCL - Sample TODAY.LCL file
  90.     FILE_ID .DIZ - File description
  91.  
  92. ══[ CONFIGURATION FILE SETUP ]════════════════════════════════════════════════
  93.  
  94. NOTE:  The length of this file has changed in v1.15, so you MUST use the new
  95.        version of the BIRTHDAY.CFG file.
  96.  
  97. Before you run BIRTHDAY.EXE, you must edit BIRTHDAY.CFG to suit your needs.
  98. Here is what to put in the file:
  99.  
  100.     Line  1: C:\WWIV\GFILES    ; Path for your ASCII Birthday list.  If you
  101.                                ; don't want to generate this file, put NONE.
  102.     Line  2: C:\WWIV\GFILES    ; Path for your ANSI Birthday list.  If you
  103.                                ; don't want to generate this file, put NONE.
  104.     Line  3: C:\WWIV\GFILES    ; Path for your "TODAY.xxx" files.  If you
  105.                                ; don't want to use these files, put NONE.
  106.     Line  4: 3                 ; Color for Birthday copyright notice (0-9)
  107.     Line  5: 2                 ; Color for Birthday Listing Date (0-9)
  108.     Line  6: 5                 ; Color for YESTERDAY, TODAY, & TOMORROW (0-9)
  109.     Line  7: 7                 ; Color for separator lines (0-9)
  110.     Line  8: 1                 ; Color for user names (0-9)
  111.     Line  9: 2                 ; Color for "Celebrities born..." line (0-9)
  112.     Line 10: 1                 ; Color for celebrity names (0-9)
  113.     Line 11: Y                 ; For logon event.  Do you want to clear the
  114.                                ; screen before displaying Birthday list?
  115.     Line 12: Y                 ; For logon event.  Do you want to pause the
  116.                                ; screen after Birthday list is displayed?
  117.     Line 13: Y                 ; For logon event.  Allow users to abort the
  118.                                ; displaying of the Birthday list?
  119.     Line 14: N                 ; Display "No User Birthdays" in Birthday list
  120.                                ; if there are no birthdays for all three days?
  121.     Line 15: N                 ; For logon event.  Do you want the Birthday
  122.                                ; list displayed if there are no birthdays?
  123.                                ; This option is useless if you use the
  124.                                ; TODAY.xxx files.
  125.     Line 16: N                 ; Add user number after user name in Birthday
  126.                                ; listings?
  127.  
  128. Notice the filename is not specified in lines 1 and 2.  The filenames for the
  129. Birthday lists will be BIRTHDAY.MSG and BIRTHDAY.ANS.
  130.  
  131. Please remember that EACH line must have something on it.
  132.  
  133. Also note that if you are using WWIV v4.22, colors 8 and 9 won't be available
  134. unless you have modified your source.  They are available in WWIV v4.23.
  135.  
  136. ══[ THE TODAY.LCL FILE ]══════════════════════════════════════════════════════
  137.  
  138. To customize your display with information of particular interest to your BBS
  139. or immediate area, Birthday will scan for the presence of a file called
  140. TODAY.LCL and include appropriate lines from it if it's found.
  141.  
  142. I have included a sample LOCAL.LCL file with a few birthdays in it.  If you
  143. wish, put this file in your GFILES directory.  The format for the LOCAL.LCL
  144. file is:
  145.  
  146. Column 1  :  Must be a 'B'.
  147. Cols 2-5  :  Month and day as MMDD with leading zeros.
  148. Cols 6-9  :  The full year of the event as four digits.
  149. Column 10 :  A space.
  150. Cols 11-80:  The message to display for this date.
  151.  
  152.                                  -= EXAMPLES =-
  153.  
  154. *mmddyyyy Birthdays
  155. *-------- --------------------------------------------------------------------
  156. B09011875 Edgar Rice Burroughs, novelist
  157. B09021838 Queen Liliuokalani (last queen of Hawaii).
  158. B09021952 Jimmy Connors, tennis star
  159.  
  160. ══[ DAILY EVENT SETUP ]═══════════════════════════════════════════════════════
  161.  
  162. Once you have edited the BIRTHDAY.CFG file, put "BIRTHDAY.EXE" in your daily
  163. event batch file so it can be processed nightly.
  164.  
  165. ══[ LOGON EVENT SETUP ]═══════════════════════════════════════════════════════
  166.  
  167. If you would like to run Birthday as a logon event, so that your Birthday
  168. lists can be viewed by your users, put "BIRTHDAY.EXE L" in your logon event
  169. batch file, or simply put that line in INIT if you have no other logon events.
  170.  
  171. If you don't currently have a logon event, and want Birthday to automatically
  172. configure INIT to run Birthday at the logon event, type:
  173.  
  174.   BIRTHDAY INSTALL
  175.  
  176. That will add "BIRTHDAY.EXE L" (including full path to the EXE) to INIT.
  177.  
  178. If you use the logon event feature, the BDAY.* files must be place in your
  179. main BBS directory (same directory as your EXE).
  180.  
  181. ══[ CHAIN SETUP ]═════════════════════════════════════════════════════════════
  182.  
  183. If you would like to run Birthday as a chain, use the following setup:
  184.  
  185.     A. Description  : Birthday Listings
  186.     B. Filename     : BIRTHDAY.EXE L
  187.     E. ANSI         : Optional
  188.     F. DOS Interrupt: Used
  189.     H. Shrink       : No
  190.     I. Disable pause: No
  191.     J. Local only   : No
  192.  
  193. ┌────────────────────────────────────────────────────────────────────────────┐
  194. │░░░░ REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  195. └────────────────────────────────────────────────────────────────────────────┘
  196.  
  197. Birthday is shareware.  This gives the user an opportunity to evaluate the
  198. program before actually registering the software.  If, after a 30 day period,
  199. you wish to continue to use Birthday, you are required to register your copy
  200. of Birthday with the author.  To register, please fill out REGISTER.TXT and
  201. send it to:
  202.  
  203.     Cris McRae
  204.     P.O. Box 1351
  205.     Burbank, CA  91507
  206.  
  207. Registration is $5.00 US per copy of Birthday.
  208.  
  209. Note:  Registration system used is REGKEY.
  210.  
  211. ┌────────────────────────────────────────────────────────────────────────────┐
  212. │░░░░ REVISIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  213. └────────────────────────────────────────────────────────────────────────────┘
  214.  
  215. Version 1.00 (11/01/92)
  216.   ■ Initial release
  217.  
  218. Version 1.01 (11/06/92)
  219.   ■ Fixed color bug
  220.   ■ Changed ASCII output file to BIRTHDAY.MSG for WWIV printfile
  221.     compatibility
  222.   ■ Optimized C code a little
  223.  
  224. Version 1.02 (01/23/93)
  225.   ■ Compiled with WWIV v4.22 userrec format
  226.   ■ Program display updated to implement direct screen writes
  227.   ■ DESQview aware - direct screen writes are turned off under DESQview
  228.  
  229. Version 1.10 (06/10/93)
  230.   ■ Added color configurability
  231.   ■ Added logon event capability
  232.   ■ Added TODAY.xxx support
  233.   ■ Added small registration fee
  234.  
  235. Version 1.11 (06/26/93)
  236.   ■ Fixed color bug (evident when using color 4)
  237.   ■ Added logon event install feature
  238.  
  239. Version 1.12 (09/08/93)
  240.   ■ WWIV v4.23 multi-instance compatible
  241.     (Thanks to Jim Wire)
  242.   ■ Fixed bug where names >24 characters messed up display
  243.   ■ Added logon event ability to print Happy Birthday message to user when
  244.     they logon the day of their birthday
  245.   ■ Added configurable ability to add user numbers after user names in listing
  246.  
  247. Version 1.13 (12/01/93)
  248.   ■ Changed the WWIV v4.23 multi-instance code.  Now uses Wayne Bell's
  249.     file sharing disk I/O routines.
  250.   ■ Added ability to give gold to users on their birthday.
  251.   ■ Added ability to give filepoints to users on their birthday.
  252.   ■ Added ability to give extra time to users on their birthday.  They must
  253.     log on the day of their birthday to get the time.  The extra time is only
  254.     given on their FIRST logon of that day.  This is for WWIV v4.23 users
  255.     only.
  256.  
  257. Version 1.14 (12/18/93)
  258.   ■ Due to unknown causes, the gold, file points, and extra time features
  259.     caused certain systems to lock up.  These features have been removed.
  260.     It is uncertain whether they will be added later or not.
  261.  
  262. Version 1.15 (01/10/94)
  263.   ■ Fixed alignment problem in celebrity birthday listings
  264.   ■ Fixed halting problem during logon event.  Previous v4.23 compatible
  265.     versions opened the USER.LST and kept it open when it was not necessary,
  266.     causing other instances to halt until Birthday was done printing the
  267.     birthday list.  This has been fixed.
  268.   ■ Fixed user screen height problem.  Instead of using the user's screen
  269.     height, prior versions used the BBS's screen height to determine the
  270.     number of lines to print before displaying [PAUSE] during the logon
  271.     event.
  272.  
  273. ┌────────────────────────────────────────────────────────────────────────────┐
  274. │░░░░ CREDITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  275. └────────────────────────────────────────────────────────────────────────────┘
  276.  
  277. Birthday v1.15 Copyright (c) 1992-1994 by Cris McRae
  278. WWIV is Copyright (c) 1988-1994 by Wayne Bell
  279. PKZIP is Copyright (c) 1989-1994 by PKWARE Inc.
  280. REGKEY is Copyright (c) 1992 by Brian Pirie
  281.  
  282. If you have any comments or questions about this program, you can reach me
  283. at the following network addresses:
  284.  
  285.     TerraNET : 1@1
  286.     WWIVnet  : 1@8861
  287.     IceNET   : 1@8857
  288.     SOLARnet : 1@8857
  289.     TARDISNet: 1@8857
  290.     WWIVLink : 1@18857
  291.     Internet : cris.mcrae@panasia.com
  292.  
  293. If you are a sysop on one of the above WWIV networks, you may also subscribe
  294. to my support sub.  The sub name is "JAFO's Software Support".  The sub type
  295. is JAFOSUP.
  296.  
  297. You may also call my BBS system:
  298.  
  299.                               Blue Thunder BBS
  300.                          USR 16.8 HST Dual Standard
  301.                                Open 24 Hours
  302.                                (818)848-4101
  303.