SNAG by Paul Falstad
        5415 Abbott Place
        Edina, MN 55410
        PLink: HYPNOS
        GEnie: P.FALSTAD
        CIS: 70016,1355

This is a shoddily written but extremely useful program I wrote to help me
remember to do things.  To use it, follow these steps:

1. Write up a SNAG.DAT file, or modify the example file given, that contains
   what you want SNAG to remind you of.  Read the example file.  Each entry
   is in the following format:
   
[-----------41 char text field--------][--6 char date--][1 char modifier]

   If you need more than 41 characters, use two or more entries, as shown in
   the "buy books" example in the example file.  The date is in the format
   MM-DD-YY.  The modifier is optional.
   
   If no modifier is given, SNAG will remind you to do whatever the entry
   specifies until you delete the entry from the file.  But if you do specify
   a modifier, SNAG will display the entry and then increment the date.
   Legal modifiers include:
   
   * weekly  ] daily  ! every other week  & yearly  ^ monthly
   
   For example, when SNAG reads an entry with * at the end, it will display it
   and then increment the month.  You will not be reminded of the entry again
   for another month.
   
   Put SNAG.DAT in your S: directory.
   
2. Put SNAG in your startup-sequence.  You don't have to RUN it; it returns
   immediately.

So from now on, when you boot the machine, SNAG will check the S:SNAG.DAT file
to see if there's anything on your calendar for the day.  If so, it will open
a screen and display all the entries pending for the day, and increment their
dates if necessary.  Getting rid of the SNAG screen is difficult -- it's
supposed to be.  To close it, either use ScreenX (a very useful utility), or
use RudeFuncs' CloseScreen command (the address of the Screen structure is
shown at the bottom of the screen).  Otherwise, just leave it in memory.

If there is anything on your calendar for the day that is not a periodic event
(i.e. it doesn't have a modifier; it's not daily, weekly, monthly, etc.), SNAG
will remind you to do it until you actually go in and edit the SNAG.DAT file.
You can do one of two things: (1) delete the entry.  In this case, SNAG
assumes that you've taken care of the matter, or that you will not forget, or
that you don't care.  SNAG is not responsible if you delete the entry and then
forget to take care of it.  If you delete the "buy books" entry and then
forget to actually go out and buy books, I am not responsible.
(2) procrastinate -- increment the date yourself.  This is not wise.

I assume that, if you use this program, you either set the date every day, or
have a clock/calendar device.  Otherwise, it's not very useful, is it?

When an event is dated, for example, 02-01-90, it will be triggered if SNAG
is run when the system date is greater than 3:00:00, Febuary 1, 1990.
The 3 am cutoff is useful for people who stay up and hack late at night and
don't like getting the next day's messages if they reboot after midnight.
Dedicated hackers may want to increase the cutoff to 5 am or 11 am.

This program and its code are public domain.  I am not responsible for any
damages caused indirectly by this program (or directly, for that matter).
If somebody wants to take the time to go through and make this program easier
to use (I'm too lazy), he may, on the sole condition that he send me a copy
of his work (for my use).  I suggest, however, that you not make it TOO easy
to make the screen go away, or to delete an entry.  For nagging to be
effective, it should be hard to shut off.