Petey - The Mother Of All Programs - by David Allen - s2mdalle@titan.vcu.edu
Acorn RiscOS port by Iain Truskett, koschei@ozemail.com.au

http://members.xoom.com/uruk/index.html
NOTE THE CHANGE OF WEB PAGE FROM THE OLD ONE, WHICH WAS
http://www.lowrent.org/uruk/index.html
The hostname for this old one apparently isn't working anymore.  Go
figure.

RiscOS binaries are provided at http://koschei.shada.com/software/
by Iain Truskett, koschei@ozemail.com.au.

Quick guide:  If you want to install petey, read INSTALL.  If you want the
documentation, read Petey.doc.  

For information on the licensing, read LICENSE or Petey.doc.  Petey is 
Free Software, not to be confused with WaReZ iS PhR33 d00dZ!!
Software.  READ the DISCLAIMER and disclaimer.txt or be reamed by a herd 
of pygmy hitmen.

IF YOU RUN A UNIX:
To install petey, just execute the following commands on
your system.  Note you must have some priveledges on the machine in order
to copy the files into /usr/local/bin.  (Of course)

export $DEST=/usr/local/bin/
make
cp petey $DEST
mkdir $DEST/DATA
cp DATA/*.data $DEST/DATA
echo "$DEST/DATA/" > $DEST/.petey

IF YOU RUN RISCOS:
Read the RISCOSReadme file that comes with the sources 

INFORMATION FOR EVERYBODY (RiscOS users keeping in mind the above line)

In order to use petey you MUST create a .petey file in the same directory
as the binary.  All this file should contain is one line with the name of
the directory of the datafiles, for example /home/user/petey/data/  (The
trailing slash is needed).  I'm going to put something in the installation
so that it will create a .petey file for you, but if you install it
elsewhere, it won't work without editing.  With the .petey file, you can
customize where your datafiles are, so that you can have multiple sets
without having to move all the data files.

If you know a little bit about the web and perl, check out web.cgi, a perl
script that I wrote to CGIze petey.  Hope it works out for you.  I really
threw that together pretty quickly so if I had to attach a version number
to it it would be .000001 Alpha.  Send me suggestions if you think it
blows.  Or change it and send me a copy.

Every effort has been made to keep petey's code clean and modularized so that 
it's more understandable for the beginning C programmer.  It is getting a
bit more messy with an attempt to be portable and more features creeping
in.

Petey also has his comments formatted in cdoc format.  It's a perl program
that I wrote in order to document source files for easy browsing.  You can
find cdoc at my webpage http://www.lowrent.org/uruk/index.html

Petey is a new type of software released under the GPL.  In addition to
the terms of the GPL, there is one more condition that you must meet in
order to use petey on a regular basis.  This concept is called SEXWARE.
The idea of sexware goes back quite a long time, back to the very origins
of programmers who are pro-sex.  The basic idea is, if you want to use the
code in any way, you are encouraged to have sexual intercourse once per
use of the program.  Now I've heard of people putting a call to petey in
their .bash_profile so that it runs each time you login.  That can add up
to lots of sex, but then again, I trust you're up to it.  Of course since
the GPL doesn't include references to sexware, you're not REQUIRED to have
sex each time you use the program, but you're encouraged to, and it
certainly would pep up my developments if I knew people were getting laid
as a result of my software.  WARNING:  abiding by the sexware licensing
conditions may cause your keyboard to get sticky.  I, the author, disclaim
all responsibility for damage caused to any computer hardware as a result
of projectile bodily fluids associated with use of the program.

These fine source files created with PICO and the ultimate editor, EMACS, 
and occasionally vim, just because it's pretty goddamn nifty if you ask
me.

Again, profuse thanks are in order to Iain Truskett,
koschei@ozemail.com.au for his work on the Risc OS port.  His page should
be carrying binaries of petey for the Risc OS.

King of Chaos, Conniver Extraordinaire, or just another Schmo, 
David Allen
s2mdalle@titan.vcu.edu
http://www.lowrent.org/uruk/index.html
