platform-specific options moved in Guidebook

Moves the remaining platform-specific options
to their own section of the Guidebook and documents
the "video:autodetect" option required for tiles on MSDOS.

doc/Guidebook.mn

@@ -5,7 +5,7 @@
 .ds vr "NetHack 3.4
 .ds f0 "\*(vr
 .ds f1
-.ds f2 "April 20, 2002
+.ds f2 "June 1, 2002
 .mt
 A Guide to the Mazes of Menace
 (Guidebook for NetHack)
@@ -1628,11 +1628,6 @@ into account the blessed/cursed status, enchantment, damage, or
 quality of the weapon; you are free to manually fill your quiver with
 the `Q' command instead.  If no weapon is found or the option is
 false, the `t' (throw) command is executed instead.  (default false)
-.lp "BIOS    "
-Use BIOS calls to update the screen
-display quickly and to read the keyboard (allowing the use of arrow
-keys to move) on machines with an IBM PC compatible BIOS ROM (default off,
-OS/2, PC, and ST NetHack only).
 .lp boulder
 Set the character used to display boulders (default is rock class symbol).
 .lp catname
@@ -1977,11 +1972,6 @@ something pushes the old item into your secondary weapon slot (default off).
 .lp race
 Selects your race (for example, ``race:human'').  Default is random.
 Cannot be set with the `O' command.
-.lp "rawio   "
-Force raw (non-cbreak) mode for faster output and more
-bulletproof input (MS-DOS sometimes treats `^P' as a printer toggle
-without it) (default off).  Note:  DEC Rainbows hang if this is turned on.
-Cannot be set with the `O' command.
 .lp rest_on_space
 Make the space bar a synonym for the `.' (rest) command (default off).
 .lp "role    "
@@ -2054,19 +2044,6 @@ Cannot be set with the `O' command.
 Allow the travel command (default on).
 .lp verbose
 Provide more commentary during the game (default on).
-.lp videocolors
-Set the color palette for PC systems using NO_TERMS
-(default 4-2-6-1-5-3-15-12-10-14-9-13-11).
-The order of colors is red, green, brown, blue, magenta, cyan,
-bright.white, bright.red, bright.green, yellow, bright.blue,
-bright.magenta, and bright.cyan.
-Cannot be set with the `O' command.
-.lp videoshades
-Set the intensity level of the three gray scales available
-(default dark normal light, PC NetHack only).
-If the game display is difficult to read, try adjusting these scales;
-if this does not correct the problem, try !color.
-Cannot be set with the `O' command.
 .lp windowtype
 Select which windowing system to use, such as ``tty'' or ``X11''
 (default depends on version).
@@ -2163,6 +2140,52 @@ the message window.
 NetHack should display windows with the specified foreground/background
 colors if it can.
 .hn 2
+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 altmeta
+(default on, AMIGA NetHack only).
+.lp "BIOS    "
+Use BIOS calls to update the screen
+display quickly and to read the keyboard (allowing the use of arrow
+keys to move) on machines with an IBM PC compatible BIOS ROM (default off,
+OS/2, PC, and ST NetHack only).
+.lp flush
+(default off, AMIGA NetHack only).
+.lp "MACgraphics"
+(default on, Mac NetHack only).
+.lp page_wait
+(default on, Mac NetHack only).
+.lp "rawio   "
+Force raw (non-cbreak) mode for faster output and more
+bulletproof input (MS-DOS sometimes treats `^P' as a printer toggle
+without it) (default off, OS/2, PC, and ST NetHack only).
+Note:  DEC Rainbows hang if this is turned on.
+Cannot be set with the `O' command.
+.lp soundcard
+(default on, PC NetHack only).
+Cannot be set with the `O' command.
+.lp video
+Set the video mode used (PC NetHack only).
+Values are `autodetect', `default', or `vga'.
+Setting `vga' (or `autodetect' with vga hardware present) will cause
+the game to display tiles. 
+Cannot be set with the `O' command.
+.lp videocolors
+Set the color palette for PC systems using NO_TERMS
+(default 4-2-6-1-5-3-15-12-10-14-9-13-11, (PC NetHack only).
+The order of colors is red, green, brown, blue, magenta, cyan,
+bright.white, bright.red, bright.green, yellow, bright.blue,
+bright.magenta, and bright.cyan.
+Cannot be set with the `O' command.
+.lp videoshades
+Set the intensity level of the three gray scales available
+(default dark normal light, PC NetHack only).
+If the game display is difficult to read, try adjusting these scales;
+if this does not correct the problem, try !color.
+Cannot be set with the `O' command.
+.hn 2
 Configuring NetHack for Play by the Blind
 .pg
 NetHack can be set up to use only standard ASCII characters for making

doc/Guidebook.tex

@@ -27,7 +27,7 @@
 \begin{document}
 %
 % input file: guidebook.mn
-% $Revision: 1.41 $ $Date: 2002/04/13 16:00:06 $
+% $Revision: 1.42 $ $Date: 2002/04/20 14:16:07 $
 %
 %.ds h0 "
 %.ds h1 %.ds h2 \%
@@ -40,7 +40,7 @@
 %.au
 \author{Eric S. Raymond\\
 (Extensively edited and expanded for 3.4)}
-\date{April 20, 2002}
+\date{June 1, 2002}
 
 \maketitle
 
@@ -2043,11 +2043,6 @@ quality of the weapon; you are free to manually fill your quiver with
 the `Q' command instead.  If no weapon is found or the option is
 false, the `t' (throw) command is executed instead.  (default false)
 %.lp
-\item[\ib{BIOS}]
-Use BIOS calls to update the screen display quickly and to read the keyboard
-(allowing the use of arrow keys to move) on machines with an IBM PC
-compatible BIOS ROM (default off, {\it OS/2, PC\/ {\rm and} ST NetHack\/} only).
-%.lp
 \item[\ib{boulder}]
 Set the character used to display boulders (default is rock class symbol).
 %.lp
@@ -2425,12 +2420,6 @@ something pushes the old item into your secondary weapon slot (default off).
 Selects your race (for example, ``{\tt race:human}'').  Default is random.
 Cannot be set with the `{\tt O}' command.
 %.lp
-\item[\ib{rawio}]
-Force raw (non-cbreak) mode for faster output and more
-bulletproof input (MS-DOS sometimes treats `{\tt \^{}P}' as a printer toggle
-without it) (default off).  Note:  DEC Rainbows hang if this is turned on.
-Cannot be set with the `{\tt O}' command.
-%.lp
 \item[\ib{rest\_on\_space}]
 Make the space bar a synonym for the `{\tt .}' (rest) command (default off).
 %.lp
@@ -2518,23 +2507,6 @@ Allow the travel command (default on).
 \item[\ib{verbose}]
 Provide more commentary during the game (default on).
 %.lp
-\item[\ib{videocolors}]
-\begin{sloppypar}
-Set the color palette for PC systems using NO\_TERMS
-(default 4-2-6-1-5-3-15-12-10-14-9-13-11).
-The order of colors is red, green, brown, blue, magenta, cyan,
-bright.white, bright.red, bright.green, yellow, bright.blue,
-bright.magenta, and bright.cyan.
-Cannot be set with the `{\tt O}' command.
-\end{sloppypar}
-%.lp
-\item[\ib{videoshades}]
-Set the intensity level of the three gray scales available
-(default dark normal light, {\it PC\/ NetHack\/} only).
-If the game display is difficult to read, try adjusting these scales;
-if this does not correct the problem, try {\tt !color}.
-Cannot be set with the `{\tt O}' command.
-%.lp
 \item[\ib{windowtype}]
 Select which windowing system to use, such as ``{\tt tty}'' or ``{\tt X11}''
 (default depends on version).
@@ -2666,6 +2638,69 @@ NetHack should display windows with the specified foreground/background
 colors if it can.
 \elist
 
+%.hn 2
+\subsection*{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.
+
+\blist{}
+%.lp 
+\item[\ib{altmeta}]
+(default on, {\it Amiga NetHack \/} only).
+%.lp
+\item[\ib{BIOS}]
+Use BIOS calls to update the screen display quickly and to read the keyboard
+(allowing the use of arrow keys to move) on machines with an IBM PC
+compatible BIOS ROM (default off, {\it OS/2, PC\/ {\rm and} ST NetHack\/} only).
+%.lp 
+\item[\ib{flush}]
+(default off, {\it Amiga NetHack \/} only).
+%.lp 
+\item[\ib{Macgraphics}]
+(default on, {\it Mac NetHack \/} only).
+%.lp 
+\item[\ib{page\_wait}]
+(default off, {\it Mac NetHack \/} only).
+%.lp
+\item[\ib{rawio}]
+Force raw (non-cbreak) mode for faster output and more
+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 
+\item[\ib{soundcard}]
+(default off, {\it PC NetHack \/} only).
+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\/}. 
+Setting {\it vga\/} (or {\it autodetect\/} with vga hardware present) will cause
+the game to display tiles. 
+Cannot be set with the `{\tt O}' command.
+%.lp
+\item[\ib{videocolors}]
+\begin{sloppypar}
+Set the color palette for PC systems using NO\_TERMS
+(default 4-2-6-1-5-3-15-12-10-14-9-13-11, {\it PC\/ NetHack\/} only).
+The order of colors is red, green, brown, blue, magenta, cyan,
+bright.white, bright.red, bright.green, yellow, bright.blue,
+bright.magenta, and bright.cyan.
+Cannot be set with the `{\tt O}' command.
+\end{sloppypar}
+%.lp
+\item[\ib{videoshades}]
+Set the intensity level of the three gray scales available
+(default dark normal light, {\it PC\/ NetHack\/} only).
+If the game display is difficult to read, try adjusting these scales;
+if this does not correct the problem, try {\tt !color}.
+Cannot be set with the `{\tt O}' command.
+\elist
+
+%.lp
 %.hn 2
 \subsection*{Configuring NetHack for Play by the Blind}