README.md

To get Planetarium up and running you need to:
----------------------------------------------
1. Download the Planetarium archive planet20.zip (if you have not already)
2. Unzip the files contained in planet20.zip
3. Decide which files you want to install
4. Install the files on your PDA device
5. Start Planetarium and enter the registration code (if you have purchased
Planetarium, otherwise the program runs as demo version)

If you upgrade from a previous version:
---------------------------------------
You may decide not to install these files:

- PlanetariumDB.pdb - the location list
- UserObjsDB.pdb - the objects list
- PlnCometsDB.pdb - comets and asteroids

If you have entered personal locations you should not install the file
PlanetariumDB.pdb. If you want to install it, export your personal locations
to a memo so that you can reimport them after installing the file.

If you have entered user objects yourself, you should not install the file
UserObjsDB.pdb. If you want to install it, export your personal objects to a memo
so that you can reimport them after installing the file.
This is a list of errors that were corrected in the last release. You can enter
them manually:
- M25 is IC4725 (not NGC)
- M82 had the wrong icon. It should have the same icon as M81
- in the double star list omicron dra should have ra/dec of 18h51m / 59.4
- C89 is NGC6087 (not NGC6067)

If you have entered orbital elements for comets and asteroids you should export
your personal entries to a memo so that you can reimport them after
installing the file PlnCometsDB.pdb.

Which files to install
----------------------
You should find the following files:
Planet20.prc - The main executable application file.
PlnStars1600.prc - The small star data base.
PlnStars9096.prc - The big star data base.
PlanetariumDB.pdb - A list of 600 Major cities.
UserObjsDB.pdb - A list of about 200 deep sky objects.
PlnCometsDB.pdb - A list of some comets and asteroids.

On the download page http://www.aho.ch/pilotplanets/release.htm
you can download a manual.

You need to install at least the file Planet20.prc and either
PlnStars1600.prc or PlnStars9096.prc. All the other files are optional.
PlnStars1600.prc contains data of about 1600 stars down to magnitude 5.
Choose this file if you don't have very much free memory or don't need
faint stars in the program.
PlnStars9096.prc contains data of the complete Yale Bright Star Catalogue
with 9096 stars down to magnitude 6.5. Choose this file if you have
enough free memory and would like to have fainter stars in the program.
You can switch the star data base later by just installing the other one of them.

The data base files correspond with the following lists in the program:
PlanetariumDB.pdb - The Location Pick list (Menu item "Options / Set Location",
then tap the "Pick" button)
UserObjsDB.pdb - The Objects list (Menu item "Options / Objects")
PlnCometsDB.pdb - The Comets and Asteroids list (Menu Item "Options / Comets
and Asteroids")
The data in these lists is backuped during HotSync every time you have made
changes or entered new data. To fill some or all of these lists with initial
data you can install the corresponding .pdb files from planet20.zip. They contain:
PlanetariumDB.pdb - About 600 major cities from all over the world.
UserObjsDB.pdb - 110 Messier objects and 110 Caldwell objects.
PlnCometsDB.pdb - Some comets and asteroids.

Installing the files
--------------------
If you are not familiar with installing files on your PDA, please have a look
at your documentation that came with your device or read the chapter "Installation"
in the Planetarium user manual.

Entering the registration code
------------------------------
If you have purchased Planetarium you should have received a registration code. If
you don't have this registration code, Planetarium just runs as demo version. When
you enter the registation code, Planetarium will get converted into the full version.

To enter the registration code you got, select the menu item "Info / Register" or
press the "Enter Key" button on the startup screen. Then enter the registration
code without any blanks or quotes and tap on the "OK" button. If you have entered
the key correctly, you will get a confirmation and Planetarium will run as full
version which you can convince yourself of in the About screen (menu item "Info / About").

For very novice users: To select a menu item you tap on the lower left silk screen
button just at the left of the graffity area. Then you should see the menu bar at the
top of the display. You now select with the pen one of the items from this menu.

Notes about installing Planetarium on a memory card or memory stick
-------------------------------------------------------------------

- You can only install the file planet20.prc on the memory card.
- All the other files (PlnStarsXXXX.prc, PlanetariumDB.pdb, UserObjsDB.pdb,
PlnCometsDB.pdb) must stay in main memory.

Exception to this rule:
You can install the following files into the memory card, if you do NOT intend
to add data to them:

- PlanetariumDB.pdb - Location list
- UserObjsDB.pdb - Deep Sky Objects
- PlnCometsDB.pdb - Comets and Asteroids

If these files reside on the card only but not in main memory they will be copied
to main memory together with planet20.prc each time you start the application and
will be discarded when you stop the application. So if you add new entries, they
are discarded as well. The files will be copied again from the card at the next start.
(Please note, you need the files from the latest release (v2.2). Files from older
versions do not get copied along with the application).

This copying takes place only if you don't have the files installed in main memory.
If you have them installed in main memory and on the card, they won't be copied.

If you wish to enter a new location, a new comet or a new object, you need to move
the files to the main memory. If you just want to read from them, you can move them
to the card and remove them from main memory.

May all your clouds go away!