packages icon
README:		@(#)README	1.4 7/1/93

WHAT IS XNOTIFY?

	xnotify is similar to xmessage and xnote.  It allows you to
	write a message and pop it up on multiple X displays at once.
	I use it when I want to let a colleague know something that
	isn't worth mail.  It pops up the message on their X display
	and beeps at them (this, of course, requires that you have
	access to their display).

	Additionally, it allows the recipient(s) of the message to
	write a message back, or simply acknowledge the message in some
	way.  The sender can include any of 5 possible answers (yes,
	no, maybe, ack, or respond), and the recipient clicks on the
	appropriate button.

	History: xnotify is a little hack I wrote some time back in
	answer to a particular need.  In our office, I'm in charge of
	the coffee machine.  When the coffee was ready, I wanted a
	quick way to let everyone know, without having to shout down
	the hall.  The first hack was a simple thing that I rsh'ed to
	their machine and popped up.  That wasn't any good, so I wrote
	xnotify.  I did this partly to write something fun, but also to
	see how it could be done.

AVAILABILITY:
	The current version of xnotify is always available from
	ftp.ida.liu.se in pub/lincks/xnotify.shar.gz   This file is
	compressed with the GNU compression utility called gzip.  If you
	don't have gzip, get it -- it's compresses better significantly
	than `compress'.

DOCUMENTATION:
	The man page gives exhaustive documentation on how to use
	xnotify.

INSTALLATION:
	xnotify should be simple to install. 

	0. Read the file COPYING in this directory so that you
	   understand the conditions under which you can use this
	   software.

	1. If you don't have imake and company, edit Makefile.noimake
	   to set the configurable stuff and type:

		make -f Makefile.noimake depend

		make -f Makefile.noimake

   	xnotify should compile correctly.  Then type:

		make -f Makefile.noimake install

   	to install the executable and the man page.

	2. If you have imake and company, edit the Imakefile and note
	   the stuff about the resolve library.  Set that if you need
	   to.  Verify the other stuff in the Imakefile.

	3. Then type:

		xmkmf
		make depend
		make install
		make install.man

   	This should make and install everything that you need.

PLATFORMS:
	* Sun4, SunOS 4.1.2, X11R4, X11R5, OpenWindows.  I've developed
	  xnotify on a Sun Sparcstation running SunOS 4.1.2 and using
	  X11R5.  It doesn't seem to have any R5 specific things, but
	  I'm not entirely sure.  It also compiles under both X11R4 and
	  OpenWindows on the same platform.
	* Sun3, SunOS 4.1.1, X11R4
	* Sequent Symmetry, DYNIX(R) V3.1.1, X11R4 
	* Some time back it was running on an IBM RS6000 under AIX and
	  R5.  This hasn't been tested in a while, so I don't know if
	  it still works.  I don't have such a machine at my disposal.

BUG REPORTS AND IDEAS:
	Please let me know of any bugs you find.  Send mail to
	davpa@ida.liu.se and please include any information you can
	about how to reproduce the bug.  If it dumps core, I'd like the
	output of either `gdb xnotify core' or `dbx xnotify core' as
	well.

	If you have ideas about things that should be included in future
	releases, let me know.

COPYRIGHT:
                  Copyright (C) 1993, David Partain
              Department of Computer and Information Sciences
                   University of Linköping, Sweden (*)
                       581 83 Linköping, Sweden
                          davpa@ida.liu.se

	xnotify is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as
	published by the Free Software Foundation, version 2 of the
	License.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public
	License along with the programs; if not, write to the Free
	Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
	USA.

(*) Linköping == TeXish Link{\"o}ping if you can't see 8 bit characters