NingPo Mah Jong
Version 1.00
August 5, 2002
by Pyrogon
http://www.pyrogon.com

*************************
*** TABLE OF CONTENTS ***
*************************

I	System Requirements
II	Troubleshooting
III	Instructions
IV	Registration
V	Technical Support
VI	Credits
VII	Legal Stuff
VIII	Version History

***************************
I.  System Requirements ***
***************************

The following section lists the minimum and recommended system
specifications for NingPo Mah Jong:

--- MICROSOFT WINDOWS ---

* CPU: Pentium/133MHz or better
* RAM: 32MB or more

* Operating System: Microsoft Windows 95(OSR2), Windows 98,
Windows ME, Windows 2000, Windows NT4 (SP3+) or Windows XP.

* Controls: A standard mouse and keyboard are required.

* Sound: A DirectSound compatible sound card is required for
sound and music.

* Graphics: a 15, 16, 24 or 32-bit display

--- APPLE MAC OS ---
* CPU: 150MHz or better
* RAM: 32MB

* Operating System: Apple MacOS 8.5+

* Graphics: 16-bit ("thousands of colors") is recommended

--- APPLE MAC OS X ---

* CPU: G3/233MHz or better
* RAM: 128MB

* Operating System: Apple Mac OS X 10.1 (untested on 10.0.x
but it may work)

