From: nethack.allison Date: Sat, 1 Jun 2002 23:53:14 +0000 (+0000) Subject: platform-specific options moved in Guidebook X-Git-Tag: MOVE2GIT~2731 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ded027e2460c5e871aa81c2c6b3630ae21f8385b;p=nethack 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. --- diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn index a0c50bd75..5d223e4e0 100644 --- a/doc/Guidebook.mn +++ b/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 diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex index c3dc6a927..99c58e90b 100644 --- a/doc/Guidebook.tex +++ b/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}