@database Pinball.guide
@author Kyzer/CSG
@node main "Pinball Fantasies AGA launcher v1.0 by Kyzer/CSG"
@{" Introduction " link 1} 
@{" Installation " link 2} 
@{" Usage        " link 3} 
@{" Requirements " link 4} 
@{" Distribution " link 5} 
@{" Copyright    " link 6} 
@{" Disclaimer   " link 7} 
@{" Credits      " link 8} 
@endnode

@node 1 "Introduction"
This program is a launcher for the Pinball Fantasies AGA pinball game.
This new launcher improves on the original launcher in 20 good ways:

* Fully font sensitive layout
* Smaller executable program
* includes $VER string
* Doesn't need SetPatch
* Auto centres on screen
* Doesn't need any assigns
* Doesn't need IconX script
* Close gadget provided
* Allows clicking on gadgets
* Uses less space on screen
* Slightly less memory used
* Frees ALL used memory!
* Input when loading ignored
* PointerX hands will spin!
* Fully style guide compliant
* Loads 2-3 seconds faster
* Source in Amiga E provided
* Source IS structured ;-)
* Stronger checking in code
* No annoying pwds
@endnode

@node 2 "Installation"
Floppy disk installation: Copy the "Pinball" program to a backup of your
disk 1.

Hard Disk Installation: Copy the "Pinball" program to the same place as the
"Pinball_Fantasies" icon, then delete the "Pinball_Fantasies" icon.
@endnode

@node 3 "Usage"
Load the game as usual and either click on gadget to load level, or press
1-4. To quit, either press Q, escape, or select quit from the menu.
@endnode

@node 4 "Requirements"
Only Amigas with the AGA chipset and v39+ of Kickstart and Workbench are
supported. This is the same as the original.

Please note, that just like the original, this program is
@{"reentrant but not pure" link explain}.
It can be made resident with no drastic consequences, however this is not
advised, just in case!
@endnode

@node explain "reentrant but not pure"
This means the program, in some places, modifies it's data section directly.
It's only really in the gadget generation code this pops up.

It only uses static data modifications on things that will ALWAYS be
calculated before use, so it's OK to run a resident copy, quit it, and
run again, with no problems, BUT it does share these supposedly static
values with any other running copies.

However, it's unlikely to do much damage, as the static expressions in
multiple copies almost always evaluate to exactly the same thing. They
are used in gadget creation and the window opening, as well as just before
running the game.
@endnode

@node 5 "Distribution"
These files must be included, you can add BBS adverts if you like ;-)

Pinball
Pinball.e
Pinball.guide
Pinball.info
@endnode

@node 6 "Copyright"
This launcher is (c) 1996-1997 Kyzer/CSG.
The original, and the game, is (c) 21st Century Entertainment.
This launcher is only for use by legitamate owners of the game!

21st Century have my full permission to use this for profit, everyone else
must ask me. Non-profit distribution and PD libraries are allowed to
distribute this. Aminet and Fish CD distribution is allowed.
@endnode

@node 7 "Disclaimer"
No warranty is stated or implied. It is your own responsibility to
safe-guard your data when using this.

That said, PFlaunch is extremely unlikely to cause any failures.
@endnode

@node 8 "Credits"
Written by Kyzer/CSG in 2 hours on 24.4.96
Oops I forgot to release it to the public, but I have now :-)

Write: Kyzer/CSG, 49 Fairview Road, AB22 AZG, Scotland.
Inetd: kyzer@adamant (Adamant telnet 130.83.9.19 4711)
Email: kyzer@4u.net

Version 1.1 (28.8.97) improved by opening on the default screen
(not just the current screen) and the source was twiddled a lot
to no visible effect.
@endnode