NetHack/SlashEM on Palm OS!  12/10/2005

The user interface for this Palm OS port is based on the excellent Sony PSP Angband 
port by abszero and Gendal. There is a full on-screen-keyboard and simple macro 
interface.  The Analog Stick / Dpad can be used to select items from 
inventory/equipment lists or stores as well as selecting quantities of items.  

With a good set of macros it is efficient and very fun to play.  The file 
/Palm/Programs/NetHack/macro/default.txt is the active macro file. Please email 
me your favorite macro sets if you edit/create new ones and I will include them 
in future releases.  Note that there are some SlashEM macros in default.txt that 
don't make sense to NetHack (since SlashEM has some extra commands).

Options for NetHack (including the name of your character or pet) are modified by 
editing the defaults.nh in the /Palm/Programs/NetHack directory of your memory card.  
Read  the NetHack/SlashEM Guidebook for more details on the available options.

Let me know (on EmuBoards Zodiac Gamer forum) about bugs you encounter and try to 
include a .sav file if possible with instructions to reproduce the problem.

enjoy!
-Dan Vernon
(retrobits)

SYSTEM REQUIREMENTS: 

	Tapwave Zodiac
	
	(Future releases may support more OS5+ 480x320 devices) 


INSTALLATION:

	Extract zip archive, keeping directory structure intact.  Copy the "Palm" 
	directory to the root of your memory card using a card reader or equivalent
	emulation program.  Hotsync install is not supported at this time.


HOW TO PLAY:

	Tapwave Zodiac Controls:
	
	Analog Stick:          Move character (8 way), pick from lists, 
			       macro & onscreen keyboard navigation
			       
	Analog Stick Press:    Run mode toggle
	Yellow:                Confirm / 'Enter' (Modify macros in macro interface)
	Blue:		       Onscreen keyboard (press again to select)
	Red:         	       Macro interface (press again to select)
	Green: 		       Space bar (Shift / Control toggle in onscreen keyboard)
	Right Trigger:         Cancel / 'Escape'
	Left Trigger:          Enter numeric value (Analog Up/Down, Left/Right to change)
	Black:                 Look at object using cursor (press Yellow to select)
	Home:                  Save and Exit

KNOWN ISSUES:

	* High Score file is not working.


MINI-TUTORIAL:

Fire up NetHack, press Yellow (Enter) at the initial prompt asking to create a 
character for you. Pressing Yellow (Enter) at any prompt takes the default or "Yes".  
Pressing the Right Trigger would choose Cancel or "No".  You should end up looking 
at a newly generated dungeon (only one room will be visible), a status line at the
bottom, and a brief indroductory paragraph (which may be actually hiding the new 
dungeon room), with "--More--" printed at the bottom.  Whenever you see a 
"--More--" prompt it means to press Green (Space bar) to either dismiss the window, 
or move to the next page.

The cursor should be now blinking over an '@' symbol, which represents you.  Near you
should be an inverse 'd' or 'f' (or possibly something else if you are playing 
SlashEM) which indicates your pet (either dog or cat respectively).  Your pet is your
friend, be careful not to loose it.

Lets try a macro.  Press Red, then briefly move the analog stick Left, and Left again,
then Down. The macro selector should read "Help Menu". If you make a mistake, pressing
Right Trig will move back up the macro tree. Pressing Red again will execute the 
macro.  Now you should be looking at a number of choices for help topics.  Moving
the stick up and down and pressing enter will select a choice.  Press space (Green) 
to page forward (at this point there is no paging back, sorry), and Escape (Right Trig)
to return to the game.

As you are moving around, you may encounter a brown '+' symbol.  This indicates a 
closed door.  Use the Open macro to attempt to open it.  Press Red, followed by Red 
again.  You will be prompted for a direction.  Use the stick to select the direction.
In some cases, you may wish the direction to indicate the space in which you are
currently standing -- you would use the "Analog Stick Press" Button ('.') to indicate 
this at a direction prompt.

Maybe the door is locked?  Try the Force (Red,Right,Right,Red) Macro.  Maybe that 
didn't work?  Try the Kick (Red,Down,Right,Red) Macro.  A dead-end corridor might
reveal secrets if you Search.  You need to learn where the commands are located 
in the macro interface and what they mean.  The NetHack Guidebook will help.

Sometimes you will encounter a "Multi-Select" menu.  These work just like the 
"Single-Select" menu that you encountered in the Help System, except that pressing
Yellow does not dismiss the menu.  Instead the '-' symbol in front of the choice 
is changed to a '+' sign.  To move to the next page of the menu, press Green or 
Stick Right.  Stick Left will go to the previous page.  Pressing the Red button
at this point will bring up a custom macro interface for more multi-select choices
such as selecting/deselecting/inverting the page or the entire menu.  In some 
multi-select menus, you can enter a count.  This is done by pressing the Left-Trig,
and using the Stick to enter a number (left/right changes the value by 1, up/down
changes the vaule by 20).  Pressing Yellow or Left-Trig will send the number to
NetHack.  The next item in the menu you select by pressing Yellow will have a 
'#' symbol next to it.  This indicates that it is selected with a count.  When you
are ready Green or Stick-Right will commit your menu choices.  To cancel out of
the menu use the Right-Trig.  Give this menu process a try by experimenting with
the "Multi Drop" (Red,Down,Down,Red) macro.

At times when you enter a command, such as Throw, you will be prompted
with a list of reasonable choices to Throw (such as a Spear or Stone).  To throw
something unexpected, move the stick right or left to toggle between a filtered
& unfiltered inventory choices.  This type of thing applies to many commands,
such as Eat, Drink, Read, etc.  Sometimes there are things on the floor that
you would like to Eat or Drink, or even the spot you are standing on could be
"Drinkable" (such as a fountain).  In these cases, moving the stick right or 
left will toggle between all the possibilities.

To exit & save the game in progress press the HOME key (the one with the little
house on it).

I suggest reading the NetHack Guidebook to find out more about this game and how
to play.

Have fun!