			      Readme for xalarm-3

			Welcome to xalarm for X11R4/5

		    Ideal for the permanently late, like me

		     Copyright (c) 1991 by Simon Marshall

		   If you still end up late, don't blame me!


DESCRIPTION
~~~~~~~~~~~

  xalarm is an interactive program analogous to leave(1), only much more
  powerful.

  You can set the alarm either by command line options, or by entering the time
  using the popup window.  The time and date formats are quite flexible and
  natural.  At the appropriate time, xalarm pops up a window to tell you that
  your time is up.  You can tell xalarm to pop up warning windows at specified
  times before the alarm is to trigger in order to warn you of the impending
  alarm.

  If a time is not given or recognised, or a warning time is not recognised, or
  confirmation is required, xalarm prompts for one by popping up a window.
  This gives you an opportunity to change the alarm setting, warnings times,
  and the message xalarm will display when the alarm is triggered.

  This form is suitable for inclusion as a menu option under a window manager.

  You can make xalarm read alarm times and the messages to display from a file,
  the alarms will only be set on the dates specified in the file.  This way you
  can have an appointments file for regular or future dates.

  This form is suitable for inclusion in an X start up or initialisation
  script.

  xalarm allows you to snooze the alarm after it is triggered, to give you an
  opportunity to carry on and be late anyway.  Even after you have set the
  alarm and confirmed it, you can reset the alarm as long as you know the
  xalarm process number: xalarm can list other xalarm pids.

  xalarm makes maximum use of resources, as well as having a number of command
  line options, and these can be used to control most of the appearance of
  xalarm and (just about) all of its behaviour.

  The current xalarm options include:
	-appointments
	-time time
	-warn time[,time...]			-nowarn
	-confirm				-noconfirm
	-warnwords number			-nowarnwords
	-list
	-reset pid
	-snooze time
	-bell	-beep				-nobell	-nobeep
	-help	-version

  Also supplied are xmemo, xfortune and xyow front ends to xalarm.  Note that
  xfortune and xyow require the fortune and yow programs respectively, they
  don't come with this.

  To have a preview of the manual, try something like:

% nroff -man xalarm.man | less		# or "more" if you haven't got "less".
	or
% xalarm -help

  See the file INSTALL for help with installation and problems.


THE END
~~~~~~~

  Xalarm uses Xt & Xaw stuff only, and may well be a useful aid to someone
  trying to learn X, as I was/am.

  You may have problems with X function names if using R3 or earlier;
  application contexts are used, but this should not take much changing - using
  #defines may do most of the job.

  Written in an attempt to learn X Windows in as short a time as possible; it
  may be written badly, but makes as much use of resources as possible.  I
  don't think it is (but I wouldn't, would I?) and I have found it is very
  useful for me now I'm to be responsible for giving lectures...

	Simon.
_______________________________________________________________________________
    Simon Marshall, Dept. Computer Science, University of Hull, HU6 7RX, UK
	     ``"La la la la la la la la la", means I love you...''
			     S.Marshall@Hull.ac.UK
