$Header: INSTALL,v 1.8.1.1 95/05/11 03:55:43 stevens Exp $

		Welcome to pei - Perl Empire Interface

  The pei manual is rather long, and if you're like me, you'll just
want to take pei out of the box, plug it in, and see what it does.
Here's how you can do just that:

If you already use eif:
  Type "pei" at your unix prompt.
  pei will then convert your ~/.eifrc into ~/.peirc, and you will be
  faced with the familiar "Local%" prompt.  To connect to a game, type
  the game name.  (Note: pei does not have a "connect" command.)

If you have never used eif:
  The quickest way for you to start is to type something like
    pei mycountryname mypassword game.host.name 1617
  at the unix prompt, or to change the four lines at the top of the
  file called "pei".  However, you are STRONGLY ENCOURAGED to do the following:
    1. Copy the file called "example.peirc" to ~/.peirc.
    2. Remove the aliases in this file that you don't like.
    3. Edit the game stuff at the bottom, specifying the host, port, etc
       of the games that you want to connect to.  
  PEI should work without ~/.peirc, however I have heard that it doesn't
  always work quite right, so use ~/.peirc to be safe.  (Note that
  you'll only be able to access multiple games if $country is NOT
  defined at the top of pei.)

If you use IRIX:
  Chances are the readline package won't work on your machine, so you
  should just remove the readline.pl file by typing:
    rm readline.pl

Now for the magic:
  After you break, type "nova" and watch pei explore the entire island
for you.  Once you've got ships, assault an island with about 30 mil,
and then next update type "nova" again and pei will explore that
entire island too.  Make sure that your #0 realm is big enough,
because nova won't explore off the edge of a map.

  Once you've got lots of civs, and maybe you've bridged to a
neighbouring island, use "cmvr" to migrate your civs to the "New
World".  If you don't have alot of civs, but you want to spread them
out, then you can type something like "cmvr 50", and pei will try to
get 50 civs into each sector.

  If there is food in your game, type "setfood" and then "fmvr" to
get the right amount of food to all your sectors.

pei has lots of other neat features, but I'll let you read about
them in tools.man and pei.man.

These are the files included in this distribution:
  README        Things that users of older versions of pei will need
                to know about this latest version.
  INSTALL       Installation instructions.
  BUGS          A list of known bugs.
  CHANGES       A record of what got changed with version upgrades.
  WISH_LIST     Changes that we hope to implement in the future.
  pei           The program you run.
  readline.pl   Readline package.
  parse.pl      Parses server output into internal database.
  tools.pl      Contains tools (nova, cmvr, ...).
  mail.pl       Contains mail, wmail, tele, and anno tools.
  simu.pl       Contains the "simu" tool.
  example.peirc Stuff for you to put in your ~/.peirc file (NOTE: don't
                make a ~/.peirc file until pei has had a chance to
                convert your ~/.eifrc into ~/.peirc).
  pei.man       Pei users manual--you can also get this by typing "help pei"
                from within pei.
  tools.man     Manual for pei tools--you can also get this by typing
                "help tools" from within pei.
  hacker.man    Information useful to hackers.

ENJOY!

Ken Stevens, a.k.a. Buster, ruler of children
children@empire.net
