lcity098.readme    (c) I J Peters 1995,1996.

WHAT IS LinCity?

LinCity is an SVGALIB and X based city/country simulation game for Linux.
(Solaris 2.5 and HP_UX are ALPHA at this time, but have been reported to
work.)

You are required to build and maintain a city. You must feed, house,
provide jobs and goods for your residents. You can build a sustainable
economy with the help of renewable energy and recycling, or you can go for
broke and build rockets to escape from a pollution ridden and resource
starved planet, it's up to you. Due to the finite resources available in any
one place, this is not a game that you can leave for long periods of time.

The code is still BETA, and is the first upload to Sunsite, but it has been
avaiable on other sites for some time. I hope to upload the Gamma and then
the 'final' version within the next month or so. It would be nice if you
could send me an e-mail (ijp@floot.demon.co.uk) saying 'good', 'bad',
'works', 'won't work'. Also, for those who are really keen, I have set up a
mailing list. To subscribe send mail to lincity@floot.demon.co.uk with
      subscribe lincity     in the body of your mail.

Although it has been running successfully on a number of different machines
for some time now, you may have problems if your box is in anyway out of the
ordinary. If you do, let me know.

The game is still under development. If you play it, you will notice that
some of the graphics are better than others, and that some are not animated
yet. There are some new graphics and ones that are still there from the
early days. I hope to unify the look of the different areas as it approaches
1.00.

The X support is a rather crude effort that just simulates the SVGA screen
in an X window. It'll do for now. It works with 8bbp (256 colour) and 16bbp
(64K colour) displays. 24/32 bbp 'truecolour' displays are not supported
yet.


REQUIREMENTS:   *  A graphics card supported by svgalib.

                *  svgalib 1.2.9 (or greater), some earlier versions are
                               broken (eg compressed fonts)
                        [  1.2.9 and 1.2.10 are now available in 
                    disabuse.demon.co.uk:/pub/unix/linux/libs/svga ]

         OR	 X11.
         ^^
                *  An ELF install, or...
                 ... if you are using a.out libraries you will have to compile
                               it for yourself (make clean, make install).

                *  You probably need at least a 486DX2-66. (Even better
                   for the X version I suspect.)

                *  Other things? That's what you're there to find out :)



INSTALLATION:
============

To install LinCity, (as root) untar the file lincity098-src.tgz (or
lincity098-elfbin.tgz)

     tar -xzvf lincity098-src.tgz  (or lincity098-elfbin.tgz)

This will unpack the game into the directory ./lincity098 .

If you want to compile the source, go into the direcrory ./lincity098

      cd lincity098
      make lincity      (or xlincity)
      make install

If you want to install the binaries and library/data files (...elfbin only)
go into the directory ./lincity098 and type

      make install      This will install the Linux SVGA and X elf binaries
                        if you got the elfbin version. If you got the source
                        only version, (or you are non-elf or non-Linux)
                        you will have to compile the program.

For more instructions on compiling/installing, look at thee file
README.INSTALL   (Typing  make  on its own will also give you some help.)

If you have a version less than 0.95 installed on your system, you MUST
                      ^^^^^^^^^^^^^^^^^^^^^^^^                     ^^^^
remove the following symlinks with:
                rm /usr/local/bin/lin-city
		rm /usr/local/bin/xlin-city
You should also get rid of the old source tree (although this isn't strictly
necessary), with
		rm -r /usr/local/games/lin-city


WHAT I NEED FROM YOU:
====================

Could you kind folks out there mail me ( ijp@floot.demon.co.uk ) with
comments on how easy/hard it was to install/play, any bugs you find and the
setup you are using. I need to know your setup so I can say in future
releases that it is known to work on an XXX system with a YYY graphics card
etc. I will try to reply to you, but it depends on how many people send me
mail, for this reason I thank you in advance for your comments and hope you
have fun playing LinCity.

KNOWN BUGS:

X seg fault bug?
No one has reported seg faults in the X version since release (0.92).
I haven't fixed the bug, if there is one. They tended to be confined to
individuals, so they might have been hardware/library/chicken problems.

Had a report of the technology indicator showing both a rise and fall,
although I have now seen this, I haven't tracked it down yet. 

"This program has something for everyone. Some people want to find bugs, so
I added some."
                                                      -unknown.

HISTORY:

I started writing LinCity in June 1995 as an exercise in mouse control in
SVGALIB. It quickly became a usable, then even fun, game to play. Over the
next 16 months it evolved into a challenging and stable game which, in a
number of people's opinion, is worth uploading to the net. The current
version is 0.98.


COPYRIGHT:

LinCity is copyright (C) I J Peters 1995,1996.

You may freely copy, distribute and modify lincity under the terms of the

                       GNU GENERAL PUBLIC LICENSE

Please read the file COPYING for the GPL.