If you have any problems using petey or installing it, feel free to email
me at s2mdalle@titan.vcu.edu and I'll help you as much as I can.  Also,
see http://members.xoom.com/uruk/index.html

If you are running Risc OS, please see RISCOSReadme
Petey has been compiled and installed on SunOS, Linux x86, AIX (PPC),
Acorn RiscOS, FreeBSD, and we've heard rumors about IRIX.  It should 
compile on just about any unix though.

To install petey, simply run

make
make install

If you get some warnings or errors in your compile, edit Makefile and take
out the -pedantic flag.  I don't get any errors, but depending on your 
platform you might.

Optionally, you can run "make restore" which will remove all of the compiled
object files from the disk and get you back to what you would have had had
you just untarred and unzipped the package.  I've also included makefile
rules so that you can compile all the source to assembly files, if that's
the type of thing you're into.

It will install to /usr/local/bin.  You need to have write permissions to
/usr/local/bin in order to run the script, aka be root.  Otherwise just
edit the Makefile, (the PREFIX variable is where you want it installed) it's
really not hard, and have it install the program where you want it to be
installed.  That way you can use it within your home directory if you
don't have root.  Damn root, you don't need him!  :)  Please ignore any
gratuitous warnings that the compiler spits out at you. (at most 3 or 4)
I'm working on getting it to compile perfectly on multiple UNIX's so bear
with me.  If you have compiled it on a system and you are getting specific
warning messages, mail me what's going on and I'll do my damndest to fix
it.

To use petey, change directories to /usr/local/bin (or whever you
installed it) and run the program.  Petey.doc explains all of the
different command line options.  Also, since version 0.99 a .petey file is
created in /etc/.petey  If you need it in another location, then just put
it in your home directory.

To use the program everytime you login for fun, add these lines to your
.bash_profile file in your $HOME directory:

cd /usr/local/bin (or wherever you installed petey)
./petey Ub	  (blurt something without usage - see Petey.doc )
cd $HOME

If you want to run petey as a small CGI program, check out install-cgi.sh and
uncomment the needed lines.  You will need to be root to install it that
way.  The default paths are /home/httpd/ for apache.  If you need any help
with that, please email me.  s2mdalle@titan.vcu.edu

The program was mainly meant to blurt out one liners and quick stories
right after you login, or to be used like the "fortune" program.  I
realize that some people might not be huge fans of the data I provide with
petey, but the whole point of petey is to do away with the data I give you
and make your own, so enjoy.

Petey.doc also contains information on how to customize petey's databases
so that it will do whatever you want it to do.

Whenever I get around to it I'll actually write a makefile for petey.  It 
doesn't really need it at this point though, IMHO

This product comes with FREE 24/7 tech support at s2mdalle@titan.vcu.edu
it also comes with unlimited downloads, upgrades, documentation, and if
you send me $5, it comes with a party hat too, just like any good GNU
software should.  :)

s2mdalle@titan.vcu.edu
http://members.xoom.com/uruk/index.html
http://www.lowrent.org/uruk/index.html

