DP Tool Club 8

home *** CD-ROM | disk | FTP | other *** search

/ DP Tool Club 8 / CDASC08.ISO / VRAC / HOLID200.ZIP / HOLIDAYS.DOC < prev next >

Wrap

Text File | 1993-06-23 | 18.2 KB | 369 lines

T&T Software Holidays V2.00 (c) Copyright 1993 for Spitfire and Wildcat BBS's ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holidays V2.00 Overview & Instructions ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ ═ Overview ═ Holidays is a program designed for Sysops who would like to display special screens to their users on different holidays and/or special days. It is also made for Sysops, like me, who do not have the time to switch the screens manually! This program currently supports Spitfire and Wildcat, if you would like to see this work for your BBS package please send all the Ansi and Ascii screen info we would need to Tim's House of Fun BBS. The BBS's number is listed at the end of this document. To date Holidays will determine on what days it should make a screen for the following holidays and special days: Holiday/Special Day.............Date(s) ======================================================= April Fool's Day................April 1st. Aviation Day....................August 19th. BBS's Birthday..................You Set In Config File! Christmas Day...................December 25th. Christmas Eve...................December 24th. Columbus Day....................2nd Monday in October. Days Before Christmas...........0-366 days. Earth Day.......................April 22nd. Easter..........................March 22nd - April 25th. Father's Day....................3rd Sunday in June. Flag Day........................June 14th. Fourth of July..................July 4th. Groundhog Day...................February 2nd. Halloween.......................October 31st. Labor Day.......................1st Monday in September. Lincoln's Birthday..............February 12th. Martin Luther King Day..........3rd Monday in January. Memorial Day....................Last Monday in May. Mother's Day....................2nd Sunday in May. New Years.......................January 1st. President's Day.................3rd Monday of February. St. Patrick's Day...............March 17th. Thanksgiving....................4th Thursday of November. Valentines Day..................February 14th. Veteran's Day...................November 11th. Washington's Birthday...........February 22nd. ** Note: Days Before Christmas has two screens, one will show up on even days and the other will display on odd days. ═ Instructions ═ Put Holidays in its own directory somewhere and run it from that directory as shown below. A log file will be created in whichever directory the program is run. To run Holidays 1 command line parameter is needed! Here is an example of the batch file We use on Tim's House Of Fun BBS (a Spitfire BBS): IT MUST BE RUN FROM ITS OWN DIRECTORY AND YOU MUST CHANGE DIRECTORIES TO THAT DIRECTORY... THE PROGRAM LOOKS FOR FILES IN THE CURRENT DIRECTORY AND IF IT DOES NOT FIND THEM THE SCREENS WILL NOT BE MADE!!!! cd\sf\holidays holidays holidays.cfg cd\sf ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holidays V2.00 Configuration File ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ To create just type holidcfg.exe filename.ext (for the default name of Holidays.cfg just leave off the filename!). HOLIDAYS.CFG -- Spitfire Configuration File -------------------------------------------- LINE 1: C:\SF\DISPLAY\ - Path Of Display Files (NEEDS "\" on end!!) LINE 2: WELCOME2 - Filename (Without Extension) LINE 3: CLR - Ansi File Extension. LINE 4: BBS - Ascii File Extension. LINE 5: 100 - Number Of Days to Create Days B4 Christmas Screens. LINE 6: 4 - Month Easter Falls on (Current Year). LINE 7: 11 - Day Easter Falls on (Current Year). LINE 8: S - Type Of BBS (Spitfire). LINE 9: 12 - Month BBS Was Started. LINE 10: 1 - Day BBS Was Started. LINE 11: 1991 - Year BBS Was Started. LINE 12: **** MUST BE BLANK ****. To run Holidays on Wildcat 3.x BBS's just replace LINE 3 with NOT in all caps to just get one screen with the Wildcat 3.x codes, see below! ** Special note for Wildcat BBS users ** For Wildcat only one screen is made with the Wildcat @ codes so you must not set LINE #2 equal to "not" but LINE #3 must be "not"!! WCHOLID.CFG -- Wildcat Configuration File ----------------------------------------- LINE 1: C:\BBS\DISPLAY\ - Path of Display Files (NEEDS "\" on end!!). LINE 2: HELLO2 - Filename (Without Extension). LINE 3: CLR - File Extension. LINE 4: NOT - Wildcat only creates the ONE FILE (THIS MUST BE NOT). LINE 5: 100 - Number Of Days to Create Days B4 Christmas Screens. LINE 6: 4 - Month Easter Falls on (Current Year). LINE 7: 11 - Day Easter Falls on (Current Year). LINE 8: W - Type Of BBS (Wildcat). LINE 9: 12 - Month BBS Was Started. LINE 10: 1 - Day BBS Was Started. LINE 11: 1991 - Year BBS Was Started. LINE 12: **** MUST BE BLANK ****. = Explanation of Lines = Line #1 is the full path of the display file(s) you want created **** DO NOT include the extension or filename in this Line **** **** The final "\" MUST be present on this line!!!! *********** Line #2 is the filename for the display files to be created. It may be a valid DOS name (Without extension). Line #3 is the file extension for the Ansi Screen or "not" if you do not wish to have an ansi screen created. This must be 3 characters. Line #4 is the same as Line #2 except this is for the Ascii screen! Line #5 is used to tell the program how many days before Christmas you would like screens to be made! If you have this Line set to a day that another holiday should fall then the program will make a screen for that holiday instead of the days before Christmas screen. This may be a number 0-366. Line #6 is the month in which Easter will fall for the current year! This can be either a 3 or 4 for March or April. Line #7 is the day that Easter will fall on in the current year! This can only be a number 1-31. Line #8 is the BBS type...right now it only supports Spitfire and Wildcat! [W]ildcat 3.x [S]pitfire 3.x Line #9 is the Month that the BBS was first Started, any number from 1-99. Line #10 is the Day that the BBS was first Started, any number from 1-99. Line #11 is the Year that the BBS was first Started, any four numbers. Line #12 MUST BE A BLANK LINE!!! ** Lines 9-11 may be set to 9's if you do not wish to create the BBS Birthday screens. (99-99-9999 will not be able to match any date! Or you may also just delete Birthday.exe!) *** SPECIAL NOTE ************************************************************ * * * On days that there are no holidays if the screens exist from another * * Holiday, then the screens are deleted and a note is left in holidays.log. * * * ***************************************************************************** = What's in Holidays.log = Holidays.log is created at runtime if an error has ocurred. This file will also contain informational messages about what the program has done. If no screen is made on a certain day it tells you how many days are left before the days before christmas screens start to display. This file will also tell you if any files have been deleted. ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holiday Necessary Files ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Your Holid200.arj file should contain the following files: Holidays.exe -> The Executable File Holidcfg.exe -> Creates the Configuration File For You Newyears.exe -> Called by Holidays (Creates New Years Screen) Valday.exe -> Called by Holidays (Creates Valentines Day Screen) Vetsday.exe -> Called by Holidays (Creates Veterans Day Screen) Hallowen.exe -> Called by Holidays (Creates Halloween Day Screen) Easter.exe -> Called by Holidays (Creates Easter Screen) Foolsday.exe -> Called by Holidays (Creates April Fool's Day Screen) Stpats.exe -> Called by Holidays (Creates St. Patricks Day Screen) July4th.exe -> Called by Holidays (Creates 4th of July Screen) Thanks.exe -> Called by Holidays (Creates Thanksgiving Screen) Fathday.exe -> Called by Holidays (Creates Father's Day Screen) Martinlk.exe -> Called by Holidays (Creates Martin Luther King Day Screen) Laborday.exe -> Called by Holidays (Creates Labor Day Screen) Mothday.exe -> Called by Holidays (Creates Mother's Day Screen) Presday.exe -> Called by Holidays (Creates President's Day Screen) Flagday.exe -> Called by Holidays (Creates Flag Day Screen) Lincolns.exe -> Called by Holidays (Creates Lincoln's Birthday Screen) Hogday.exe -> Called by Holidays (Creates Groundhog Day Screen) Aviation.exe -> Called by Holidays (Creates Aviation Day Screen) Earth.exe -> Called by Holidays (Creates Earth Day Screen) Columbus.exe -> Called by Holidays (Creates Columbus Day Screen) Washingt.exe -> Called by Holidays (Creates Washington Birthday Screen) Memorial.exe -> Called by Holidays (Creates Memorial Day Screen) Birthday.exe -> Called by Holidays (Creates BBS's Birthday Screen) Holidays.doc -> This Document File Register.txt -> Registration Form File_id.diz -> Short Program Description Holidays.log -> Created at runtime (May be deleted at anytime!) Holidays.cfg -> Example Spitfire Configuration File. Wcholid.cfg -> Example Wildcat Configuration File. ** NOTE ** If one of the executables that are called by Holidays.exe is not found in the same directory as Holidays.exe then the screen for that holiday will not be made and a note will be written to the Holidays.log file! ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holidays Registration Information ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Registration of Holiday reflects the concept of Shareware. Although you may use the unregistered version for as long as you wish, you must register it to unlock the features listed below! $5.00, we feel is a great price for this program! If you would like to send more, then feel free too! Registration brings you: Your own personally compiled copy with the [U N R E G I S T E R E D] replaced with your name or your BBS's name on the display screens that are created! The "Press Any Key to Continue" is also removed so the program can then be run as a nightly event. ══════════ Please use the File "Register.txt" for Registration ═══════════ ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holidays V2.00 Credits and Many Thanks ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ Most of the screens that are recreated by Holidays V2.00, came from many different sources. Some that are known are listed below: Ansi Antics -- Kieth Emmons. The two days before Christmas Screens were originally created by Daysb4.exe V1.3 by Parole Software, Dennis Maidon. They were changed a little and adapted for use with Spitfire codes. We really liked Dennis's program but it gave us some problems with Spitfire codes and we wanted more options. We also wanted one that displayed screens for other holidays! Another words a special thanks to Dennis whose program led me to create this program. Also thanks to Janet Ludwig whom also made some of the screens that Holidays V2.00 recreates! Without the Ansi artists this program would not exist because I found out that I can not create a good ansi screen. All efforts have been made to leave the ansi artists name on the screens they created, although some came without names on them. A special thanks to Mike Reshetar of The Old Timer's BBS for his help with the screens and Wildcat Ansi codes. You may also download the newest version from his BBS. You may also get in touch with me there just post a message for Tim Ward. You can reach The Old Timer's at (301) xxx-xxxx. Also thanks to Cliff Ayers, of BLOOM II <Bill's Revenge>, who gave suggestions for more holidays, most of which were included in version 2.00. If you would like to have screens that you have made incorporated into this program or if you would personally like to see something changed you may write to the address listed below or call the Support BBS listed below! Full support will be given on Tim's House Of Fun BBS, please call we would like to hear any concerns or comments! Of course, thanks to Mike Woltz of Buffalo Creek Software who had/has the talent to create and maintain a bbs package as great as Spitfire! All screens are copyrighted by their authors and not T&T Software, the only changes made to the screens were: 1. Added BBSNAME to each screen. 2. Changed Control Characters that conflicted with Spitfire. 3. Made to fit on one screen. 4. Added that Holidays re-created the screens. Spitfire is copyrighted by Mike Woltz. Wildcat is copyrighted by Mustang Software. Although Holidays is copyright by T&T Software, they make no claims to ownership or copyright of the screens as we did not create the screens, just the program to RE-CREATE them on the proper days!!! ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holidays Warranty and Disclaimer ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ = Warranty = This product is provided "as is" without warranty of any kind. The entire risk as to the results and performance of the program is assumed by you. Futhermore, we the authors do not warrant, guarantee, or make any represent- tions regarding the use of, or the results of the use of the program, and you rely on the program and results solely at your own risk. We the authors cannot accept responsibility for system damage, either directly or indirectly from the use of this product. = Disclaimer = The Authors of this program, Tim's House Of Fun BBS and its Co-sysops are in no way responsible for any damages sustained either directly or indirectly from the use of Holidays. Also if the file has been modified in any way we will take no responsibility for it's use Whatsoever! The .EXE file has been tested on several machines, from XT's to 486's and worked perfectly on all. If you should have any problems with this file please call Tim's House Of Fun BBS to obtain a good copy. Please forward any comments or suggestions to: Timothy J. Ward or Tim's House Of Fun BBS 398 Trefoil Place Waldorf, MD Waldorf, MD 20601 (301) 705-7115 300-14.4bps (v.32bis) CircuitNET ID: 301000 ╔════════════════════════════════════════════════════════════════════════╗ ║ ■ Holidays History Of Changes ■ ║ ╚════════════════════════════════════════════════════════════════════════╝ ========================================================================= Version # | Changes | Release Date | ========================================================================= 1.00 | Initial Release | 03-11-93 | ------------------------------------------------------------------------- 2.00 | 1. Changed from 8 Command Line Parameters | 06-23-93 | | to one (Configuration File!) | | | 2. Added Memorial Day (Screen will be | | | produced on Monday May 25-31) | | | 3. Changed Thanksgiving Screen will now | | | now be produced on Thursday November, | | | 22-28 vice 21-27. | | | 4. Added Father's, Mother's, Labor, Martin | | | Luther King, President's, Flag, | | | Lincoln's, Groundhog, Aviation, | | | Earth, Washington's, April Fool's, | | | and Columbus Days to the program! | | | 5. Added Some More Error Checking! | | | 6. Fixed Control Character Problem with | | | Spitfire Easter Screen found in some | | | Version 1.00 programs! | | | 7. Removed Leap Year from the configuration| | | file as the program now figures in all | | | leap years. | | | 8. After extensive testing found if it was | | | the day after Christmas and Holidays was| | | configured to create the days before | | | X-mas screen it would report negative | | | days and when it got to December 1st it | | | would say 25 days left till Christmas. | | | ** Both are fixed now, On the 1st it | | | will report 24 days left till X-MAS! | | | 9. Added the small executable to prompt for| | | the info necessary to create the config.| | | file! | | |10. Added the BBS's Birthday Screen! It | | | will read the date from the config file | | | and create a screen reporting how many | | | years the BBS has been running. | | |11. Other Small Operational Changes! | | -------------------------------------------------------------------------