home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / today / !Today / Docs / PC next >
Encoding:
Text File  |  1991-06-09  |  5.4 KB  |  135 lines
  1.  
  2.                          ---TODAY---
  3.  
  4. OVERVIEW
  5. Have you ever thought it would be nice to know what interesting
  6. things happened on a date in history?  When famous, or not so
  7. famous, birthdays occurred?  TODAY will tell you.  When the program
  8. is run, it looks at the system date, or a date you supply, then
  9. tells you what things of interest happened on that date.  You can
  10. even create a file of dates important to you and be reminded of them
  11. right along with the Marquis de Sade's birthday or the first
  12. commercial radio broadcast.  Just type: TODAY HELP
  13.  
  14.  
  15. HOW TO USE THE PROGRAM
  16. You can just enter TODAY and get the scoop on the current date or
  17. you can optionally enter a date as MMDD, with leading zeros, to see
  18. what happened on a particular date.  There are several options:
  19.  
  20.         MMDD    a date, such as 0401, to use instead of
  21.                 the system date
  22.  
  23.         HELP    will display running instructions
  24.  
  25.         CLEAR   will clear the screen before displaying anything
  26.  
  27.         WAIT    will wait for a key press after the display
  28.  
  29.         ONCE    will only run TODAY once each day.  Without this
  30.                 option it will display msgs each time it is run.
  31.                 Used in an AUTOEXEC.BAT, it will only run TODAY
  32.                 when you turn on your system, not when you reboot.
  33.  
  34. Most of these options are useful when TODAY is run from an
  35. AUTOEXEC.BAT when you turn on your machine.  They cause the program
  36. to only run the first time you boot, not when you re-boot.  You can
  37. clear the screen of previous stuff before today's little gems and
  38. you can have a pause at the end so the messages aren't destroyed by
  39. subsequent programs.  For example:  TODAY CLEAR 0628
  40.  
  41. CUSTOMIZATION
  42. TODAY has one data file for each month of the year.  They are named
  43. TODAY.JAN, .FEB, .MAR etc.  You can also have a personal file named
  44. TODAY.OWN.  This is so all your important dates aren't scattered
  45. among 12 files.  All files are plain vanilla ASCII in this format:
  46.  
  47. Column 1:        The record type which can be a B for birthdays,
  48.                  S for special dates in history or R for a reminder.
  49.  
  50. Cols 2-5:        Month and day as MMDD with leading zeros.  Zeros
  51.                  for either month or day cause ALL months or days
  52.                  to match when being scanned.  For example  0001
  53.                  would match the first of every month while 0400
  54.                  would match every day of April.
  55.  
  56. Cols 6-9:        The full year of the event as four digits.
  57.                  May be left blank, msg will move left.
  58.  
  59. Column 10:       A special processing flag.  Values may be:
  60.  
  61.                  BLANK for no special processing.
  62.  
  63.                  C to continue a message from the previous line.
  64.                  Note, that you MUST repeat the date fields.
  65.  
  66.                  DAY-OF-WEEK DIGIT where 1=Sunday ... 7=Saturday
  67.                  This will cause the message to display only if the
  68.                  date falls on a certain day of the week.  Look in
  69.                  the November file for voting day examples.
  70.  
  71. Cols 11-70       The message to display for this date.
  72.  
  73.                        --EXAMPLES--
  74.  
  75. *mmddyyyy Birthdays
  76. *-------- ------------------------------------------------------------
  77. B09011875 Edgar Rice Burroughs, novelist, Ah-ee-ah-ee-ah!
  78. B09021838 Queen Liliuokalani (last queen of Hawaii).
  79. B09021952 Jimmy Connors, tennis brat
  80.  
  81. *mmddyyyy Events
  82. *-------- ------------------------------------------------------------
  83. S09011939 Germany invades Poland, starts World War II.
  84. S09011952 Sutro Baths purchased by George Whitney.
  85. S0901    2Labor Day, a legal holiday
  86. S09021620 The Mayflower sets sail from Plymouth with
  87. S09021620C102 Pilgrims.
  88.  
  89. *mmddyyyy Reminders
  90. *-------- ------------------------------------------------------------
  91. R0001     Pay the mortgage!
  92. R0401     Taxes due in two weeks.
  93. R0415     Last day to pay taxes!
  94.  
  95. Leave the headings in or you may get a nasty surprise.  Note that
  96. Labor day must be on a Monday and the Mayflower gets two lines of
  97. coverage befitting that momentous event.
  98.  
  99. This format applies to TODAY.OWN also.  You can put in birthdays,
  100. anniversaries, holidays etc.  Messages in your personal file will
  101. tend to be only Birthdays and Reminders.  Also, try putting in
  102. reminders a few days BEFORE the date in question to give youself
  103. some warning.
  104.  
  105. HISTORY
  106. TODAY/PC was written in Datalight C for IBM PC compatible systems by
  107. Patrick Kincaid in July of 1986.  It was inspired by a program
  108. originally written by Mike Butler in PL/1 on an IBM VM/CMS system.
  109. He should be credited with the original concept and the bulk of the
  110. wonderful data in the files.  You will notice a distinct San
  111. Francisco flavor to the databases.  Who says programs can't have
  112. class?
  113.  
  114. USER SUPPORT
  115. Don't send money, send more dates!  I would like the program
  116. distributed far and wide for free with this understanding: if you
  117. like it send me more dates to put in the databases.  This way we can
  118. create real shareware. Don't send the month files with your new
  119. dates added, send the new stuff as listings, in standalone files on
  120. PC diskettes or as electronic mail to me via the Marin-Sonoma PC User
  121. Group BBS (415) 927-1216.  You can mail listings, bugs (features!) or
  122. suggestions to:
  123.  
  124.                     Patrick Kincaid
  125.                    618 Douglas Drive
  126.                  Mill Valley, CA 94941
  127.  
  128. And remember...
  129.  
  130.                    We call it software
  131.                         because
  132.                     we cannot keep it
  133.                            up.
  134.  
  135.