The possible values are:
.sd
.si
-\fBs\fP - single message (default; only choice prior to 3.4.0)
-\fBc\fP - combination, two messages as `single', then as `full'
-\fBf\fP - full window, oldest message first
-\fBr\fP - full window reversed, newest message first
+.CC s "single message (default; only choice prior to 3.4.0);"
+.CC c "combination, two messages as `single', then as `full';"
+.CC f "full window, oldest message first;"
+.CC r "full window reversed, newest message first."
.ei
.ed
For backward compatibility, no value needs to be specified (which
in multi-turn movement (running via shift+direction or control+direction
and so forth, or via the travel command or mouse click).
The possible values are:
-.sd
-.si
-teleport - update the map after movement has finished;
-run - update the map after every seven or so steps;
-walk - update the map after each step;
-crawl - like walk, but pause briefly after each step.
-.ei
-.ed
+.PS teleport
+.PL teleport
+update the map after movement has finished;
+.PL run
+update the map after every seven or so steps;
+.PL walk
+update the map after each step;
+.PL crawl
+like walk, but pause briefly after each step.
+.PE
This option only affects the game's screen display, not the actual
results of moving. The default is `run'; versions prior to 3.4.1
used `teleport' only. Whether or not the effect is noticeable will
You may use the following special characters in a pattern:
.sd
.si
-\fB*\fP - matches zero or more characters;
-\fB?\fP - matches any single character.
+.CC * "matches zero or more characters;"
+.CC ? "matches any single character."
.ei
.ed
In addition, some characters are treated specially if they occur as the first
character in the pattern, specifically:
.sd
.si
-\fB<\fP - always pickup an object that matches rest of pattern;
-\fB>\fP - never pickup an object that matches rest of pattern.
+.CC < "always pickup an object that matches rest of pattern;"
+.CC > "never pickup an object that matches rest of pattern."
.ei
.ed
A `never pickup' rule takes precedence over an `always pickup' rule if
.lp SOUND
An entry that maps a sound file to a user-specified message pattern.
Each SOUND entry is broken down into the following parts:
-.sd
-.si
-MESG - message window mapping (the only one supported in 3.5).
-pattern - the pattern to match.
-sound file - the sound file to play.
-volume - the volume to be set while playing the sound file.
-.ei
-.ed
-.pg
+.PS "sound file"
+.PL MESG
+message window mapping (the only one supported in 3.5);
+.PL pattern
+the pattern to match;
+.PL "sound file"
+the sound file to play;
+.PL volume
+the volume to be set while playing the sound file.
+.PE
+.lp ""
The exact format for the pattern depends on whether the platform is
built to use ``regular expressions'' or NetHack's own internal pattern
matching facility. The ``regular expressions'' matching can be much more
3rd party libraries on some platforms. There are plenty of references
available elsewhere for explaining ``regular expressions''. You can verify
which pattern matching is used by your port with the #version command.
-.pg
+.lp ""
NetHack's internal pattern matching routine uses the following
special characters in its pattern matching:
.sd
.si
- *--- matches 0 or more characters.
- ?--- matches any single character.
+.CC * "matches 0 or more characters;"
+.CC ? "matches any single character."
.ei
.ed
-.pg
+.lp ""
Here's an example of a sound mapping using NetHack's internal
pattern matching facility:
.sd
- SOUND=MESG "*chime of a cash register*" "gong.wav" 50
+.si
+SOUND=MESG "*chime of a cash register*" "gong.wav" 50
+.ei
.ed
specifies that any message with "chime of a cash register" contained
-in it will trigger the playing of "gong.wav". You can have multiple
+in it will trigger the playing of file \fBgong.wav\fP. You can have multiple
SOUND entries in your config file.
.pg
.hn 2
\begin{document}
%
% input file: guidebook.mn
-% $Revision: 1.120 $ $Date: 2011/12/05 09:38:58 $
+% $Revision: 1.121 $ $Date: 2012/04/09 02:56:37 $
%
%.ds h0 "
%.ds h1 %.ds h2 \%
%.sd
%.si
-{\tt s} --- single message (default; only choice prior to 3.4.0)\\
-{\tt c} --- combination, two messages as {\it single\/}, then as {\it full\/}\\
-{\tt f} --- full window, oldest message first\\
-{\tt r} --- full window reversed, newest message first
+{\tt s} --- single message (default; only choice prior to 3.4.0);\\
+{\tt c} --- combination, two messages as {\it single\/}, then as {\it full\/};\\
+{\tt f} --- full window, oldest message first;\\
+{\tt r} --- full window reversed, newest message first.
%.ei
%.ed
%.sd
%.si
-{\tt MESG } --- message window mapping (the only one supported in 3.5).\\
-{\tt pattern } --- the pattern to match.\\
-{\tt sound file} --- the sound file to play.\\
+{\tt MESG } --- message window mapping (the only one supported in 3.5);\\
+{\tt pattern } --- the pattern to match;\\
+{\tt sound file} --- the sound file to play;\\
{\tt volume } --- the volume to be set while playing the sound file.
%.ei
%.ed
\elist
-%.pg
+%.lp ""
The exact format for the pattern depends on whether the platform is
built to use {\it regular expressions \/} or NetHack's own internal pattern
matching facility. The {\it regular expressions \/} matching can be much more
which pattern matching is used by your port with the
\#version command.
-%.pg
+%.lp ""
NetHack's internal pattern matching routine uses the following
special characters in its pattern matching:
-\begin{verbatim}
- *--- matches 0 or more characters.
- ?--- matches any single character.
-\end{verbatim}
+%.sd
+%.si
+{\tt *} --- matches 0 or more characters;
+{\tt ?} --- matches any single character.
+%.ei
+%.ed
-%.pg
+%.lp ""
Here's an example of a sound mapping using NetHack's internal
pattern matching facility:
-\begin{verbatim}
- SOUND=MESG "*chime of a cash register*" "gong.wav" 50
-\end{verbatim}
-specifies that any message with "chime of a cash register" contained
-in it will trigger the playing of "gong.wav". You can have multiple
+
+%.sd.si
+{\tt SOUND=MESG "*chime of a cash register*" "gong.wav" 50}
+%.ei.ed
+
+specifies that any message with ``chime of a cash register'' contained
+in it will trigger the playing of file {\tt gong.wav}. You can have multiple
SOUND entries in your config file.
%.lp