MONTHTOOL

Section: Misc. Reference Manual Pages (1L)
Index Return to Main Contents
 

NAME

monthtool - a mouse-oriented direct manipulation calendar and reminder organizer  

SYNOPSIS

monthtool  

DESCRIPTION

Overview

Monthtool displays a Suntools-oriented calendar of any month of any year and allows the user to browse the days of that month, and to schedule and recall reminders for that day.

Windows

Month Name Window:
The name and year of the displayed calendar is indicated. Two arrow buttons allow the user to move to other months (up arrow moves to the previous month, down arrow to the following month). A button labelled "Today" moves the calendar to the current month of the current year, highlights today's date in the calendar, and displays today's reminders.

Dates Window:
The days of the month are shown in calendar format. When the user clicks on a date in this window, that date is highlighted and the reminders for that particular day are shown in the Reminder Window. Days that have (most types of) reminders associated with them have a bolder border.

Reminder Type Buttons Window:
Four push-buttons indicating the types of reminders are shown. Clicking on one type will set the reminder that currently has the insertion caret on it (in the Reminder Window) to that type.

Reminder Window:
Reminders for the currently highlighted date are shown. Indicators of the type of each reminder are indicated at the beginning of each reminder line. Reminders may be added, deleted or modified, using the standard textedit features. A type may be set by positioning the insertion caret on the reminder and clicking on the required type in the Reminder Type Buttons Window.

Reminder Types

Reminders may be one of four types:

This day only reminders:
These reminders are one time only events, such as appointments. A reminder of this type has a black box at the front of the message. When one of these is associated with a given day, the border of that date in the calendar will be made bolder, as an indicator.

Yearly reminders:
Reminders that happen once a year, such as birthdays. A reminder of this type has a hollow box containing a "Y" at the front of the message. When one of these is associated with a given month and day, the border of that date in the calendar will be made bolder, as an indicator.

Monthly reminders:
Reminders that happen once a month, such as loan payments. A reminder of this type has a hollow box containing a "M" at the front of the message. When one of these is associated with a given date, the border of that date in the calendar will be made bolder, as an indicator.

Daily reminders:
Constant reminders, things to remember to do. A reminder of this type has a hollow box containing a "D" at the front of the message.

Menu Commands

Available with the right mouse button, except when in the Reminders Window (when the standard textedit menu is available).

Close with Save:
Close the window to the icon and save the reminders in the .monthtool file.

Save:
Save the reminders in the .monthtool file.

Reload:
Reload the reminders from the last version of the .monthtool file.

Quit with Save:
Save the reminders in the .monthtool file and quit.

Note that the standard frame menu (available when in the borders of any window) allows the user to quit and close without saving. Resize, Redisplay, etc. are also available, as is usually the case.

The .monthtool File

The reminders are kept in a file in the home directory called the .monthtool file. This file is kept in a format similar to that used by autocall, used to warn the user of impending appointments. If this feature is required, the time for the appointments must be the first token of the message (after the type indicator) and must be in the format hh:mm or h:mm, 24-hour time.

Each reminder is a line (of length 80 characters or less) in the .monthtool file in the following format:

m,d,y,tttt,s

where m is the one or two digit month number, d is the one or two digit date, y is the year (up to 4 digits), tttt is either 4 blanks (if no time is required) or 24 time in hhmm format, and s is the reminder message. For yearly reminders, the y field is 0 (zero); for monthly reminders, the m field and the y field are 0 (zero); for daily reminders, the d field, the m field, and the y field are 0 (zero).

 

AUTHORS

Sarah Metcalfe
Mike Essex
Rich Burridge  

FILES

$HOME/.monthtool  

SEE ALSO

vcal(1), autocall(1), textedit(1), suntools(1)

"Windows and Window-Based Tools: Beginner's Guide"  

DIAGNOSTICS

Monthtool warning! Invalid record: record
Monthtool error: Cannot open ~/.monthtool file  

BUGS

Although the .monthtool file has a similar format to the .appointments file of vcal, vcal cannot support the yearly, monthly, or daily reminders. If vcal is used on the file, reminders of that type will be lost.  

DATE

24/6/87


 

Index

NAME
SYNOPSIS
DESCRIPTION
AUTHORS
FILES
SEE ALSO
DIAGNOSTICS
BUGS
DATE

This document was created by man2html, using the manual pages.
Time: 06:14:42 GMT, December 12, 2024