Amiga: ship as a NetHack drawer with drawer icon and README

sys/amiga/README.amiga

@@ -3,9 +3,9 @@
 
 Requirements
 ------------
-  - AmigaOS 3.0 or later (Kickstart 39+)
-  - 6 MB free RAM minimum (8 MB recommended)
-  - Hard drive with ~5 MB free space
+    - AmigaOS 3.0 or later (Kickstart 39+)
+    - 6 MB free RAM minimum (8 MB recommended)
+    - Hard drive with ~5 MB free space
 
 Recommended: RTG graphics card (Picasso96/CyberGraphX) for best
 tile rendering. Native AGA/OCS/ECS chipsets are supported.
@@ -13,56 +13,62 @@ tile rendering. Native AGA/OCS/ECS chipsets are supported.
 
 Installation
 ------------
-Extract NH370AMI.ZIP to a directory and assign it:
+Extract NH500AMI.ZIP somewhere on your hard drive (e.g. into Work:).
+You'll get a NetHack drawer with everything inside.
 
-    assign NetHack: <path>
+To play from Workbench, open the NetHack drawer and double-click the
+nethack icon.
 
-The directory should contain:
-    nethack          - game binary
-    nhdat            - data library
-    symbols          - symbol set definitions
-    sysconf          - system configuration
-    nethack.cnf      - game options
-    hack.font        - font descriptor
-    hack/8           - font bitmap (8pt)
-    tiles/tiles16.iff - 16-color tiles (OCS/ECS)
-    tiles/tiles32.iff - 32-color tiles (AGA/RTG)
-    tomb.iff         - tombstone image
-    record           - high score file
+To play from a Shell:
 
-To play:
-    cd NetHack:
-    nethack
+    Work:NetHack/nethack
+
+To redirect to a different install -- for example to test two versions
+side by side -- set the NETHACKDIR (or HACKDIR) environment variable
+before launching:
+
+    setenv NETHACKDIR Work:games/nethack-dev/
+    Work:games/nethack-dev/nethack
 
 
 Display Modes
 -------------
-Two display modes are available, selected in nethack.cnf:
-
-  Text mode (AMII):
-    OPTIONS=symset:AmigaFont
-
-  Tile mode (AMIV):
-    OPTIONS=windowtype:amiv
+The shipped nethack.cnf selects tile mode (AMIV).  AMIV needs a screen
+with at least 4 bitplanes (16 colours) and ~384 KB free chip RAM; on
+machines that don't qualify, the binary automatically falls back to
+text mode (AMII) at startup with a short note explaining why.
 
 Tile mode auto-selects tiles32.iff (32 colors, 5 bitplanes) when the
 screen supports 32+ colors, otherwise tiles16.iff (16 colors, 4 planes).
 
+To force text mode unconditionally, edit nethack.cnf:
+
+    #OPTIONS=windowtype:amiv
+    OPTIONS=windowtype:amii
+    OPTIONS=symset:AmigaFont
+
 
 Configuration
 -------------
-Edit nethack.cnf for game options.  Key settings:
+Edit nethack.cnf for game options.  Defaults shipped:
 
-  OPTIONS=windowtype:amiv       - tile graphics (default)
-  OPTIONS=symset:AmigaFont      - text mode with line-drawing chars
-  OPTIONS=menucolors            - colored inventory items
-  OPTIONS=time,lit_corridor     - show turn count, lit corridors
-  OPTIONS=boulder:0             - display boulders as '0'
+    OPTIONS=windowtype:amiv     - tile graphics
+    OPTIONS=number_pad:1        - numpad movement; '5' is run prefix
+    OPTIONS=time,showexp        - turn count, experience visible
+    OPTIONS=lit_corridor        - show lit corridors
+    OPTIONS=menucolors          - colored inventory items
 
-Menu color examples (add after OPTIONS=menucolors):
-  MENUCOLOR=" blessed "=green
-  MENUCOLOR=" cursed "=red
-  MENUCOLOR=" uncursed "=cyan
+ALT+letter shortcuts to extended commands (ALT+L for #loot, ALT+F for
+#force, etc.) are enabled by default.  On keymaps that need ALT for
+typing characters (Scandinavian, German, French, ...) disable with:
+
+    OPTIONS=!altmeta
+
+Menu color examples (after OPTIONS=menucolors):
+
+    MENUCOLOR=" blessed "=green
+    MENUCOLOR=" cursed "=red
+    MENUCOLOR=" uncursed "=cyan
 
 
 Building from Source
@@ -79,18 +85,19 @@ Cross-compilation from Linux using bebbo's m68k-amigaos-gcc toolchain
     make CROSS_TO_AMIGA=1 all
     make CROSS_TO_AMIGA=1 package
 
-The distribution ZIP is created at targets/amiga/NH370AMI.ZIP.
+The distribution ZIP is created at targets/amiga/NH500AMI.ZIP.
 
 Toolchain requirements:
-  - m68k-amigaos-gcc (bebbo's amigaos-cross-toolchain in /opt/amiga)
-  - -noixemul (libnix) for linking
-  - -m68000 for maximum compatibility (or -m68020/040/060)
+
+    - m68k-amigaos-gcc (bebbo's amigaos-cross-toolchain in /opt/amiga)
+    - -noixemul (libnix) for linking
+    - -m68000 for maximum compatibility (or -m68020/040/060)
 
 
 Known Issues
 ------------
-  - Native Amiga compilation (SAS/C, DICE) is not supported;
-    cross-compilation with GCC is required
+    - Native Amiga compilation (SAS/C, DICE) is not supported;
+      cross-compilation with GCC is required
 
 
 Credits