
\def\apptsfilesystem{kkkken}

\font\titlefontone = ncs-bolita scaled\magstep4
\font\titlefonttwo = ncs-ita
\font\introfont = t-ita
\font\partfont = t-bol scaled\magstep2
\font\sectionfont = amdunh10 scaled\magstep1
\font\bodyfont = t-rom
\font\bodyit = t-ita
\font\bodybf = t-bol
\font\bodytt = c-med
\font\bodyttit = c-obl

\def\appts{appts}
\def\Appts{Appts}

\centerline{\titlefontone APPTS}\smallskip
\centerline{\titlefonttwo managing your busy life}\bigskip

\centerline{\hbox{\vbox{\parindent=0pt\parskip=\baselineskip\hsize=4in\introfont
This document is in three parts: How to do useful things with \appts,
What \appts\ can do, and How \appts\ works.  Normal humans should read
as much as is interesting starting from the beginning.  Hackers can read as much
as is interesting starting from the end!}}}

\bodyfont\let\tt=\bodytt\let\rm=\bodyfont\let\bf=\bodybf\let\it=\bodyit
  \let\ttit=\bodyttit
\def\ex#1#2\par{{\parskip=0pt\noindent\hskip 1cm
	\ttit #1\tt #2\par}}
\def\ap#1\par{\ex{appts:\ }#1\par}
\def\athena#1\par{\ex{athena\%\ }#1\par}
\def\part#1{\bigskip\centerline{\partfont #1}\bigskip}
\def\section#1{\bigskip\leftline{\sectionfont #1}}
\parindent=0pt \parskip=\baselineskip
\part{How to do useful things with \appts}

\section{Starting \appts}

To make \appts\ useful, you'll need to make some changes to your dotfiles.
This means adding the following lines to your {\tt .environment} file:
\medskip
\ex{}attach \apptsfilesystem\par
\ex{}/mit/\apptsfilesystem/\$bindir/apdaemon\par

The second command invokes the ``daemon'' that will actually sit there
sending you reminders.  Don't put an ampersand after the {\tt apdaemon}
command or \appts\ won't go away when you log out!

\section{Simple appointments}

Now let's enter the \appts\ program itself.  Type:
\medskip
\athena /mit/\apptsfilesystem/\$bindir/appts

The important command here is {\tt add}.  Here's a bunch of examples of
it:
\medskip
\ap add today 5:00 pm - It's time to leave!!\par
\ap add tomorrow 9:00 am - Don't forget your meeting at 9:30...!\par

So the basic idea is you type {\tt add}, a day, a time, a dash, and a
message.  You can also type in specific dates, as in
\medskip
\ap add 4/1/90 10:33:10 am - All your files were just erased.\par
\ap add 4/1/90 10:33:15 am - (april fools.) \par

\section{More power to the reader}

Look at this:
\medskip
\ap add 12/25/* - I can't believe you're logging in today.\par

This example has two interesting features.  First, the {\tt *}
means, good on any year.  So this reminder will stay around until you
delete it!  Second, notice the time was omitted.  This means you'll get
the reminder on that day each time you log in.  There are a few more
convenient ways to do dates:
\medskip
\ap add this thursday 3:00 pm - The thursday after the current day\par
\ap add next wed 2:00 pm - or the wednesday after that. \par
\ap add every mon wed fri 11:00 am - You're late for class!!!!!!\par

The last form is really useful.  Oh, a quick note on the {\tt this} and
{\tt next} forms: if today is Saturday, and you enter {\tt this sat},
that'll mean the same as {\tt today}.  Also, {\tt next} is always one
week after {\tt this}.

\penalty -1000

\section{Reminder levels}
\nobreak
Ok, so you have an extra-special appointment and you want a few
reminders before the time.  \Appts\ provides a reminder level
option that will have reminders sent to you before the actual time of
your appointment.

There are four levels of reminders.  Reminder level {\tt 1} sends you a
reminder 30 minutes before.  Reminder level {\tt 2} sends you (in
addition to 30 minutes before) a reminder
when you log in on the day of the appointment.  Reminder level {\tt 3}
sends you a reminder each day the week before the appointment as well.  Fianlly,
reminder level {\tt 4} sends you one reminder a week during the {\it
month} before!  

To add a little more confusion, you can specify two more numbers along
with the reminder level.  The first lets you specify how many minutes
before... ETCETERA

\medskip
\ap add 12/31/* 11:59 pm rem 1 - Give me a reminder 30 minutes before\par
\ap add 12/31/* 11:59 pm rem 1.45 - Make that 45 minutes before\par
\ap add 12/31/* 11:59 pm rem 1.15.4 - 15, 30, 45, and 60 minutes before\par 
\ap add 12/31/* 11:59 pm rem 2 - When I log in that day, and 30 minutes before\par 
\ap add 12/31/* 11:59 pm rem 3 - That, and one a day the week before\par
\ap add 12/31/* 11:59 pm rem 4 - That, and one a week the month before\par
\ap add 12/31/* 11:59 pm rem 4.10.12 - See below for a full list!\par

So the last command gives you reminders: (1) 10, 20, 30, $\ldots$, 120
minutes before; (2) each login the day of; (3) once each day the week
before; (4) once each week the month before!  All with one command.

\section{Other commands}

The only other important commands are {\tt quit} and {\tt ls}.  The
latter gives you a listing of all pending appointments.  To delete
appointments, for now you need to bring the file {\tt .appts}
into emacs, find the line with the appointment you don't want and delete
it.

\part{What \appts\ can do} 


\part{How \appts\ works} 

\bye
