home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / actoday.lha / ACToday.DOC < prev    next >
Text File  |  1993-02-17  |  5KB  |  144 lines
  1. ------------------------------------------------------------------------
  2. ACToday Today In History Door -- v.99 by Rich Wardwell -- Adept Concepts 
  3. ------------------------------------------------------------------------
  4.  
  5. WHAT IS ACToday?
  6. ~~~~~~~~~~~~~~~~
  7. ACToday is a replacement to the basic DLG TDIH (Today In History) door.
  8. This utility is written specifically for DLG but will likely be compatible 
  9. with any BBS allowing the use of CLI doors).  
  10.  
  11. ACToday will display different information for each day of the year.
  12. The data are stored in a set of files for each month.
  13.  
  14. I haven't personally seen one of these programs available specifically 
  15. for DLG other than TDIH, although I just recently found one that had 
  16. a larger flexibility in information that could be displayed, yet lacked 
  17. many of the things which I needed.  So, thats how ACToday was born.
  18.  
  19. FILES INCLUDED
  20. ~~~~~~~~~~~~~~
  21.    The following files should be included in the ACPoll archive:
  22.  
  23.    ACToday          The executable.
  24.    ACToday.DOC      You're reading it now.
  25.    History.DOC      History of changes.
  26.    Regist.DOC       Blank registration form.
  27.  
  28. THE LEGAL STUFF
  29. ~~~~~~~~~~~~~~~
  30. ACToday, and the accompanying files are copyright 1993 by Rich 
  31. Wardwell / Adept Concepts. You are granted a license to use ACToday 
  32. on your BBS, and distribute it to other sysops provided:
  33.  
  34.     - You distribute it ONLY in the complete, unmodified archive.
  35.     - No fee is charged for distribution of ACToday, except if
  36.       you distribute it via non-electronic means (ie mail), you
  37.       may recover the cost of the disk and postage.
  38.     - You register your copy of ACToday if used often (see below).
  39.  
  40. I ACCEPT NO RESPONSIBILITY FOR ANY LOSS OR DAMAGE INCURRED AS 
  41. A RESULT OF USING ACTODAY.  BY USING ACTODAY, YOU, THE USER, AGREE 
  42. THAT I SHALL NOT BE HELD RESPONSIBLE FOR ANYTHING ACPOLL DOES OR 
  43. DOES NOT DO TO YOUR COMPUTER SYSTEM, SOFTWARE RUNNING ON THAT 
  44. SYSTEM, OR HARDWARE CONNECTED TO THAT SYSTEM. 
  45.  
  46.  
  47. PLEASE REGISTER
  48. ~~~~~~~~~~~~~~~
  49. Although I enjoy developing utilities for DLG, I gave up a lot of 
  50. my spare time to write this program (and the few others that are out
  51. there and in development) even though I had other things that I 
  52. probably should have done (like sleep).  I really don't expect to
  53. see anything in return, but it certainly would be nice; especially
  54. if you use a number of my utilities.
  55.  
  56. So, if you feel so inclined to send me something it certainly would be
  57. welcomed.  A small donation along with a filled out registration form
  58. will grant you access to the latest version of ACToday on my BBS.  The
  59. registered version does remove some of the restrictions found in the
  60. released version.  (These will be outlined shortly).  Anyway, here is
  61. is the address for registration: 
  62.  
  63.  
  64.          Rich Wardwell
  65.          Adept Concepts
  66.          545 Prince Avenue
  67.          Athens, GA 30601
  68.          USA
  69.  
  70. Bug reports and ideas for the next version (if I do another version)
  71. may also be sent to the above address, or to my BBS:
  72.  
  73.          The GOOD News BBS
  74.          (706) 549-8072        14.4k v.32bis v42bis
  75.      (706) 369-7555     2400bps            
  76.          
  77.          FIDO 1:370/50  & 1:370/51
  78.      FMLY 8:3103/30 & 8:3103/40
  79.      AMY  40:704/10 & 40:704/11  
  80.  
  81.  
  82. You will also be able to access any/all of my other DLG utilities there.
  83.  
  84.  
  85.  
  86. SETTING IT UP
  87. ~~~~~~~~~~~~~
  88. ACToday is quite basic in its setup.  You must first copy all of the 
  89. TODAY.??? data files to some directory on your hard drive (as well as
  90. the executable).  Then call ACToday from DLG as a CLI program with the
  91. following syntax:
  92.  
  93.        ACToday <PATH OF TODAY.???> -bsrfjnv$* QUERY
  94.  
  95.        eg. ACToday DOORS:Today/ -* QUERY
  96.  
  97. The first argument is the location of the data files.  The second argument
  98. is the information you wish to display.  
  99.  
  100.      B => Birthdays
  101.      S => Special Events
  102.      F => Thought of the Day
  103.      J => Joke or Riddle
  104.      N => Sniglet
  105.      V => Verse or Biblical Event
  106.      R => Reminders
  107.      $ => Birthday of a User
  108.      * => Display ALL available information
  109.  
  110. Remember to precede the letter/s with a dash '-'.   The QUERY command is
  111. optional.  This will ask the user to "Press [RETURN]" between each separate
  112. set of information.
  113.  
  114.  
  115. DATA FILES
  116. ~~~~~~~~~~
  117.  
  118. Examples:
  119.  
  120. B06251973 Danny Lee Bob's Birthday
  121.  \ \ \   \
  122.   \ \ \   The year of the Birthday or Event
  123.    \ \ Two digits - The date of the file
  124.     \ Two digits - 1-12 the month of the field
  125.      The field this represents - look at the list above....
  126.  
  127. S01151975 It happened here on this day
  128. S01151975Cof this year
  129.           \
  130.            Tells the program this is a "continuation" of the previous
  131.            lines input.
  132.         
  133. S0405    7Daylight savings time.
  134.           \
  135.            Specifies that this event happens ONLY when it is on day number
  136.            x (in this case 6) of the week.  1 => Sunday through 7 => Saturday
  137.  
  138. These Fields ARE VERY column specific.  
  139.  
  140. DO NOT DEVIATE FROM THIS when creating your own data files or adding to the
  141. ones supplied.
  142.  
  143.  
  144.