Remember registers the command Remember for use in the CommandTool. For example, "Remember to meet with Ralph at 1pm" will register an event which will be posted at 1pm today (or 1pm tomorrow if it is already past 1pm today), and whose text will consist of the given string. The time of the event is obtained from the text using the Tempus date and time parser, which can handle partially specified times such as "in 20 minutes", "Thursday 4pm", "a week from tomorrow", etc. If the parser is unable to find a date and time, the Remember command will give an appropriate error message, the event can then be reentered with the time specified more fully.

If '/' appears in the command, the text of the reminder is the command line up to that point, and anything following `/' is interpreted as parameters for the reminder (see discussion of Remember Options below). For example, "Remember Dealer Wednesday 1:15pm / Repeat Weekly Duration 60" will register an event which will be posted every Wedneday at 1:15pm with duration 60 minutes.

Whenever an event is successfully registered, the event file will be rewritten so that if the user boots or rolls back newly entered reminders will not be lost.

Remember allows users of either the Walnut or Peanut mail system to enter an event that is described in an electronic message by simply clicking the Remind menu button. When both Walnut and Remember system are loaded (in either order), each Walnut message viewer will contain a Remind menu button. Clicking this button will cause an event to be entered the contents of whose reminder will consist of the corresponding walnut message. The time for this event is obtained by parsing the Subject field of the message using the time the message was sent as the base time. For example, if the subject is: "CSL Seminar at 1:30", then the event will be entered for 1:30 pm on the day the message was sent.

The contents of the Subject field can be augmented for the purposes of Remember by selecting additional material. This material is effectively prepended onto the Subject field for the purposes of obtaining the time. For example, if the subject of the message is: "CSL Seminar in the Commons" and the Remind button is clicked, the message window will flash "Specify (select) a time for the event". If the phrase "Thursday 2nd June at 1.30" appears somewhere in the message (or elsewhere), then selecting these characters and clicking Remind will cause the event to be entered for the corresponding time.

As with the Remember command, if '/' appears in the selected text ('/' in the Subject field is ignored), the material that follows the '/' is interpreted as parameters for the event. For example, if the subject of the message is "Rob Pike / Blit Tape 1:30 today", and the user selects: "/ LeadTime 30" and clicks Remind, then the event will be entered for 1:00pm.

When both Peanut and Remember are loaded (in either order), the Remind menu button is posted in the Peanut control window. To enter a Peanut message as a reminder, first place the selection anywhere inside of the corresponding message, and then click the Remind menu button located in the Peanut control window. As with Walnut, the contents of the selection are effectively prepended to the Subject field for the purpose of specifying the time of the event and other parameters.

If you want to see whether an event you entered will really be posted at the right time with all the right options, you can tell Remember to pretend its some time in the future for the purposes of posting reminders by using the PretendIts command. For example, "Remember Dealer Wednesday 1:15pm / Repeat Weekly Duration 60", followed by "PretendIts Wednesday 1:15pm" will post the corresponding reminder notice. If you destroy a reminder that was posted as a result of a PretendIts command, it is not removed from the system, since it is assumed that you were only just testing things out. However, you can remove such an event by using the Forget button described below.

If you want to see a range of events, such as all the reminders that will be posted tomorrow, you can tell Remember to pretend its some range of times in the future by using the ShowReminders (also called ShowRem) command. For example, "ShowReminders now UpTo noon Thursday" if its Tuesday morning at 9 AM will show all the reminder events (as if PretendIts had been called for each of them) from Tuesday morning at 9 AM until Thursday at 1200 hours. Or, ShowRem April UpTo May will show you all the reminders to be displayed in the month of April.

The Remember system recognizes a variety of parameters in connection with the posting of a reminder notice, such as Duration, Repeat, IconFlavor, etc. These are listed and explained in the section on Reminder Parameters below. However, typically the user does not specify such parameters explicitly, i.e. by typing or selecting them when an event is entered, but instead specifies them implicitly by the appearance of various keywords in the text of the event. These keywords are defined via the Remember.KeyWords entry of the user's profile. Whenever a keyword is encountered in the text for an event, the corresponding default parameters are implicitly specified, i.e. will be used unless the parameter is also explicitly specified in the event. For example, including in the Remember.KeyWords entry in your profile: "Meeting: Duration: 60, IconFlavor: Meeting" means for each event containing the word `Meeting' (where containing means in the case of an exec command that the word appears in the command line, and in the case of an event entered via the Remind button, that the word appears either in the Subject field of the message, or in the selected material), use a Duration of 60 minutes and the IconFlavor Meeting, unless of course these parameters are also specified explicitly via the '/' mechanism.

Below is the Remember.KeyWords entry contained in Remember.Profile. It is intended that the user add to, delete from, or otherwise modify this entry to suit his own tastes.

Specifies the default duration for events, in minutes. If no duration is specified in the event, or via a keyword contained in the event, then this duration is used. -1 means infinite duration.

Specifies the default leadtime for events, in minutes. If no leadtime is specified in the event, or via a keyword contained in the event, then this leadtime is used.

Specifies the name of the file in which Remember should look for its events and on which it should write new ones. Remember.EventFile must be the full path name of a file on the local disk. Non-full names can cause problems depending upon what directory Remember is in when started up and remote files cannot be written on using FS.

If TRUE, each reminder that is posted or deleted is also written to the log file named by Remember.LogFile.

If Remember.CreateLog is FALSE, then each reminder that is posted or deleted is also written to this log file.

Defines the mapping between an IconFlavor and the corresponding icon. (This profile option is actually implemented by the IconRegistry package, of which Remember is a client.) For example, if the keyword Forum specifies the IconFlavor Meeting, then Meeting might be defined by including Meeting: Remember.Icons 3 in the RegisteredIcons entry in your profile.

Here is the RegisteredIcons entry contained in Remember.Profile. It assumes that Remember has been brought over to the Commands subdirectory.

Note that the icon file need not be on your local disk, e.g.