X'di /"finish diversion--previous line must be blank
X.nr nl 0-1 /"fake up transition to first page again
X.nr % 0 /"start at page 1
X';__END__
X.TH XCALENDAR+ 1 "Aug 11, 1992"
X.AT 3
X.SH NAME
XXcalendar+ \- Provides reminders from xcalendar files
X.SH SYNOPSIS
X.B Xcalendar+ [-A] [-a] [-t x] [-w]
X
X.B Xcalendar+ [-l] [-L lim,date] [-r mon]
X.RS 11
X[-m mon] [-x] [-o file]
X.SH DESCRIPTION
X.I Xcalendar+
X
Xxcalendar+ is intended to provide a mechanism for the user to be reminded of daily appointments, memos, etc. In much the same way that the unix command 'calendar (1)' will send mail to the user based on information in their .calendar file xcalendar+ will look in the files generated by 'xcalendar v3.0' and will send mail to the user. However, instead of the mail being sent to the user when the command is run, when possible it is sent a pre-determined number of minutes prior to the appointment. This is u
Xnlike 'calendar' which only sends one message containing all the appointments for the day at one time. Used in conjuction with 'xmail' which rings the terminal bell and signifies newly received mail (or an equivalent mail package that supports 'biffing') xcalendar+ acts as an alarm to notify the user of an impending appointment.
X
Xxcalendar+ only schedules mailings for the current day. Any changes made to future dates will not require rerunning xcalendar+. However, any changes made to the current date on the xcalendar will require that you rerun xcalendar+ in order to adjust for the changes to the day's activities (it is suggested that updates be done with the -a flag. See below.)
X
Xxcalendar+ is most useful when put in a crontab file to run
Xearly in the day or when put in a user's .login file.
X.TP 10
X-A
XFull alarm. This will mail all memos and schedule appointment mailings according to the Calendar file. It is suggested that this be utilized in a crontab file to run once before the workday begins.
X
X.TP
X-a
XThis will only schedule appointment mailings and will NOT mail memos. This is best used after a change has been made to the current day's schedule. There is no need to re-mail memos. It is suggested also that this be utilized in a crontab file to run at regular intervals during the day (ie. every hour) if you make frequent changes to your calendar during the day.
X
X.TP
X-t x
XWill mail the user 'x' minutes before the appointment. If the user does not wish to schedule a mailing for each appointment but rather wants one mailing at run time then this value should be set to 0 (zero). Valid entries for scheduled mailings must be in the form
X
X.RS 10
XHH:MM[aApP[mM]] MESSAGE
X.LP
XThe am/pm qualifier is optional but will be affected by the -w option described below. No white space can appear between the HH:MM and the qualifier however any number of white spaces/tabs can be inserted between the time and the message. If the first field of a line does not begin in the HH:MM format it will be assumed to be a general memo and will be mailed to the user at run time.
X
X.LP
XScheduled mailing entries would be:
X
X.RS 5
X.PD 0
X.LP
X10:00 Meeting, 100 Office Building
X.LP
X10:00a Meeting - 100 Office Building
X.LP
X10:00PM Meeting at 100 Office Building
X
X.RE
X.LP
XMemo entries would be:
X
X.RS 5
X.LP
X100 Office Building - Meeting
X.LP
X1000A Office Building, Meeting
X.LP
X.RS 3
X(Meaning Room #1000A, NOT the time 10:00A.)
X.RE
X.LP
X1000A Office Building, Meeting @ 10:00.
X.RS 3
X(Would NOT be mailed x minutes before 10:00.)
X.RE
X.RE
X
XREMEMBER:
X.LP
XTime entries must be the first field in each line and must contain a colon (:) If the line does not begin in the format 'HH:MM' it is assumed to be a general memo and will not be mailed x minutes prior to the appointment, but rather at runtime.
X
X.RE
X.PD
X.TP
X-w
XAssumes an 8:00am to 5:00pm workday. In other words, if the user makes a calendar entry for 3:00 with no qualifier (ie. am or pm) 3:00pm or 15:00 is assumed. This is intended to make calendar entries less cumbersome.
X
X.TP
X-l
XTo list the appointments for the default number of days from today.
X
X.TP
X-L [lim,[start]]
XTo list the appointments for a specified number of days from the specified start date. If start date is omitted the default is today. If the value of lim is negative than this is taken to mean the number of days prior to start date.
X
X.TP
X-m mon
XTo specify a month other that the current. This is to be used in conjuction with the -L option where a start date is specified. Using the -m flag without the -L flag defaults to the entire month.
X
X.TP
X-o file name
XTo specify an output file other than the default (HOME/Calendar/Appt_file) Unless a fully qualified path is specified all filenames will be in reference to HOME/Calendar.
X
X.TP
X-x
XTo send all output to an XEDIT window. NOTE: Changes made in this window will NOT affect the daily xcalendar files.
X
X.TP
X-r mon
XTo remove ALL files for the specified month. You will first be promted as to whether you want to compile a summary report for that month before removing the files.
X.SH ENVIRONMENT
XNo environment variables are used.
X.SH FILES
X~/Calendar/xcDDMMYY
X.SH AUTHOR
XEric Katz
X.SH "SEE ALSO"
XXcalendar (1)
X.SH DIAGNOSTICS
XWill complain if user does not have 'at' priveledges.
X
X.SH BUGS
XNone.
X
X
X
END_OF_FILE
if test 17940 -ne `wc -c <'xcalendar+'`; then
echo shar: \"'xcalendar+'\" unpacked with wrong size!
fi
# end of 'xcalendar+'
fi
echo shar: End of archive 1 \(of 1\).
cp /dev/null ark1isdone
MISSING=""
for I in 1 ; do
if test ! -f ark${I}isdone ; then
MISSING="${MISSING} ${I}"
fi
done
if test "${MISSING}" = "" ; then
echo You have the archive.
rm -f ark[1-9]isdone
else
echo You still must unpack the following archives: