Guidebook updates

- altkeyhandler (win32)
- subkeyval (win32)

doc/Guidebook.mn

@@ -5,7 +5,7 @@
 .ds vr "NetHack 3.4
 .ds f0 "\*(vr
 .ds f1
-.ds f2 "February 12, 2003
+.ds f2 "March 14, 2003
 .mt
 A Guide to the Mazes of Menace
 (Guidebook for NetHack)
@@ -2182,6 +2182,11 @@ Platform-specific Customization options
 .pg
 Here are explanations of options that are used by specific platforms or ports 
 to customize and change the port behaviour.
+.lp altkeyhandler
+Select an alternate keystroke handler dll to load (Win32 tty NetHack only).
+The name of the handler is specified without the .dll extension and without any
+path information.
+Cannot be set with the `O' command.
 .lp altmeta
 (default on, AMIGA NetHack only).
 .lp "BIOS    "
@@ -2204,6 +2209,14 @@ Cannot be set with the `O' command.
 .lp soundcard
 (default on, PC NetHack only).
 Cannot be set with the `O' command.
+.lp subkeyval
+(Win32 tty NetHackonly).
+May be used to alter the value of keystrokes that the operating system
+returns to NetHack to help compensate for international keyboard issues.
+OPTIONS=subkeyvalue:171/92
+will return 92 to NetHack, if 171 was originally going to be returned.
+You can use multiple subkeyvalue statements in the config file if needed.
+Cannot be set with the `O' command.
 .lp video
 Set the video mode used (PC NetHack only).
 Values are `autodetect', `default', or `vga'.

doc/Guidebook.tex

@@ -27,7 +27,7 @@
 \begin{document}
 %
 % input file: guidebook.mn
-% $Revision: 1.60 $ $Date: 2003/01/11 17:21:42 $
+% $Revision: 1.61 $ $Date: 2003/02/13 04:55:28 $
 %
 %.ds h0 "
 %.ds h1 %.ds h2 \%
@@ -40,7 +40,7 @@
 %.au
 \author{Eric S. Raymond\\
 (Extensively edited and expanded for 3.4)}
-\date{February 12, 2003}
+\date{March 14, 2003}
 
 \maketitle
 
@@ -2692,6 +2692,12 @@ Here are explanations of options that are used by specific platforms
 or ports to customize and change the port behaviour.
 
 \blist{}
+%.lp
+\item[\ib{altkeyhandler}]
+Select an alternate keystroke handler dll to load ({\it Win32 tty\/ NetHack\/} only).
+The name of the handler is specified without the .dll extension and without any
+path information.
+Cannot be set with the `{\tt O}' command.
 %.lp 
 \item[\ib{altmeta}]
 (default on, {\it Amiga NetHack \/} only).
@@ -2716,11 +2722,20 @@ bulletproof input (MS-DOS sometimes treats `{\tt \^{}P}' as a printer toggle
 without it) (default off, {\it OS/2, PC\/ {\rm and} ST NetHack\/} only).  
 Note:  DEC Rainbows hang if this is turned on.
 Cannot be set with the `{\tt O}' command.
-%.lp 
+%.lp
 \item[\ib{soundcard}]
 (default off, {\it PC NetHack \/} only).
 Cannot be set with the `{\tt O}' command.
 %.lp
+\item[\ib{subkeyval}]
+({\it Win32 tty NetHack \/} only).
+May be used to alter the value of keystrokes that the operating system
+returns to NetHack to help compensate for international keyboard issues.
+OPTIONS=subkeyvalue:171/92
+will return 92 to NetHack, if 171 was originally going to be returned.
+You can use multiple subkeyvalue statements in the config file if needed.
+Cannot be set with the `{\tt O}' command.
+%.lp
 \item[\ib{video}]
 Set the video mode used ({\it PC\/ NetHack\/} only).
 Values are {\it autodetect\/}, {\it default\/}, or {\it vga\/}.