PgmPP bundle v1
===============

  Version 1 - November 22, 2002

  PgmPP bundle is a set of 6 sample freeware programs for the
  on board Palm OS Pascal compiler

  Made in 2002 by Laurent Duveau (with a huge help from Philippe
  Guillot, the author of the Palm OS Pascal Compiler)
       Web Site = http://www.aldweb.com
       e-Mail   = info@aldweb.com




Palm OS Pascal compiler (PP)
----------------------------

The PgmPP sample programs were compiled with the great on board 
Palm OS Pascal compiler for Palm OS handheld devices
      Web Site = http://pages.total.net/~hkontas/pp.html
      e-Mail   = ph.guillot@wanadoo.fr

The Source code of the PgmPP programs are also available for
download on my Web Site.

The PgmPP programs are either brand new programs made for PP or
a port of the sample freeware programs that I originally made
for HSPascal. As a matter of fact, porting these programs from 
HSPascal to PP was a very easy job to do.

Philippe Guillot is doing a tremendous job with the PP compiler and
he really deserves respect and consideration. Thanks Philippe for providing us with the PP compiler for free! 




Overview
--------

ascii v1

  ascii is just a useful characters ASCII codes chart.

  Characteristics:
  - Console based program


CellsPP v1

  CellsPP is a port of the popular "Game of Life" invented 
  in 1970 by John Conway. In an automata universe, cells 
  follow very basic rules to survive, be born or die in 
  a turn based simulation.

  Characteristics:
  - Standard Palm graphical UI application
  - Minimum Palm OS requirement is version 2.0
  - Port of the Cells v1.6 source code for HSPascal 


MatchesPP1 v1

  MatchesPP1 is a silly little game in which each of the two 
  players (computer and you) removes one after the other 
  from one to three matches. The player who remains with
  the last match looses the game.

  Characteristics:
  - Console based program. MatchesPP1 was developped to allow
    comparizon of its source code with the one of MatchesPP2
    which is a standard Palm graphical UI application.
  - Minimum Palm OS requirement is version 2.0
  - Adaptation of the Matches v2.0 source code for HSPascal


MatchesPP2 v1

  MatchesPP2 is a silly little game in which each of the two 
  players (computer and you) removes one after the other 
  from one to three matches. The player who remains with
  the last match looses the game.

  Characteristics:
  - Standard Palm graphical UI application
  - Minimum Palm OS requirement is version 2.0
  - Port of the Matches v2.0 source code for HSPascal


NekoPP v1

  Who is NekoPP you may ask? NekoCat is a little cat that
  sits on your Palm and chases the food (bird, mouse or 
  fish) that you tick on the screen until he catches it.
  This so cute little cat then goes through a series of 
  absolutely adorable activities, such as cleaning himself
  and taking a nap.

  Characteristics:
  - Standard Palm graphical UI application
  - Minimum Palm OS requirement is version 2.0
  - Port of the NekoCat v2.3 source code for HSPascal


NumerusPP v1

  NumerusPP is a basic standard 4 function calculator... 
  that operates in Roman numerals.
  NumerusPP accepts numbers in the range {0..99999}.

  Characteristics:
  - Standard Palm graphical UI application
  - Minimum Palm OS requirement is version 3.0
  - Port of the Numerus v1.7 source code for HSPascal




How to install the PgmPP programs executables?
----------------------------------------------

All these sample programs are Palm OS v5 ready (tested with Palm 
Simulator version 5.1b)

The graphical UI applications are PRC file that are installed like
any other Palm OS file using HotSync. So, extract ProgramName.PRC from
the PgmPP.ZIP archive file. Double-click on it and the Palm install
tool will popup. ProgramName.PRC will be transferred to your Palm
device next time you synchronize your device with your PC with HotSync.

Both black & white and color versions of the graphical UI
applications are available. Whether your device is color enabled or
not, they will automatically detect it and adapt to display all
items in black & white or in color.

The console based applications need PP or vfsDOS to run. Please refer
to the PP official documentation for proceeding instructions.




How to install the PgmPP programs source code?
----------------------------------------------

You will find in the PgmPP.ZIP archive file some ProgramName.pas.pdb
and ProgramName.rsrc.prc files. You need to upload these files to your Palm device, together with the 3 Units files (PPlib.pas.pdb, 
SysTraps.pas.pdb and TPTypes.pas.pdb) that are to be found in
the Units folder inside the PgmPP.ZIP file.

All FileName.pas.pdb file can be read and modified with QED or
any other DOC reader. The ProgramName.rsrc.prc file can read and 
modified with the RsrcEdit program.

PP v1.04c or later is required for compiling these programs.

To compile the program by yourself, you just have to go in PPShell and
select the ProgramName.pas.pdb. Then click on the Compile button and 
that's it.




Units
-----

PPlib.pas is a set of common functions that can be used both in
console based applications and graphical UI applications.

TPTypes.pas may be included in your PP programs for HSPascal and
Turbo Pascal integer types compatibility. It can be used both in
console based applications and graphical UI applications.

SysTraps.pas is a set of common Palm OS API calls for PP. It is to
be used for graphical UI applications.




Donate...
---------

All these sample programs for PP are free to use. However, if you
like them, please consider making a donation to show your support.
Any amount will be greatly appreciated. To proceed, just connect to: 
  http://www.aldweb.com/give.html  (secured PayPal transaction)




Updates Description
-------------------

  v1 (11/22/01)
    - initial release
