home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 080.lha / NAG / Nag.doc < prev    next >
Text File  |  1986-11-20  |  9KB  |  196 lines
  1.  
  2. *********************************************************************
  3. *************************    Nag.doc   *******************************
  4. *********************************************************************
  5.  
  6.      `Nag' is an electronic appointment calendar for the Amiga. In
  7. addition to keeping track of your appointments, your anniversary, and
  8. your mother-in-law's birthday, `Nag' can be instructed to gently
  9. remind you by popping up a display of the next `nagged event'.
  10.  
  11.      It is intended to be run in the background and started from
  12. your startup-sequence following your time-setting procedure. In addition
  13. to the program file, Nag requires 2 (or more) "datefiles". One for
  14. this year and one for next year. It will search for these first in the
  15. current directory, then in the directory it found `Nag', and finally,
  16. in the "S:" directory. Nag will save the new datefiles to the same
  17. directory it found the old ones, and will create new files if necessary.
  18.  
  19.      Sample year-files are included with this arc file. They contain
  20. standard holidays and other "important" dates. ;-)
  21.      To use these files, install Nag.1987 and Nag.1988 in your chosen
  22. directory. (see above).  (I use the s: directory on my df0: ).  Then
  23. install Nag in your chosen directory. (I use system: ).  Then edit
  24. your s:startup-sequence thus: (this assumes you use what I use).
  25.  
  26.      - - - -                       (various stuff here)
  27.      RTClock    (This sets MY system time. The idea is, just make sure
  28.      - - - -                      the time is set before you run Nag).
  29.      LoadWb       (if you use WorkBench, it must be loaded before Nag)
  30.      RunBack df0:system:Nag
  31.      - - - -                    (might be more stuff here)
  32.      EndCLI > nil:
  33.  
  34.  
  35. **********************  Getting Nag Started  **********************
  36.  
  37. TO START:  RunBack <path>Nag <buffer size>
  38.  
  39. Default buffer size = 20000 bytes.   (Big enough for the casual user.)
  40.    The buffer needs to be big enough to hold both this year and next
  41. year's files plus what you plan to add when editing. The structure of
  42. the nag entries has been made as memory efficient as possible, so the
  43. default buffer will hold more than 400 entries.
  44.   (Minimum size = 6000 bytes, Maximum size = 4,000,000 bytes. If you
  45.    try to use an out of range buffer size, Nag will choose the closest
  46.     valid value.)
  47.  
  48.  
  49. **********************  Tiny "Sleeping" Window  **********************
  50.  
  51.      When you first run nag, a small window will appear near the top of
  52. the workbench display. This is the "sleeping" window. This is Nag at
  53. rest. You may move this little window to anywhere on the screen. It
  54. will remember where you left it. Nag will now hang around waiting for
  55. one of two events.
  56.  
  57.    1. The Timer signal arrives. (Time to remind you!)
  58.         In this case, the "Nag Window" will pop up displaying the event
  59.          which triggered it. (As long as the "Nag" button is "lit", the
  60.           "Nag Window" will pop-up in front of all current workbench
  61.             screens.)
  62.             NOTE: If you are editing or searching when the Timer signal
  63.                   arrives, that window will be closed before the Nag
  64.                   message arrives.
  65.         
  66.            YOU MUST PRESS THE LEFT MOUSEBUTTON INSIDE THE NAG
  67.            WINDOW TO ACKNOWLEDGE THE NAG AND MAKE IT GO AWAY!
  68.        
  69.         An un-acknowledged nag will flash it's screen every 30 seconds
  70.         until it is acknowledged...   (soooo irritating... ;-)
  71.  
  72. or 2. A left mouse-button press somewhere in the word "Reminders".
  73.         In this case, you are taken to the main display screen and the
  74. current list of upcoming appointments is listed.
  75.  
  76.  
  77. ***********************  MAIN DISPLAY WINDOW  *************************
  78.  
  79.      The title line displays Today's date and the approximate number of
  80. minutes until the next "nagged" event. (This line is updated each time
  81. you select "NOW")
  82.      The current list of appointments is displayed in the large area
  83. on the left side of the main display window, each day "headered" with
  84. a date-line. If the appointment or event is within one week of the
  85. currently selected date, the Day-Of-The-Week will be highlighted.
  86.  
  87.  
  88. * CREDIT:  These calendar routines were borrowed from a public domain  *
  89. *            program called "calendar". I hereby thank the author of   *
  90. *                calendar, for saving me a lot of "grunt work"!        *
  91. Calendar gadgets: The year and/or month can be changed by pressing the
  92.                   left mouse button on the "<<<  >>>" marks.
  93.                           (Nag will not update the appointment display
  94.                            until a day of the month is chosen)
  95.                   The current day of the month can be changed by
  96.                   pressing the left mouse button on the selected day.
  97.  
  98.              NOW: Resets Nag to current time and date.
  99.  
  100.             EDIT: Takes you to the "Edit" Screen. (see below)
  101.             
  102.              NAG: This is a "flag". If it is on (lit), the `nag'
  103.                    feature is activated. Off means "Nag is gagged".
  104.                   
  105.           SEARCH: Makes a non case-dependent search of the "message"
  106.                    parts of the entries for the entered string and
  107.                     displays each occurance on the main screen.
  108.                   
  109.           SHRINK: Returns Nag to the "sleeping" mode.
  110.                    (This is the proper way to exit Nag. It remains
  111.                     ready, but in the background waiting. In addition,
  112.                      any changes in the year files are saved.)
  113.                    
  114.             QUIT: Removes Nag from the operating system. Changes in
  115.                    the year files are saved before Nag gives up.
  116.  
  117.  
  118. *************************   EDIT SCREEN  *****************************
  119.  
  120.      The title line displays the date to be edited and the approximate
  121. number of minutes until the next "nagged" event. (This line is updated
  122. each time you make a selection from the Edit Screen).
  123.  
  124.      You are editing ONE day. The day that was set on the `calendar'.
  125. All of the "/\" and "\/" thingies are gadgets. Starting from the upper
  126. left, the first set controls the hours, the 2nd set controls the 
  127. minutes, and the 3rd set controls the line number. You may have up to
  128. 99 lines per day. The hour control gadgets can be used to set certain
  129. visual flags (BIRTHDAY, ANNIVERSARY, !ACTION!) instead of a specific
  130. time. Also, am/pm can be switched by selecting the am/pm gadget.
  131.  
  132.     DELETE removes the currently displayed line.
  133.     COPY   copies  the currently displayed line into the Copy buffer.
  134.     RECALL copies  the Copy buffer into the currently displayed line.
  135.  
  136.      At the upper right is the Nag Flag selection area. You may select
  137. any combination of time periods to be "nagged". (1/4 Hour, Hour, Day,
  138. Week, and/or Month) previous to the "event", and up to 4 "nags" per
  139. time period. For example: if you have selected 1/4 Hourly, Hourly, and
  140. Daily, the number of nags is 2, and the "Nag" flag is "lit" on the 
  141. Main Display Screen, you will be reminded of the upcoming event at 48 
  142. hours, 24 hours, 2 hours, 1 hour, 30 minutes, and 15 minutes before the
  143. upcoming "event".
  144.  
  145.      The fourth set of "/\ \/" gadgets controls the number of "nags".
  146.      (Note that if nags = 0, Nag Flags have no effect.)
  147.  
  148.          DONE: Means you are satisfied with editing this day's
  149.                 appointments.
  150.  
  151.        CANCEL: Means you want Nag to `forget' this editing session.
  152.                 (no changes saved, everything the way it was before
  153.                  you started to edit.)
  154.  
  155.  
  156. To Enter New Appointments:
  157.  
  158.      Make sure you are looking at the "Editing:" screen.
  159.      Use the Line # gadgets to move to a blank line. (highest #)
  160.      Type in the information to be displayed. (up to 45 characters)
  161.      Press RETURN to enter a new "message" string.
  162.      Set the time, nags, and Nag Flag gadgets.
  163.  
  164.                       That's all there is to it!
  165. You can watch your work updating the day's entries in the window below.
  166. When the day looks correct, REMEMBER to select "DONE" to save that day.
  167.  
  168.  
  169. ***************************   SHAREWARE   ****************************
  170.  
  171.   The Concept:  Quality software you get to try in your own computer
  172.                 environment at little or no cost.
  173.                 
  174.     The Pitch:  If you find that you continue to use this software,
  175.                 a $10 donation to the author is encouraged and will
  176.                 place your name on the official "user's list".
  177.                 $15 or more will also get you a disk with the latest
  178.                 versions of Nag and other shareware.
  179.  
  180.  The Address:   Richard Lee Stockton (Nag)
  181.                 21305 60th West
  182.                 Mountlake Terrace, WA 98043
  183.                 
  184.  Bug Reports:   Send to the above address (US Snail) OR:
  185.                 EMail: RLStockton  on  GENIE & PLINK OR:
  186.                 call (voice only!) (206) 776-1253
  187.  
  188. ********************************************************************* 
  189. ********************   La lingua de Amiga?  Si!   *******************
  190. *********************************************************************
  191.                           - Revisions: -
  192.  
  193. Nag Version 0.0    10/28/87     Initial shareware release.
  194.  
  195. *********************************************************************
  196.