
TITLE:              XWatch: short installation guide

Chapter 1: Compiling xwatch

    This file is automatically generated from doc/xwatch.dm. Please 
    also read the full docs in HTML format as doc/xwatch.html or in LaTeX 
    format as doc/xwatch.tex. A poor-mans document is doc/xwatch.txt, 
    that's plain ASCII for those who can't handle HTML or LaTeX.

    Please note (again) that you don't have to compile your own version: if
    you are using a Linux system based on ELF executables, you can use the
    binary in bin-linux/xwatch. But if you really want to compile all,
    follow these steps.

	o  You will need the XForms library and include files to compile
        xwatch.  Check the Makefile in the src subdirectory for
        two ftp sites that carry XForms for Linux. Obtain the library and
        install it. (Even if you don't want to compile XWatch, you'll need the
        shared libraries. They may or may not already be installed on your
        system.) XWatch will happily run with XForms version 0.81.

	o  In the src subdirectory, edit the Makefile and adjust
        some defines at the top. E.g., a make install copies the binary by
        default to /usr/local/X11/bin; adjust that if you don't like this
        behavior.

	o  Next, do a make install, followed by a make clean.

        o  Copy the file XWatch.ap from the source directory to 
        /usr/lib/X11/app-defaults/XWatch. Edit the file and state your 
        favorite settings.

        o  Next, start the program xwatch with some file arguments in 
        your logfiles directory. If you're satisfied with the appearance and 
        workings of xwatch, add the invocation to your script that starts
	an X session.

Chapter 2: Copyright and such 

    I reserve the copyright to xwatch. If you have useful additions,
    please mail the maintainer, Frank Brokken (frank@icce.rug.nl) with 
    your requests or source diffs and let him make a new distribution. 
    Don't hack the sources and redistribute your own: we at the ICCE hate
    encountering `our' programs with a version number that we don't even know
    of. However, you are permitted to distribute xwatch, provided that you
    (a) distribute it with the full sources, and (b) that you leave this
    documentation and copyright notice intact.

    Copyright policy:  MegaHard (who wants a Microsoft?), PostcardWare (send
    me a postcard from abroad if you like it), but really: GPL, see one of the
    files COPYING on your hard disk.
