home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / HBBS40.ZIP / HOLIBBS.DOC < prev    next >
Text File  |  1994-04-02  |  8KB  |  177 lines
  1.  
  2.                           Welcome to HoliBBS v4.0
  3.                      The Days till Holiday screen maker.
  4.  
  5.                          Written by:  Robert Fonner
  6.                    Copyright (c)1994 Vämpire Technologies
  7.                        Dracula's Castle (305)964-2696
  8.                           V32bis/V42bis/14,400bps
  9.                               FidoNet 1:369/24
  10.                InterNet Robert.Fonner@f24.n369.z1.fidonet.org
  11.  
  12.  
  13.    ╒══════════════════════════════════════════════════════════════════════╕
  14.    │  VAMPIRE TECHNOLOGIES has developed this program for your benefit.   │
  15.    │  Although many precautions have been taken to ensure that it will    │
  16.    │  not damage your equipment,(hardware, or software), in any way;      │
  17.    │  no promises, guarantees, or warrantees are offered or implied.      │
  18.    │  Use of this program constitutes agreement with these terms. You     │
  19.    │  are hereby granted license to use this program as you see fit,      │
  20.    │  but ownership is retained by Vämpire Technologies as per copyright  │
  21.    │  laws effective in the state of Florida.  Some states do not         │
  22.    │  recognize retained ownership, in which case no license is offered.  │
  23.    │  In those states, and/or provinces where disclaimers such as this    │
  24.    │  are not held valid, this program is not to be used or retained.     │
  25.    ╘══════════════════════════════════════════════════════════════════════╛
  26.  
  27.  
  28. HOLIBBS is a program that was originally written for WildCat! 3.x SysOps
  29. to create a Bulletin/Hello screen to show how many days are left until
  30. any Holiday.  On a specific Holiday the screen will change to a nice
  31. ansi screen denoting that particular holiday.  It has now been adapted to
  32. run with almost any BBS software (PCBoard/RA/SuperBBS/Opus/WildCat!/Etc.).
  33. This program is not crippled in any way.  However it does expire on January
  34. 1st, 2001.
  35.  
  36. NEW FOR 3.0 - We've now added the ability to include up to 13 user definable
  37. events.  You will have to make the ANSI/ASCII/RIP screens for these events,
  38. or get them from your favorite ANSI screen developer.  If you prefer, you
  39. can call Dracula's Castle and download ANSI.ZIP (which contains 121 ANSI
  40. screens for you to play with).  These 13 new events will take precedent over
  41. any other holiday screen.  If you choose to have a custom event on December
  42. 25th, the CHRISTMAS screen will not be written.
  43.  
  44. ┌─────────────────────────────────────────────────────────────────────────┐
  45. │                                                                         │
  46. │ This file is SHAREWARE.  If you decide you like it and wish to continue │
  47. │ using it after 30 days, you are required to register this program by    │
  48. │ sending your check or money order along with a copy of the completed    │
  49. │ REGISTER.FRM to:                                                        │
  50. │                                                                         │
  51. │                               Robert C. Fonner, Jr.                     │
  52. │                               7760 Atlanta Street                       │
  53. │                               Hollywood, FL  33024-2510                 │
  54. │                                                                         │
  55. └─────────────────────────────────────────────────────────────────────────┘
  56.  
  57. REQUIREMENTS
  58. ------------
  59.         DOS 3.x or better.
  60.         BRUN45.EXE (Not included but available on most BBSes).
  61.         PC XT/AT or Compatible
  62.  
  63. SETUP
  64. -----
  65.         HOLIBBS.EXE and HOLIBBS.CFG must reside in the same directory.
  66.         All other files included in this distribution may be in any
  67.         directory you like.  Unzip the SCREENS.ZIP into any directory
  68.         you choose.
  69.  
  70.         The HOLIBBS.KEY file MUST NOT be changed unless you are
  71.         a registered licensee.  Putzing with this KEY file will
  72.         invalidate UNREGISTERED versions.  The KEY file must reside
  73.         in the same directory as the sample screen files.
  74.  
  75.         Use your favorite text editor to edit the enclosed sample
  76.         HOLIBBS.CFG file.  Below is the sample config with instructions
  77.         for each line.
  78. Line
  79. ----
  80.  1   C:\WC30\HOLIBBS\           Path to the sample screen files.
  81.  2   C:\WC30\DISP\HELLO9.RIP    Path & Name of the RIP output file (or NONE).
  82.  3   C:\WC30\DISP\HELLO9.SCR    Path & Name of the ANSI output file.
  83.  4   C:\WC30\DISP\HELLO9.BBS    Path & Name of the ASCII output file.
  84.  5   @PAUSE@                    Command your BBS uses to PAUSE displays.
  85.  6   BDAY1                      Custom Display file (without extension).
  86.  7   DATE                       Date for Custom display #1.
  87.  8   BDAY2                      Another custom display file.
  88.  9   DATE                       Another Date for Custom display #2.
  89. 10   BDAY3                      And so on......
  90. 11   DATE
  91. 12   BDAY4
  92. 13   DATE
  93. 14   ANNIV1
  94. 15   DATE
  95. 16   ANNIV2
  96. 17   DATE
  97. 18   ANNIV3
  98. 19   DATE
  99. 20   HDAY1
  100. 21   DATE
  101. 22   HDAY2
  102. 23   DATE
  103. 24   HDAY3
  104. 25   DATE
  105. 26   HDAY4
  106. 27   DATE
  107. 28   HDAY5
  108. 29   DATE
  109. 30   HDAY6
  110. 31   DATE
  111.  
  112. *** NOTE:  All 31 lines MUST exist or the program will NOT run AND may
  113.            hang your system until a human keystroke is made.
  114.  
  115.         Line 1 of the config file will be the path to the sample .ANS,
  116.         .ASC, .RIP screens (and all other files included in this package
  117.         IF different from where you put HOLIBBS.EXE & HOLIBBS.CFG).
  118.  
  119.         Lines 2 thru 4 will be the drive, path, and filename of the output
  120.         files you want to create for your users to see (Usually NEWSx.ANS/
  121.         ASC or HELLOx.SCR/BBS).  Line 2 is the RIP file, Line 3 is the
  122.         ANSI file & line 4 is the ASCII file.  If you do not support RIP
  123.         graphics, then the word NONE must be on line 2.
  124.  
  125.         Line 5 is the command YOUR BBS uses to pause display files so users
  126.         can see them before they scroll off the screen.  For example
  127.         WildCat! 2.x uses  (^P), WildCat! 3.x uses @PAUSE@, PCBoard uses
  128.         @WAIT@.  Check your BBS manual for the characters/command you need
  129.         to use.  You can leave this line blank if you do not wish to add a
  130.         pause command to the end of the display screens.
  131.  
  132.         Lines 6-31 are for customizing events you wish to include that
  133.         HOLIBBS doesn't.  The EVEN numbered lines (6, 8, 10, etc.) are for
  134.         filenames of .ANS/.ASC files you created for a particular event
  135.         (WITHOUT the extensions of .ANS/.ASC).  The ODD numbered lines
  136.         (7, 9, 11, etc.) are the dates the event immediately above is
  137.         to occur.  For example line 6 is BDAY1 (the name of an included
  138.         sample file), Line 7 says 11/03 (My birthday).  On 11/03 of every
  139.         year the sample screens BDAY1.ANS & BDAY1.ASC will be used instead
  140.         of the countdown screen (and more importantly, it will override
  141.         any other holiday that might occur on that date).  There are 13
  142.         possible CUSTOMIZED events, with 13 possible CUSTOMIZED dates.
  143.  
  144.         The names BDAY1, BDAY2, ANNIV1... etc. are just examples.  You may
  145.         name the custom files you create any valid DOS filename.  However
  146.         the extensions must be .ANS & .ASC (where ANS is ANSI, and ASC is
  147.         ASCII).
  148.  
  149.         IMPORTANT:  The format for customizable dates must be in 4 digit
  150.         format.  For example March 3rd, would be 03/03.  Do NOT include
  151.         a YEAR (03/03/93).  The "/" in 03/03 can be excluded or included,
  152.         it makes no difference to the way the program runs.
  153.  
  154.         If NO actual DATE is given on the customizable date lines, and the
  155.         line for a DATE remains as the word DATE, then nothing will happen.
  156.  
  157.         Unzip SCREENS.ZIP into the directory you listed on line one of
  158.         your HOLIBBS.CFG file.
  159.  
  160.         NEXT - Add two lines to your nightly event batch file.  This is the
  161.         file most BBSes run at midnight.
  162.  
  163.         Example:  CD\BBS\HOLIBBS    <=== Where HOLIBBS.EXE/CFG/KEY are.
  164.                   HOLIBBS
  165.  
  166.         That's all there is to it.
  167.  
  168.  
  169. NOTE
  170. ----
  171.         The enclosed sample ANS/ASC/RIP files may be changed to suit
  172.         your particular BBS needs.  However, the filenames must remain
  173.         exactly the same.
  174.  
  175. Vämpire Technologies claims no rights to the sample ANSI or RIP screens
  176. included in this package.
  177.