nethack-gwaa-kiwi/nethack
1
0
Fork 0
Code Pull Requests Activity

platform-specific options moved in Guidebook

Browse Source 
Moves the remaining platform-specific options
to their own section of the Guidebook and documents
the "video:autodetect" option required for tiles on MSDOS.
This commit is contained in:
nethack.allison
2002-06-01 23:53:14 +00:00
parent c6d02b30c3
commit ded027e246
2 changed files with 112 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
doc/Guidebook.mn
View File

@@ -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

95
doc/Guidebook.tex
View File

@@ -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}