home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bday15a.zip / BDAY.DOC next >
Text File  |  1993-02-02  |  9KB  |  277 lines
  1. *********************************  SHAREWARE  *********************************
  2.     
  3. Version 1.5A
  4.  
  5.  
  6. This program was written in Quick Basic V4.5. I wrote it because I was tired
  7. of forgetting birthdays and didn't want to use a large program like DBase.
  8.  
  9.    Disclaimer:
  10.    -----------
  11.    The use of program BDAY and its accompanying files constitutes complete 
  12.    acceptance and total agreement with the following disclaimer:  
  13.    There are no guarantees that BDAY will function correctly under any specific
  14.    hardware configuration and the author will not be held liable for any direct
  15.    damage, indirect damage, or other loss caused by the use of BDAY.
  16.  
  17.   
  18. This software is NOT Public Domain! Feel free to distribute this to everyone
  19. you know BUT... You may not charge a fee for distributing AND you must include 
  20. ALL of the original files!
  21.  
  22.   
  23.   This program consists of 3 files
  24.     BDay.Exe
  25.     BDay.Fil
  26.     BDay.Doc (You're reading it)
  27.  
  28.  
  29.  
  30. BDay.Fil is the data file and contains all the information that YOU will enter
  31. (Names, Birth date and how far to 'Look Ahead' for birthdays.)
  32.  
  33.  
  34. BDay.Exe is the main program and is run one of 2 ways, either by entering
  35. 'Bday' or 'Bday /f'.
  36.  
  37. Executing 'Bday' runs the program INTERACTIVELY. It displays the names, 
  38. birth dates, age, a suppressed flag and a menu of options available. The
  39. display is sorted by last name with a sub-sort for first name.
  40.  
  41.  
  42. Running 'BDay /f' (usually from your Autoexec.Bat) checks your system's current
  43. date, checks the BDay.Fil to see how far ahead to look for birthdays, then scans
  44. through all the birthdays to see if one is coming up within that time period.
  45. If birthdays are found a quick tune is played and the upcoming birthdays are
  46. displayed (sorted by last name). If no birthdays are found the word 'NONE' is
  47. displayed.  If birthdays are found, but have been suppressed, a message is
  48. displayed stating how many suppressed birthdays are within the selected time
  49. period.
  50.  
  51. Running 'BDay /f' is NON-INTERACTIVE, as soon as the Birthday information has
  52. been displayed you are returned to the DOS prompt.
  53.  
  54.  
  55.  
  56. Now a quick explanation of each option...
  57.  
  58. (A)dd name :
  59.  
  60.     Used to add a new name and associated birthday, if you do not know what
  61.  year they were born enter 0 (More on this later). There is a limit of 18 chars
  62.  for the First name and 19 chars for the Last. You also get 1 char for a Middle
  63.  Initial but entry of this is optional.
  64.  
  65.  
  66.  
  67. (D)elete name :
  68.  
  69.     Prompts you to enter the record# of somebody you wish to delete then
  70.  highlights that record & asks for confirmation.
  71.  
  72.  
  73.  
  74. (M)odify a record :
  75.  
  76.     If you made a typo entering somebody's name or Birth Date here's your
  77.  chance to correct it. After selecting a record# to modify you are asked whether
  78.  to modify the (N)ame or (B)irth Date. This is also where you could correct the
  79.  year somebody was born if you had entered a 0 before.
  80.  
  81.  
  82.  
  83. (P)rint :
  84.  
  85.     This will print your database giving you the option of having it sorted
  86.  by (N)ame or (B)irth Date. There is some error detection done to see if there
  87.  is a printer available. Selecting this option also causes ALL file changes to
  88.  be SAVED.
  89.  
  90.  
  91.  
  92. (Q)uit program :
  93.  
  94.     Saves all changes and exits program.
  95.  
  96.  
  97.  
  98. (C)hange Forecast :
  99.  
  100.     Allows you to select how many days to look ahead for an upcoming
  101.  birthday/event.
  102.  
  103.  
  104.  
  105. (S)uppress Notice :
  106.  
  107.     This allows you to turn the Suppress flag ON (Y) or OFF (N). This option
  108.  is nice if you have the program looking ahead 30 days, have already been
  109.  notified of an upcoming birthday and don't want to be reminded of that
  110.  particular birthday again (you've already sent a card or present) - then you
  111.  would use this option to change Suppressed to 'Y'.  The program will reset this
  112.  flag AFTER the birthday has passed so you will not miss it the next year. The
  113.  flag will also be removed if the Forecast period is shortened to a period that
  114.  no longer includes the suppressed birthday.
  115.  
  116.  
  117.  
  118. (O)ptions :
  119.  
  120.     Allows you to select whether your data will be displayed sorted by name
  121.  or by date, also lets you select if the BDay tune will be played EVERY time you
  122.  turn on your computer or only the 1st time during the current day.
  123.  
  124.  
  125.  
  126. (+)Page Down :
  127.  
  128.     This option is only available if you have MORE than 15 names and allows
  129.  you to see the next page of names.
  130.  
  131.  
  132.  
  133. (-)Page Up :
  134.  
  135.     Same as Page Down but it displays the previous page (after using
  136.  Page Down.)
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   Other great information...
  144.  
  145. The program displays each person's age when you run 'Bday' based on the current
  146. system date and the birth date entered into the program. If you don't know what
  147. year they were born, enter a 0 for the year (example 4-28-0) and the program
  148. will display their age as "Unknown."
  149.  
  150. Whenever you are prompted to enter a date you may use MM.DD.YY, MM/DD/YY or
  151. MM-DD-YY. In addition, you do NOT need to use 2 digits, i.e., if a birth date is
  152. on 4 Apr 59 you could enter it 4-4-59 or 04.04.59 or 4/04/1959.
  153.  
  154. Whenever you are entering a date you may enter the year as YY or YYYY
  155. (i.e. 59 or 1959). Any year entered in the range of 1 to 99 is assumed to be
  156. in the 1900s (1901 to 1999), if you are entering a birthdate for the year 1900
  157. then you MUST enter it as 1900. 
  158.  
  159. When you enter a date, a validity check is run on it to verify a valid Month/Day
  160. entry. If an invalid date is entered the program will BEEP and return you to the
  161. date entry prompt.
  162.  
  163. In order for Bday to run, you need to execute the program while in the directory
  164. containing both the 'Bday.Exe' and 'Bday.Fil' files.
  165. OR
  166. Put 'SET BDAY=C:\Util\' in your Autoexec.Bat file (Assuming Bday.Fil is in a
  167. DOS directory called 'Util' on your C: drive).
  168.  
  169.  
  170. **** DO NOT USE ANY SPACES EXCEPT BETWEEN THE WORD 'SET' and 'BDAY=path'
  171. By using this environment variable you may place the 'Bday.Fil' file anywhere,
  172. on any drive and the 'Bday.Exe' program will find and use it. If you have used
  173. 'SET BDAY=path' then you may put 'BDay.Exe' in any directory contained in your
  174. DOS Path.
  175.  
  176. Because this program uses colored text to display everything I don't think it
  177. will work on an MDA system (Monochrome Display Adapter). It should work fine on
  178. anything from Hercules Monochrome to VGA. (Hercules Monochrome will look a bit
  179. strange but the program runs fine).
  180.  
  181. I'd appreciate any comments or suggestions you may have, you can send me
  182. E-Mail on CompuServe. My user ID is 76056,1021.
  183.  
  184.  
  185.  
  186.   Last but not least.....
  187.  
  188. If this is a program that you find helpful, a small token of gratitude will be
  189. greatly appreciated....
  190.  
  191. Please send $5.00 to
  192.  
  193.     James Bess
  194.     609 Wade Rd.
  195.     Longmont CO 80503
  196.  
  197.  
  198.  
  199.  
  200. Program History.....
  201.  
  202. 9-8-92   Original release and uploaded to Compuserve
  203.  
  204.  
  205.  
  206. 10-1-92  Had Compuserve remove original release (Due to bugs)
  207.  
  208.  
  209.  
  210. 10-5-92  V1.11 Several minor changes and bug fixes...
  211.  
  212. * Fixed problem with not printing the last record in the file.
  213. * Corrected spelling error in the Main Menu.
  214. * Added Version# to Main Menu screen. (V1.11)
  215. * Moved the display around to make room for longer names.
  216. * Changed number of chars from 12 to 18 for first name and from 16 to 19 for
  217.   last name.
  218. * Added dots after name for easier reading.
  219. * Program did not 'Forecast' a Birthday if current date IS the Birthday.
  220. * Made a slight change to the look of the printout.
  221. * Program did not print list sorted by birthday if the BDAY.FIL was located
  222.   using the 'SET BDAY=' option.
  223. * Corrected a bug caused by running 'BDay/f' if the program was going to try
  224.   and display more than 1 full screen. 
  225. * Modified sort routine to speed it up.
  226. * Changed the date handling to allow ANY year (Previous release only allowed
  227.   from 1901 to 1999.
  228. * Changed the BDAY environment handling slightly so it is more user friendly.
  229.  
  230.  
  231.  
  232. 11-22-92  V1.12A Minor Bug fix
  233.  
  234. * The program would incorrectly subtract 1 yr when forecasting birthdays if the
  235.   birthday was on the current date.
  236.  
  237. * Made a minor display change for Suppressed birthdays when in menu mode. 
  238.  
  239. * Changed from "(E)xit" to "(Q)uit"
  240.  
  241.  
  242.  
  243. 2-2-93  V1.5A Minor Enhancements
  244.  
  245. * Added '(O)ptions' to the menu selections. This allows you to select the sort
  246.   routine used (By Name or Date) and also select whether the BDay tune is played
  247.   always or only the first time your PC is booted on a given day.
  248.  
  249. * Made a change to save ALL data when you select PRINT. Previous versions only
  250.   saved the data when you selected QUIT or EXIT, this had caused some problems
  251.   when the program crashed while trying to print and new entries had not yet
  252.   been saved.
  253.  
  254. * Minor display change, the selectable options are now highlighted to make them
  255.   easier to see.
  256.  
  257. * The '+' and '-' keys still work the same but I changed the menu to read
  258.   differently ('+' is now Page Down and '-' is now Page Up) to conform to normal
  259.   usage.
  260.  
  261.  
  262. **** NOTE: This version is not compatible with the BDAY.FIL from the original
  263.        release (No version number). I will E-Mail a conversion program to
  264.        anyone that registers and has their data in the original format. 
  265.  
  266.  
  267.  
  268. Possible 'Wish List' for future version??????
  269.  
  270. * Add an enhancement to track Anniversaries and Holidays.
  271.  
  272.  
  273.  Enhancements/Updates will depend on user feedback.
  274.  
  275.  Any other ideas or comments? Let me know!
  276.  
  277.