README FILE FOR XINSULT VERSION 1.0


Program: X-Insult 
Version: 1.0
Author:  Roger J. McNichols
Date:    03/18/1999

Copyright 1999.  All Rights Reserved.



DESCRIPTION:  

X-Insult is modeled after the cute AutoInsult program "INSULT.EXE" 
written by Jon Roch-Berry for Windows '95 et al.  It was developed 
using the Xview and X11 programming interface tools.

The program hurls random Shakespearean-sounding insults
at anyone who will listen.



INSTALLATION:

If you downloaded the xinsult binary executable, simply install it in 
a directory like /usr/local/bin or /usr/local/games.

If you downloaded the source package, xinsult_1.0.tgz, use
the following steps:

1)  Unzip the package using 'gzip -d *.gz'
2)  Untar the resulting .tar archive:  'tar -xvf *.tar'
    This will create the ./insult  directory and install the 
    program components under it.
3)  Use 'cd insult'  and then compile the source code with
    'make xinsult'
4)  Copy the resulting executable to a directory like /usr/local/bin
5)  Install the man page for xinsult:
               'cp xinsult.6.gz /usr/local/man/man6'



CUSTOMIZATION:

You may customize the word-list for xinsult by editing the 
three files: dat.first, dat.second, and dat.third and 
re-compiling the source code.  You may also change the 
Shakespeare image by copying another X11 Bitmap file to 
the shak1.xbm image file and recompiling the source.  The 
program is set up to display a 111x138 pixel bitmap.



BUGS:

*  Like many xview programs under non-openlook window managers, 
   xinsult tends to summarily ignore geometry specifications.

*  The random number generator for the insult choosing always 
   starts in the same place and repeats the same pattern.  
   An easy fix for this would probably be to include the time.h
   library and use the time in seconds as a seed for the generator.
   I was, however, too lazy to do so...



BUG REPORTS:

Why bother? but... If you MUST:

email to: roger@mcnichols.tca.net
Subject:  xinsult



DISCLAIMERS:

* This program is provided expressly WITHOUT WARRANTY of any kind.
* The author is not responsible for any damages incurred from use
  of this program in any fashion.
* Some of the words are probably not actual words.
* Bill Shakespeare may not have written all of the plays attributed
  to him.