home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 227 / REMIND10.ZIP / REMINDME.DOC < prev    next >
Text File  |  1992-04-28  |  6KB  |  129 lines
  1.    REMINDME is a program that performs a simple function: it reminds one of
  2. important dates in the near future. I put this program as the last line of my
  3. AUTOEXEC.BAT file so that each time the computer starts I am reminded of
  4. weddings, anniversaries, etc. REMINDME can be customized in many ways,
  5. including screen colors and the number of days it scans in advance before
  6. displaying dates.
  7.  
  8.    In order to work, REMINDME needs a data file with information in specific
  9. columns:
  10.  
  11.     Cols. 1-2   Month of the event in numbers, with leading spaces for months
  12.                   January through September (1-9).
  13.     Cols. 3-4   Date of the event in numbers, with leading spaces for dates
  14.                   1-9.
  15.     Cols. 5-6   Year of the event, using the last two numbers, e.g. 1927 is
  16.                   shown as 27. If the year is unknown (you really weren't
  17.                   going to ask your secretary what year she was born, were
  18.                   you?), enter two asterisks (**).
  19.     Cols. 8-33  The name of the person(s).
  20.     Cols. 34-58 The event, e.g. birthday, wedding anniversary.
  21.  
  22.    The following are examples of valid lines from a hypothetical data file:
  23.  
  24.  4 150 Tom Foolery               Birthday
  25.       (Tom Foolery was born on April 1, 1950)
  26.  
  27. 1114** Myrtle O'Malley           Birthday
  28.       (Your secretary, Myrtle, was born on November 14, year unknown to you)
  29.  
  30.  62873 Me and My Turtledove      Wedding Anniversay
  31.       (You wouldn't want to forget your wedding anniversary on June 28, 1973)
  32.  
  33.  52580 Brian                     Anniv. College Graduation
  34.       (You don't have to limit the data to birthdays and weddings)
  35.  
  36.    The data file must be a straight ASCII file, without word processing codes.
  37. Though it can be named anything and stored on any directory, REMINDME is
  38. slightly easier to use if the data file is named DATES.DAT and stored in the
  39. same directory as REMINDME.EXE. It is not necessary that the dates in the data
  40. file be in any special order; the program will automatically sort them by date
  41. before displaying them.
  42.  
  43.    If the data file is named DATES.DAT and is in the same directory as
  44. REMINDME.EXE, then simply typing REMINDME will probably suffice for 95% of
  45. users. If the data file has another name or is in another directory, or if you
  46. wish to customize the program, the following parameters may be added on the
  47. command line following the word REMINDME:
  48.  
  49.    F=filename
  50.       This is used when the data file has another name or is in another
  51.       directory. The default is a data file named DATES.DAT.
  52.  
  53.    D=days in advance to scan for dates
  54.       By default REMINDME will show all dates in the data file within three
  55.       weeks of the current date (as stored in the computer). This can be set
  56.       to any number between 1 and 365.
  57.  
  58.    C=clear screen before displaying dates (Y or N)
  59.       By default REMINDME clears the screen in advance of displaying the
  60.       dates. If it is not desirable to clear the screen first, add the
  61.       parameter C=N to the command line.
  62.  
  63.    S=sort by dates before displaying them (Y or N)
  64.       By default REMINDME sorts the dates so that dates closer to the present
  65.       appear before dates farther away. The parameter S=N tells the program to
  66.       present the dates in the same order they appear in the data file. If the
  67.       data file is very large and the computer is slow, the program will run
  68.       faster without sorting. In that case, one may simply manually keep the
  69.       data file in a sorted form.
  70.  
  71.    T=text color
  72.    A=alternate color
  73.    B=background color
  74.       REMINDME normally displays dates in yellow (the text color) and the
  75.       current date in white (the alternate color) on a blue (the background
  76.       color) screen. Any or all of these may be changed by specifying colors
  77.       from the following list:
  78.                               black         darkgray
  79.                               blue          lightblue
  80.                               green         lightgreen
  81.                               cyan          lightcyan
  82.                               red           lightred
  83.                               magenta       lightmagenta
  84.                               brown         yellow
  85.                               lightgray     white
  86.  
  87.       Note that no words have spaces, i.e. "lightblue" is a proper color but
  88.       "light blue" will not be recognized by the program.
  89.  
  90.    H or ?
  91.       Either H or ? on the command line will provide a help screen which
  92.       contains a condensed version of this document.
  93.  
  94.    Examples of valid command lines:
  95.  
  96.       REMINDME f=c:\people.dat d=30
  97.          (Use the data file PEOPLE.DAT in the root directory and scan for
  98.           dates within the next 30 days)
  99.  
  100.       REMINDME s=n t=lightcyan
  101.          (Use light cyan as the text color--keeping the other default colors--
  102.           and do not sort the dates when displaying them)
  103.  
  104.       REMINDME c=y
  105.          (Clear the screen before displaying data. Note: this parameter is not
  106.           needed since the program defaults to clearing the screen)
  107.  
  108.       REMINDME ?
  109.          (Do not run the program but display condensed information about the
  110.           program)
  111.  
  112.    If one wishes to regularly use a complex command line, like:
  113.  
  114.       REMINDME f=c:\wp\files\remember.dat d=14 s=n b=green {line continues}
  115.         t=lightcyan a=lightgreen
  116.  
  117.    A one-line BAT file can be created which includes the command line. Then
  118. REMINDME can be invoked through the BAT file. Better yet, place REMINDME and
  119. any parameters in the AUTOEXEC.BAT file to insure you will not forget anything
  120. important.
  121.  
  122.    REMINDME is hereby placed in the public domain. I have never had any
  123. problems with the program in over two years of daily use but, of course, I
  124. cannot take any legal responsibility if anything goes wrong on your system.
  125.  
  126.                                        Michael Cieslak
  127.                                        Rockford, IL
  128.                                        4/28/92
  129.