* Graphics: will run with an 8, 16 or 32-bit display, however
for best graphics and performance 16-bit ("thousands of
colors") is recommended.

--- LINUX/FREEBSD ---

* CPU: Pentium/133MHz or better
* RAM: 32MB RAM

* Operating System: Linux kernel 2.2 or later with glibc 2.1
or later.  Unix variants with a Linux binary compatibility
layer, such as FreeBSD, may be suitable, but are
unsupported. The installation should be independent of
distribution, user interface, and package manager.

* Graphics: XFree86 4.0 or later recommended.  Other targets
such as XFree86 3.3 and fbcon may be suitable, but are
unsupported.  NingPo Mah Jong is best played on a 16-bit,
local display, but should be able to run on any target
supported by Simple DirectMedia Layer
(http://www.libsdl.org)

* Sound: Direct access to /dev/dsp is recommended.  Other
targets such as esd and artsd may be suitable, but are
unsupported.  NingPo Mah Jong should be able to output sound
by any means supported by Simple DirectMedia Layer (SDL).

**********************
II.  Troubleshooting *
**********************

While we have attempted to make NingPo Mah Jong as bug free
as possible, we recognize that some problems may arise.  If
you have a bug to report, please send as much information as
possible to support@pyrogon.com and we will attempt to
resolve the problem to the best of our abilities.

--- MICROSOFT WINDOWS ---

NingPo Mah Jong requires Microsoft DirectX to be installed.
For the latest version of DirectX visit:

http://www.microsoft.com/directx

If NingPo Mah Jong runs slowly in windowed mode, you may
wish to try switching to full screen (registered version
only).  Alternatively, make sure your desktop is set to
16-bit color (also known as "65536 colors" or "thousands of
colors").

--- MAC OS X ---
No troubleshooting recommendations.

--- POCKET PC --- 

Some handheld units have notoriously poor graphics
performance, and as such probably will not run NingPo Mah
Jong very well.  Specific models include SH3 versions of the
HP Jornada series (Jornada 545) and black and white models
such as the Compaq iPAQ 3100.

The Jornada 525 (8-bit color) will not run NingPo Mah Jong
adequately.

--- LINUX AND COMPATIBLE OPERATING SYSTEMS ---
 
Running the game over X11's network protocol is very slow,
and we do not recommend it. If the game feels sluggish, you
can try the "--hwcursor" command line option to get a better
mouse response. For the true hackers, there is a
dynamically-linked version of the game included, so you can
drop in your own version of SDL as you see fit, but we don't
support the dynamic binary at all.


*******************
III. Instructions *
*******************

Please refer to the in-game instructions for game play help. 

--- LINUX SPECIFIC FEATURES ---

NingPo Mah Jong for Linux has some useful key bindings:

  Alt-Enter - Switches between fullscreen and windowed mode.
  Ctrl-g    - When in windowed mode, this grabs / ungrabs
              the input.

********************
* IV. Registration *
********************

If you enjoy playing the trial version of NingPo Mah Jong
you'll want to register it access the additional layouts and
tile sets!

To register on-line, go to www.pyrogon.com/games/ningpo and
follow the instructions.  You can automatically reach the
site by clicking on the "Buy Now!" button.

After purchase you will be sent an e-mail with your license
name and registration code.  Then the next time you play
NingPo Mah Jong, enter your registration information!

************************
* V. Technical Support *
************************

In the unlikely event that you experience problems with
NingPo Mah Jong, you can contact us at support@pyrogon.com
or visit us on the Web at www.pyrogon.com.

If you can, please include the following information along
with the description of your problem:

Computer manufacturer and type
Operating system
CPU Type and Speed
Amount of RAM
Soundcard Type
Videocard Type
Registration name and code (if applicable)

***************
* VI. Credits *
***************

NingPo Mah Jong was created by Pyrogon:

Programming:	
   Brian Hook

Art:
   Rosie Cosgrove

Additional help was provided by the following:

Additional Programming:
  David Hedbor - Qt/SDL, Unix Port
   Initial Ryan C. Gordon - Unix Port
   Zachary J. Slater - Unix Port Installer

Music composed and performed by:		
   Ian Livingstone (http://www.mediathemes.co.uk)

Special Thanks:
   The PopCap team
   All our friends that have helped with testing and feedback

********************
* VII. Legal Stuff *
********************

SOFTWARE LICENSE AGREEMENT:

This software license agreement is a legal agreement between
you, the end-user, and Pyrogon Incorporated.

NingPo Mah Jong ("the software product") is Copyright
2001-2002 by Pyrogon Incorporated.  All Rights Reserved
worldwide.

By installing or using the Software Product, you agree to
abide by the terms in this agreement.

The software product is licensed, and not sold.  By
purchasing the software product, you are being granted a
non-exclusive license to install and use the software
product on one personal computer.  You are also granted the
right to make one archival copy of the software product for
the purposes of data backup.

The software product is provided "as is", without warranty
of any kind, either expressed or implied, regarding the
operation of the software product, including warranties of
merchantability or its fitness for use for any particular
purpose. By installing the software product, you agree to
accept all liability regarding its use or misuse.

You may not disassemble, decompile, or Otherwise reverse
engineer the Software Product or any of its data in any
manner.  You may not distribute add-ons or levels of any
kind for use with the Software Product without the expressed
written consent of Pyrogon Incorporated.  You will
reasonably ensure that the registraton codes you acquire by
purchasing The Software Product will be protected from
redistribution or public display.

=== Copyright ===

NingPo Mah Jong (C) 2002, 2003 Pyrogon, Inc.  All other copyrights
and trademarks are property of their respective owners.

All rights reserved.

=== Simple Directmedia Layer and related libraries ===

NingPo Mah Jong, on certain platforms, uses Simple
Directmedia Layer (SDL).  These libraries, in source and
binary form, may be obtained from http://www.libsdl.org/

They are used in this product under the terms of the GNU
Lesser General Public License (GNU LGPL). The LGPL's text
may be found at:

   http://www.gnu.org/licenses/lgpl.txt
 
=== Ogg Vorbis ===

NingPo Mah Jong uses the Ogg Vorbis codec for streaming
audio from Xiphophorous, licensed under the following terms:

"Copyright (c) 2001, Xiphophorus

Redistribution and use in source and binary forms, with or
without modification, are permitted provided that the
following conditions are met:

- Redistributions of source code must retain the above
copyright notice, this list of conditions and the following
disclaimer.

- Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials
provided with the distribution.

- Neither the name of the Xiphophorus nor the names of its
contributors may be used to endorse or promote products
derived from this software without specific prior written
permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE."

*************************
* VIII. VERSION HISTORY *
*************************
1.00
- first release!
