home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1470 / datemind.txt < prev    next >
Encoding:
Text File  |  1994-01-13  |  13.0 KB  |  264 lines
  1.                            D A T E M I N D E R
  2.                         (C) 1993 Dillo Software
  3.  
  4.     DATEMINDER is a simple reminder program designed to remind you of 
  5.     upcoming events as you boot up your computer.  It is copyrighted 
  6.     material and released as SHAREWARE... If you find it useful after 
  7.     14 days and intend to continue using it, I urge you to register 
  8.     the program with me at:
  9.               
  10.               Ray Fortner
  11.               924 Glade Forest Ct.
  12.               Cedar Hill, TX, 75104
  13.  
  14.     The registration fee is $7 and entitles you to product support, 
  15.     notice of upgrades, and bug fixes (hopefully none 
  16.     are needed!).  Please use the form below to register.  I also 
  17.     solicit your comments and opinions on the utility of Dateminder, 
  18.     and how I can improve it.  Thank you for supporting Shareware.
  19.  
  20.      
  21.     ===================================================================
  22.     D A T E M I N D E R   Version 1.1              Product Registration
  23.     I am enclosing the $7 registration fee for:
  24.  
  25.     Name    ___________________________________________
  26.  
  27.     Address ___________________________________________
  28.  
  29.     City    ___________________________________________
  30.  
  31.     State/Prov. ________________  Zip/Postal __________
  32.  
  33.                                           _    
  34.               Check diskette type: 5.25" |_|
  35.                                           _
  36.                                    3.5 " |_|
  37.               Remit to:
  38.  
  39.               Ray Fortner
  40.               924 Glade Forest Ct.
  41.               Cedar Hill, TX 75104
  42.     -------------------------------------------------------------------
  43.  
  44.     Comments: ________________________________________________________
  45.    
  46.     __________________________________________________________________
  47.  
  48.     __________________________________________________________________
  49.  
  50.     __________________________________________________________________
  51.  
  52.     __________________________________________________________________
  53.  
  54.  
  55.     =========================Clip=here================================
  56.  
  57.     DESCRIPTION:  Dateminder is designed as an unobtrusive, simple, 
  58.     small reminder program to help keep you from overlooking those 
  59.     pesky little dates, birthdays, anniversarys and other items that 
  60.     are important for you to remember.  It is NOT a full-blown 
  61.     Personal Information Manager, and doesn't have a lot of bells and 
  62.     whistles.  It is written entirely in assembly language for speed 
  63.     and compactness - the actual code uses less than 12K bytes, with 
  64.     the rest of the file size being used for data.  I do plan some 
  65.     enhancements, depending on user support and inputs for further 
  66.     development.
  67.  
  68.  
  69.     INSTALLATION:  I developed Dateminder to be called from the 
  70.     AUTOEXEC.BAT file at boot-up, so that you will be reminded of 
  71.     upcoming events when your computer is started.  The best way to do 
  72.     his is to place the files DATEMIND.COM and DATEMIND.DAT in the 
  73.     root directory of your boot drive (normally Drive C:). To do so, 
  74.     at the DOS prompt, copy those two files to the C:\ directory.  If 
  75.     you choose to place them in another directory, that's fine also, 
  76.     subject to a slight restriction, explained momentarily.
  77.  
  78.     Now open your AUTOEXEC.BAT file with a text editor and add the 
  79.     line:
  80.               C:\DATEMIND
  81.  
  82.     somewhere in the file.  I suggest the last line before executing 
  83.     the DOSSHELL or WIN command.  If Dateminder is not in the root 
  84.     directory, you will have to make  its' directory current before 
  85.     running, so that it can find the data file.  To do this, enter 
  86.     these lines in AUTOEXEC instead of the above (assume you put 
  87.     Dateminder in the \DOS directory):
  88.  
  89.               CD \DOS
  90.               C:\DOS\DATEMIND
  91.               CD \
  92.  
  93.     Finally, if you don't want the Dateminder window to pop up if 
  94.     there is nothing in it (i. e. there are no current reminders), add 
  95.     the /N switch to the DATEMIND command:
  96.  
  97.               C:\DATEMIND /N
  98.  
  99.     -------------------------------------------------------------------
  100.  
  101.  COMMAND SYNTAX:  The command syntax for Dateminder is very simple:
  102.  
  103.               DATEMIND [/M] [/W] [/N]
  104.  
  105.  The switches (in brackets) are optional and have the following effects:
  106.  
  107.     /M - Causes Dateminder to start in Monthly display mode.  This is 
  108.     the default and is normally unnecessary.
  109.  
  110.     /W - Causes Dateminder to start in Weekly display mode.
  111.  
  112.     /N - Tells Dateminder not to open display unless there are current 
  113.     reminders to show.
  114.  
  115.     The switches are not case-sensitive and can be entered in upper or 
  116.     lower case, in any order.
  117.  
  118.     USING DATEMINDER:  When called, Dateminder pops up a window in the 
  119.     center of the screen (don't worry, the data underneath is saved!).  
  120.     The window is divided into 3 sections.  The top section is for 
  121.     program I.D.  The center section, or pane, is for data display, 
  122.     entry, and editing, and the bottom pane is for the command menu 
  123.     bar.
  124.  
  125.     Initially, the program is in Upcoming Events mode, with the cursor 
  126.     in the data display pane next to the first reminder.  Of course, 
  127.     the 1st time you start Dateminder, there are no reminders.  The 
  128.     bottom pane tells you to press Escape to exit, F2 for the menu, 
  129.     and F3 to toggle the "look-ahead" mode between monthly and weekly.  
  130.     The mode is shown highlighted.  A note at the bottom of the data 
  131.     display pane reminds you that to acknowledge an item, type an 'x' 
  132.     beside it.  More on acknowledging items later - first you have to 
  133.     enter some.  Following are the menu commands:
  134.  
  135.     New events:
  136.     To enter new reminders, press F2 to get to the menu.  From the 
  137.     menu bar in the bottom pane, press N to bring up the New Item 
  138.     entry form in the data pane.  Data entry in this form is straight- 
  139.     forward - type in the numeric date in Month-Day-Year form.  You 
  140.     can use wildcard  dates for recurring events - wildcards are 
  141.     explained later.  The cursor advances to the Event field for you 
  142.     to enter the event you wish to be reminded of.  Use the <tab> key 
  143.     to move from field to field.  The next two fields are optional.  
  144.     The first, "Remind __ days in advance", allows you to specify how 
  145.     soon in advance of the date a non-erasable reminder is displayed.  
  146.     The default is 2 days.  The second, "Remind after acknowledged 
  147.     (Y/N)", if answered with a Y, causes the reminder to be shown 
  148.     continuously, even after user acknowledgment.  The default is N.  
  149.     When ready to store the event, press Enter to return to the menu 
  150.     screen, and the new reminder is displayed (if within the date 
  151.     scope, monthly or weekly).
  152.  
  153.     Edit events:
  154.     To edit existing events, press E from the menu bar.  This will 
  155.     display a list of all events in the data file, in chronological 
  156.     order, with the cursor next to the first one. Use the arrow keys 
  157.     to move the cursor next to the event to be edited, and press 
  158.     enter.  If there are more than six events in the file, use PgDn 
  159.     and PgUp to page through the file to get to the event you want.  
  160.     After selecting the event, it is displayed in the entry form for 
  161.     you to change as necessary.  Press Enter when through and it will 
  162.     be stored in its new form.  Press Escape to return to the menu bar.
  163.     
  164.     Delete events:
  165.     To delete an event, press D from the menu bar.  This will bring up 
  166.     the same list as Edit, except that it will be titled "Delete 
  167.     item".  Choose the event to delete the same way you did in Edit, 
  168.     and press Enter.  The event will turn red, and you will be asked 
  169.     to confirm the deletion with a 'Y'.  Any other key will abort the 
  170.     delete.  Again, press Escape to return to the menu bar.  A note: 
  171.     one-time events are automatically deleted after they are past - 
  172.     unless you didn't acknowledge them.
  173.  
  174.     Print events:
  175.     To print a listing of currently due events, press P from the menu 
  176.     bar.  You will be prompted to check your printer and press Y to 
  177.     print the list.  Pressing the N key will abort the print command.
  178.  
  179.     Calendar:
  180.     Pressing C at the menu bar brings up a calendar display in the 
  181.     data pane.  This can be used for planning ahead, or reference.  
  182.     Pressing the left or right arrow keys changes the month backward 
  183.     or forward, while pressing the up or down arrow keys advances or 
  184.     decreases the year.  The date range is from Jan, 1980 to Dec, 2099.
  185.  
  186.     WHAT IS DISPLAYED, AND WHEN:  After your events have been entered, 
  187.     you will spend most of your time in the data display mode (the 
  188.     cursor in the data pane).  As noted, this is the start-up mode of 
  189.     Dateminder.  When called, Dateminder looks ahead either one month 
  190.     or one week, depending on your command, and finds all 
  191.     unacknowledged events, plus all events that are within the number 
  192.     of days specified in the "Remind in advance" field, and displays 
  193.     them in chronological order.  If there are more than six events 
  194.     due, you can display them by using PgDn and PgUp to page through 
  195.     the list.  An unacknowledged item is identified by a blank next to 
  196.     its' date.  To acknowledge it, move the cursor to the blank and 
  197.     press 'x'.  The next time the program is started, this event will 
  198.     not appear - unless or until it is within the number of days you 
  199.     set for advance reminding.
  200.  
  201.     As an example, let's track an event all the way through its life 
  202.     cycle.  On October 1st, you enter the event:  "11/07/93  10:30 
  203.     Meeting with Bob", and set the "Remind days in advance" to 5.  
  204.     After pressing Enter to store this date, it does not appear on the 
  205.     list just yet, as it is over a month away.  On October 7th, when 
  206.     Dateminder is called, this event pops up in the data display, with 
  207.     a blank next to the date.  To make it go away, move the cursor to 
  208.     the blank and press 'x'.  The event won't go away during this 
  209.     session, but the next time Dateminder is started, it will not 
  210.     appear.  The next time it does show up will be on November 2nd, 5 
  211.     days in advance of the meeting.  Now it will appear every time 
  212.     Dateminder is started.  On Nov. 7th, the date will read "Today" 
  213.     and you should acknowledge it again.  If you do, on Nov. 8th, the 
  214.     event will be deleted from the file automatically.  If you don't 
  215.     acknowledge it again, it will show up subsequently in red until 
  216.     you either acknowledge it, or delete it yourself.
  217.  
  218.     WILDCARD DATES:  To save time and typing entering many events, 
  219.     particularly those that recur with regularity, such as birthdays, 
  220.     anniversaries, monthly bills, weekly meetings, etc., you can enter 
  221.     wildcards for dates.  This way you only have to enter Aunt Nelly's 
  222.     birthday once and it will come around again every year until Aunt 
  223.     Nelly cashes in.  A wildcard is a '**' entered in the month or 
  224.     year fields, or a weekday abbreviation in the day field.  There 
  225.     are seven combinations of wildcards, shown in the examples below:
  226.  
  227.      MM/DD/YY                     Meaning
  228.      =========                    ======
  229.      **/12/93                     The 12th of every month in 1993
  230.      12/25/**                     December 25th of every year
  231.      **/15/**                     The 15th of every month, every year
  232.      02/TU/94                     The second Tuesday of every month of 
  233.                                   1994
  234.                                   (Note: the 02 does NOT refer to 
  235.                                    February)
  236.      **/WE/93                     Every Wednesday in 1993
  237.      01/SA/**                     The first Saturday of every month, 
  238.                                   every year
  239.      **/MO/**                     Every Monday, every year
  240.  
  241.     Valid weekday abbreviations are SU, MO, TU, WE, TH, FR, and SA.  
  242.     You may enter them in upper or lower case.
  243.  
  244.     A wildcard date, after past due and acknowledged, will reset 
  245.     itself to the next occurence and appear at the proper times.
  246.  
  247.     ERRATA:  Following are a couple of idiosyncracies in v1.0 of 
  248.     Dateminder, and how to avoid them:
  249.  
  250.     1)  After entering new events, DON'T acknowledge them immediately.  
  251.     This can cause a system lock-up if you are using a disk cache.  
  252.     Just leave the new items un-acknowledged until the next time 
  253.     Dateminder is started and there will be no problem.
  254.  
  255.     2)  If you enter an invalid date, such as one that has already 
  256.     past, Dateminder will beep and request a valid date.  It may 
  257.     continue to do so even after you type over the incorrect date with 
  258.     a correct one.  If this happens, press Escape to return to the 
  259.     menu bar, then press N to reenter the New Item mode and start 
  260.     over.  Dateminder is particular about the date being entered in 
  261.     the correct format: Month/Day/Year.
  262.  
  263.     --------------------------------------------------------------------
  264.