Petey - The Mother Of All Programs - by David Allen - s2mdalle@titan.vcu.edu
Acorn RISC OS port by iain truskett, koschei@ozemail.com.au

http://www.lowrent.org/uruk/index.html
    RISC OS binaries and easy compile source are provided at
       http://koschei.shada.com/software/
       by iain truskett, koschei@ozemail.com.au.

Please read Petey.doc for background, information on switches, and any
other questions you might have.

For information on the licensing, read LICENSE or Petey.doc.  Also do
yourself a favor and read DISCLAIMER and disclaimer.txt.

IF YOU RUN RISCOS (iain writing here):

If you just want to run the thing, it's easiest if you obtained the
copy with the precompiled binary from my website. If you want to be
able to compile petey on risc os, you can do the following.
(basic assumption: your c compiler is gcc. i don't have any other c
compilers so can't test with them).

Make two folders. One named 'unix', the other named 'riscos'. Put the
contents of the petey tar gz file into the 'unix' folder. Settype
"riscos-sources" to 'obey' and then run that file. That should have
converted the unix version into a properly laid out risc os style
source base.

To use with gcc, just change directory to the riscos folder and type
"j" at a command prompt. gcc should define "riscos" so that the right
paths and so on are used. after compilation you will have a petey
executable. now is probably the time to rename the 'riscos' folder to
'petey' and copy/move it onto your run path (e.g. into !Boot.Library ).
then you can just type "petey" at a command prompt anywhere and have it
run.

The choices file inside your shiny new 'petey' folder, points to where
petey looks for its data. The default value is just fine.

If you have any additional questions about RISC OS and petey, please
contact iain truskett, koschei@ozemail.com.au. David Allen neither runs
risc OS nor does he pretend to know the first thing about it. :)
[a wise man that david chap - iain]

For a precompiled binary of petey for RISC OS, check out
      http://koschei.shada.com/software/



INFORMATION FOR EVERYBODY

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.

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
