doc update: 'role' changes for Guidebook.tex

Catch the LaTex Guidebook up with the nroff one for the role, race,
gender, and alignment options.

For both formats, comment out the decription of 'altmeta' on Amiga.
This commit is contained in:
PatR
2022-12-24 14:29:58 -08:00
parent 9a9f2d596d
commit 4436d1eb4a
2 changed files with 116 additions and 76 deletions

View File

@@ -3995,12 +3995,16 @@ Enable messages about what your character hears (default on).
Note that this has nothing to do with your computer's audio capabilities.
Persistent.
%.lp
\item[\ib{align}]
\item[\ib{alignment}]
Your starting alignment ({\tt align:lawful}, {\tt align:neutral},
or {\tt align:chaotic}). You may specify just the first letter.
The default is to randomly pick an appropriate alignment.
If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
exclude that alignment from being picked randomly.
or {\tt align:chaotic}).
You may specify just the first letter.
Many roles and the non-human races restrict which alignments are allowed.
See {\it role\/}
for a description of how to use negation to exclude choices.
%.lp ""
\\
Default is random.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{autodescribe}]
@@ -4234,12 +4238,15 @@ melons already exist in {\it NetHack\/}, so don't use those.
%.lp
\item[\ib{gender}]
Your starting gender ({\tt gender:male} or {\tt gender:female}).
You may specify just the first letter. Although you can
still denote your gender using the ``{\tt male}'' and ``{\tt female}''
options, the ``{\tt gender}'' option will take precedence.
The default is to randomly pick an appropriate gender.
If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
exclude that gender from being picked randomly.
You may specify just the first letter.
Although you can
still denote your gender using either of the deprecated
``{\it male\/}'' and ``{\it female\/}''
options, the ``{\it gender\/}'' option will take precedence.
See {\it role\/}
for a description of how to use negation to exclude choices.
%.lp ""
Default is random.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{goldX}]
@@ -4701,9 +4708,12 @@ objects or monsters is less intrusive.
Default is off. Persistent.
%.lp
\item[\ib{race}]
Selects your race (for example, ``{\tt race:human}''). Default is random.
If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
exclude that race from being picked randomly.
Choices are {\tt human}, {\tt dwarf}, {\tt elf}, {\tt gnome}, and
{\tt orc} but most roles restrict which of the non-human races are allowed.
See {\it role\/}
for a description of how to use negation to exclude choices.
%.lp ""
Default is random.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{rest\verb+_+on\verb+_+space}]
@@ -4712,12 +4722,33 @@ Persistent.
%.lp
\item[\ib{role}]
Pick your type of character (for example, ``{\tt role:Samurai}'');
synonym for ``{\it character\/}''. See ``{\it name\/}'' for an alternate method
of specifying your role. Normally only the first letter of the
value is examined; `r' is an exception with ``{\tt Rogue}'', ``{\tt Ranger}'',
and ``{\tt random}'' values.
If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
exclude that role from being picked randomly.
synonym for ``{\it character\/}''.
See ``{\it name\/}'' for an alternate method of specifying your role.
%.\" Normally only the first letter of the
%.\" value is examined; `r' is an exception with ``{\tt Rogue}'',
%.\" ``{\tt Ranger}'', and ``{\tt random}'' values.
+.lp ""
This option can also be used to limit selection when role is chosen
randomly.
Use a space-separated list of roles and either negate each one or negate
the option itself instead.
Negation is accomplished in the same manner as with {\it boolean options},
by prefixing the option or its value(s) with `{\tt !|' or ``{\tt no}''.
%.BR 0
\\
Examples:
\\
\begin{verbatim}
OPTIONS=role:!arc !bar !kni
OPTIONS=!role:arc bar kni
\begin{verbatim}
\\
There can be multiple instances of the {\it role\/}
option if they're all negations.
%.\" Only one positive value is allowed, and if present, it overrides any
%.\" negations.
%.lp ""
Default is \f(CRrandom\fP.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{roguesymset}]
@@ -5246,12 +5277,13 @@ or ports to customize and change the port behavior.
Select an alternate way to handle keystrokes ({\it Win32 tty\/ NetHack\/} only).
The name of the handling type is one of {\it default}, {\it ray}, {\it 340}
%.lp
\item[\ib{altmeta}]
On Amiga, this option controls whether typing ``Alt'' plus another key
functions as a meta-shift for that key (default on).
%.\" \item[\ib{altmeta}]
%.\" On Amiga, this option controls whether typing ``Alt'' plus another key
%.\" functions as a meta-shift for that key (default on).
%.lp
\item[\ib{altmeta}]
On other (non-Amiga) systems where this option is available, it can be
%.\" On other (non-Amiga) systems where this option is available, it can be
On systems where this option is available, it can be
set to tell {\it NetHack\/} to convert a two character sequence beginning with
ESC into a meta-shifted version of the second character (default off).