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

doc formatting

Browse Source 
Remove trailing spaces from doc/fixes36.1 (only a couple),
doc/Guidebook.mn (several), and doc/Guidebook.tex (many).  I re-split
some lines made wider by embedded formatting directives, but tried to
avoid getting carried away with that.

I think I added one missing period to Guidebook.mn and one missing
comma to Guidebook.tex.  Aside from that, they should format the same
as they did before this patch.
This commit is contained in:
PatR
2018-04-14 13:13:42 -07:00
parent 5054e7154b
commit 5086c89658
3 changed files with 191 additions and 175 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
doc/Guidebook.mn
View File

@@ -1,4 +1,4 @@
.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.245 $ $NHDT-Date: 1522961296 2018/04/05 20:48:16 $
.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.251 $ $NHDT-Date: 1523736800 2018/04/14 20:13:20 $
.ds h0 "NetHack Guidebook
.ds h1
.ds h2 %
@@ -3047,9 +3047,10 @@ Where to align or place the status window (top, bottom, left, or right).
If NetHack can, it should display an ascii character map if it can.
.lp color
If NetHack can, it should display color if it can for different monsters,
objects, and dungeon features
objects, and dungeon features.
.lp eight_bit_tty
If NetHack can, it should pass eight-bit character values (for example, specified with the
If NetHack can, it should pass eight-bit character values (for example,
specified with the
.op traps
option) straight through to your terminal (default off).
.lp font_map
@@ -4241,7 +4242,7 @@ In early 2015, ahead of the release of 3.6.0, new members
joined the NetHack development team.
.pg
The 3.6 versions of the game are special in a particular way. Near the end of
the development of 3.6.0, one of the significant inspirations for many of
the development of 3.6.0, one of the significant inspirations for many of
the humorous and fun features found in the game, author Terry Pratchett,
passed away. The 3.6 versions of the game include a tribute to him.
.pg
@@ -4251,10 +4252,10 @@ patches. Many bugs were fixed and some code was restructured.
.pg
In 2018, several hundred bug fixes for 3.6.0 and some new features
were assembled and released as NetHack 3.6.1. The development team at
the time of release of 3.6.1 consisted of
the time of release of 3.6.1 consisted of
\fBWarwick Allison\fP,\fBMichael Allison\fP, \fBKen Arromdee\fP,
\fBDavid Cohrs\fP, \fBJessie Collet\fP, \fBPasi Kallinen\fP,
\fBKen Lorber\fP, \fBDean Luick\fP, \fBPatric Mueller\fP,
\fBDavid Cohrs\fP, \fBJessie Collet\fP, \fBPasi Kallinen\fP,
\fBKen Lorber\fP, \fBDean Luick\fP, \fBPatric Mueller\fP,
\fBPat Rankin\fP, \fBDerek S. Ray\fP, \fBAlex Smith\fP,
\fBMike Stephenson\fP, \fBJanet Walz\fP, and \fBPaul Winner\fP.
.pg
@@ -4265,7 +4266,7 @@ various Unix flavors and maintained the X11 interface.
\fBKen Lorber\fP, \fBHaoyang Wang\fP, \fBPat Rankin\fP, and \fBDean Luick\fP
maintained the port of NetHack 3.6 for Mac OSX.
.pg
\fBMichael Allison\fP, \fBDavid Cohrs\fP, \fBBarton House\fP,
\fBMichael Allison\fP, \fBDavid Cohrs\fP, \fBBarton House\fP,
\fBPasi Kallinen\fP, \fBAlex Kompel\fP, \fBDion Nicolaas\fP,
\fBDerek S. Ray\fP and \fBYitzhak Sapir\fP maintained the port of
NetHack 3.6 for Microsoft Windows.
@@ -4283,7 +4284,7 @@ The official NetHack web site is maintained by \fBKen Lorber\fP at http://www.ne
.hn 2
SPECIAL THANKS
.pg
On behalf of the NetHack community, thank you very much once
On behalf of the NetHack community, thank you very much once
again to \fBM. Drew Streib\fP, \fBPasi Kallinen\fP and \fBRobin Bandy\fP
for providing public NetHack servers at nethack.alt.org and devnull.net
and/or for hosting annual NetHack tournaments.

341
doc/Guidebook.tex
View File

@@ -52,9 +52,9 @@
%.hn 1
\section{Preface - Version 3.6}
%.pg
This version of the game is special in a particular way. Near the end of
the development of 3.6, one of the significant inspirations for many of the
humorous and fun features found in the game, author {\it Terry Pratchett},
This version of the game is special in a particular way. Near the end of
the development of 3.6, one of the significant inspirations for many of the
humorous and fun features found in the game, author {\it Terry Pratchett},
passed away. We have dedicated this version of the game in his memory.
%.pg
@@ -63,23 +63,23 @@ passed away. We have dedicated this version of the game in his memory.
%.pg
Recently, you have begun to find yourself unfulfilled and distant
in your daily occupation. Strange dreams of prospecting, stealing,
crusading, and combat have haunted you in your sleep for many months,
but you aren't sure of the reason. You wonder whether you have in
fact been having those dreams all your life, and somehow managed to
Recently, you have begun to find yourself unfulfilled and distant
in your daily occupation. Strange dreams of prospecting, stealing,
crusading, and combat have haunted you in your sleep for many months,
but you aren't sure of the reason. You wonder whether you have in
fact been having those dreams all your life, and somehow managed to
forget about them until now. Some nights you awaken suddenly
and cry out, terrified at the vivid recollection of the strange and
powerful creatures that seem to be lurking behind every corner of the
dungeon in your dream. Could these details haunting your dreams be real?
As each night passes, you feel the desire to enter the mysterious caverns
near the ruins grow stronger. Each morning, however, you quickly put
the idea out of your head as you recall the tales of those who entered
the caverns before you and did not return. Eventually you can resist
the yearning to seek out the fantastic place in your dreams no longer.
After all, when other adventurers came back this way after spending time
in the caverns, they usually seemed better off than when they passed
through the first time. And who was to say that all of those who did
and cry out, terrified at the vivid recollection of the strange and
powerful creatures that seem to be lurking behind every corner of the
dungeon in your dream. Could these details haunting your dreams be real?
As each night passes, you feel the desire to enter the mysterious caverns
near the ruins grow stronger. Each morning, however, you quickly put
the idea out of your head as you recall the tales of those who entered
the caverns before you and did not return. Eventually you can resist
the yearning to seek out the fantastic place in your dreams no longer.
After all, when other adventurers came back this way after spending time
in the caverns, they usually seemed better off than when they passed
through the first time. And who was to say that all of those who did
not return had not just kept going?
%.pg
@@ -88,23 +88,23 @@ which, if you can find it, will bring you great wealth. One legend you were
told even mentioned that the one who finds the amulet will be granted
immortality by the gods. The amulet is rumored to be somewhere beyond the
Valley of Gehennom, deep within the Mazes of Menace. Upon hearing the
legends, you immediately realize that there is some profound and
undiscovered reason that you are to descend into the caverns and seek
out that amulet of which they spoke. Even if the rumors of the amulet's
powers are untrue, you decide that you should at least be able to sell the
tales of your adventures to the local minstrels for a tidy sum, especially
if you encounter any of the terrifying and magical creatures of
your dreams along the way. You spend one last night fortifying yourself
at the local inn, becoming more and more depressed as you watch the odds
of your success being posted on the inn's walls getting lower and lower.
legends, you immediately realize that there is some profound and
undiscovered reason that you are to descend into the caverns and seek
out that amulet of which they spoke. Even if the rumors of the amulet's
powers are untrue, you decide that you should at least be able to sell the
tales of your adventures to the local minstrels for a tidy sum, especially
if you encounter any of the terrifying and magical creatures of
your dreams along the way. You spend one last night fortifying yourself
at the local inn, becoming more and more depressed as you watch the odds
of your success being posted on the inn's walls getting lower and lower.
%.pg
\nd In the morning you awake, collect your belongings, and
set off for the dungeon. After several days of uneventful
travel, you see the ancient ruins that mark the entrance to the
Mazes of Menace. It is late at night, so you make camp at the entrance
and spend the night sleeping under the open skies. In the morning, you
gather your gear, eat what may be your last meal outside, and enter the
\nd In the morning you awake, collect your belongings, and
set off for the dungeon. After several days of uneventful
travel, you see the ancient ruins that mark the entrance to the
Mazes of Menace. It is late at night, so you make camp at the entrance
and spend the night sleeping under the open skies. In the morning, you
gather your gear, eat what may be your last meal outside, and enter the
dungeon\ldots
%.hn 1
@@ -113,7 +113,7 @@ dungeon\ldots
%.pg
You have just begun a game of {\it NetHack}. Your goal is to grab as much
treasure as you can, retrieve the Amulet of Yendor, and escape the
Mazes of Menace alive.
Mazes of Menace alive.
%.pg
Your abilities and strengths for dealing with the hazards of adventure
@@ -245,8 +245,8 @@ The armor and weapons fashioned by the Orcs are typically of inferior quality.
%.hn 1
\section{What do all those things on the screen mean?}
%.pg
On the screen is kept a map of where you have been and what you have
seen on the current dungeon level; as you explore more of the level,
On the screen is kept a map of where you have been and what you have
seen on the current dungeon level; as you explore more of the level,
it appears on the screen in front of you.
%.pg
@@ -577,9 +577,9 @@ commands entry. Some commands,
like ``{\tt search}'', do not require that any more information be collected
by {\it NetHack\/}. Other commands might require additional information, for
example a direction, or an object to be used. For those commands that
require additional information, {\it NetHack\/} will present you with either
a menu of choices, or with a command line prompt requesting information. Which
you are presented with will depend chiefly on how you have set the
require additional information, {\it NetHack\/} will present you with either
a menu of choices, or with a command line prompt requesting information.
Which you are presented with will depend chiefly on how you have set the
`{\it menustyle\/}'
option.
@@ -728,10 +728,10 @@ Travel to a map location via a shortest-path algorithm.\\
The shortest path
is computed over map locations the hero knows about (e.g. seen or
previously traversed). If there is no known path, a guess is made instead.
Stops on most of
Stops on most of
the same conditions as the `G' command, but without picking up
objects, similar to the `M' command. For ports with mouse
support, the command is also invoked when a mouse-click takes place on a
objects, similar to the `M' command. For ports with mouse
support, the command is also invoked when a mouse-click takes place on a
location other than the current position.
%.lp
\item[\tb{.}]
@@ -746,7 +746,7 @@ process. Confirmation is required.
\item[\tb{A}]
Remove one or more worn items, such as armor.\\
%.lp ""
Use `{\tt T}' (take off) to take off only one piece of armor
Use `{\tt T}' (take off) to take off only one piece of armor
or `{\tt R}' (remove) to take off only one accessory.
%.lp
\item[\tb{\^{}A}]
@@ -1240,7 +1240,7 @@ Show mobile light sources. Autocompletes. Wizard-mode only.
Look at what is here, under you. Default key is '{\tt :}'.
%.lp
\item[\tb{\#loot}]
Loot a box or bag on the floor beneath you, or the saddle
Loot a box or bag on the floor beneath you, or the saddle
from a steed standing next to you. Autocompletes.
Default key is '{\tt M-l}', and '{\tt l}' if {\it number\verb+_+pad\/} is on.
Precede with the `{\tt m}' prefix to skip containers at your location
@@ -1537,7 +1537,7 @@ two character sequence consisting of an {\tt Escape}
followed by the other key, you may set the {\it altmeta\/}
option to have {\it NetHack\/} combine them into meta\+key.
\blist{}
%.lp
%.lp
\item[\tb{M-?}]
{\tt\#?} (not supported by all platforms)
%.lp
@@ -1621,7 +1621,7 @@ option to have {\it NetHack\/} combine them into meta\+key.
\nd If the {\it number\verb+_+pad\/} option is on, some additional letter commands
are available:
\blist{}
%.lp
%.lp
\item[\tb{h}]
{\tt\#help}
%.lp
@@ -1647,7 +1647,7 @@ are available:
%.pg
Rooms and corridors in the dungeon are either lit or dark.
Any lit areas within your line of sight will be displayed;
dark areas are only displayed if they are within one space of you.
dark areas are only displayed if they are within one space of you.
Walls and corridors remain on the map as you explore them.
%.pg
@@ -1841,7 +1841,7 @@ Remember: discretion is the better part of valor.
%.pg
In most circumstances, if you attempt to attack a peaceful monster by
moving into its location, you'll be asked to confirm your intent. By
moving into its location, you'll be asked to confirm your intent. By
default an answer of `{\tt y}' acknowledges that intent,
which can be error prone if you're using `{\tt y}' to move. You can set the
{\it paranoid\verb+_+confirmation\/}
@@ -2188,7 +2188,7 @@ To wield two weapons, you need to use the ``{\tt \#twoweapon}'' command.
But first you need to have a weapon in each hand.
(Note that your two weapons are not fully equal; the one in the
hand you normally wield with is considered primary and the other
one is considered secondary. The most noticeable difference is
one is considered secondary. The most noticeable difference is
after you stop--or before you begin, for that matter--wielding
two weapons at once. The primary is your wielded weapon and the
secondary is just an item in your inventory that's been designated
@@ -2692,7 +2692,7 @@ command allows you to view all options and change most of them.
You can also set options automatically by placing them in a configuration
file, or in the ``NETHACKOPTIONS'' environment variable.
Some versions of {\it NetHack\/} also have front-end programs that allow
you to set options before starting the game or a global configuration
you to set options before starting the game or a global configuration
for system administrators.
%.hn 2
@@ -3013,7 +3013,7 @@ Allows looking at things on the screen by navigating the mouse
over them and clicking the right mouse button (default off).
%.lp
\item[\ib{cmdassist}]
Have the game provide some additional command assistance for new
Have the game provide some additional command assistance for new
players if it detects some anticipated mistakes (default on).
%.lp
\item[\ib{confirm}]
@@ -3082,7 +3082,7 @@ The example sets
%.lp ""
Note that the vanquished monsters list includes all monsters killed by
traps and each other as well as by you.
traps and each other as well as by you.
And the dungeon overview shows all levels you had visited but does not
reveal things about them that you hadn't discovered.
%.lp
@@ -3093,7 +3093,7 @@ Cannot be set with the `{\tt O}' command.
\item[\ib{extmenu}]
Changes the extended commands interface to pop-up a menu of available commands.
It is keystroke compatible with the traditional interface except that it does
not require that you hit Enter. It is implemented only by the tty port
not require that you hit Enter. It is implemented only by the tty port
(default off), when the game has been compiled to support tty graphics.
%.lp
\item[\ib{female}]
@@ -3123,7 +3123,7 @@ 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.
exclude that gender from being picked randomly.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{goldX}]
@@ -3293,7 +3293,7 @@ Allows you to change the way recalled messages are displayed.
For backward compatibility, no value needs to be specified (which
defaults to {\it full\/}), or it can be negated (which defaults
to {\it single\/}).
to {\it single\/}).
%.lp
\item[\ib{name}]
Set your character's name (defaults to your user name). You can also
@@ -3424,12 +3424,14 @@ or overLoaded), you will be asked if you want to continue.
%.lp
\item[\ib{pickup\verb+_+thrown}]
If this option is on and ``{\it autopickup\/}'' is also on, try to pick up
things that you threw, even if they aren't in ``{\it pickup\verb+_+types\/}'' or
things that you threw, even if they aren't in
``{\it pickup\verb+_+types\/}'' or
match an autopickup exception. Default is on. Persistent.
%.lp
\item[\ib{pickup\verb+_+types}]
Specify the object types to be picked up when ``{\it autopickup\/}''
is on. Default is all types. You can use ``{\it autopickup\verb+_+exception\/}''
Specify the object types to be picked up when ``{\it autopickup\/}''
is on. Default is all types. You can use
``{\it autopickup\verb+_+exception\/}''
configuration file lines to further refine ``{\it autopickup\/}'' behavior.
Persistent.
%.lp
@@ -3460,7 +3462,7 @@ become wielded. Persistent.
\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.
exclude that race from being picked randomly.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{rest\verb+_+on\verb+_+space}]
@@ -3504,7 +3506,7 @@ The possible values are:
%.ed
This option only affects the game's screen display, not the actual
results of moving. The default is {\it run\/}; versions prior to 3.4.1
results of moving. The default is {\it run\/}; versions prior to 3.4.1
used {\it teleport\/} only. Whether or not the effect is noticeable will
depend upon the window port used or on the type of terminal. Persistent.
%.lp
@@ -3569,7 +3571,7 @@ Allow updates to the status lines at the bottom of the screen (default true).
%.lp
\item[\ib{suppress\verb+_+alert}]
This option may be set to a {\it NetHack\/} version level to suppress
alert notification messages about feature changes for that
alert notification messages about feature changes for that
and prior versions (ex.\ ``{\tt suppress\verb+_+alert:3.3.1}'')
%.lp
\item[\ib{symset}]
@@ -3669,8 +3671,8 @@ Select which windowing system to use, such as ``{\tt tty}'' or ``{\tt X11}''
Cannot be set with the `{\tt O}' command.
%.lp
\item[\ib{zerocomp}]
When writing out a save file, perform zero-comp compression of the
contents. Not all ports support zero-comp compression. It has no effect
When writing out a save file, perform zero-comp compression of the
contents. Not all ports support zero-comp compression. It has no effect
on reading an existing save file.
\elist
@@ -3683,10 +3685,10 @@ used to customize and change the characteristics of the
windowtype that you have chosen.
Character strings that are too long may be truncated.
Not all window ports will adjust for all settings listed
here. You can safely add any of these options to your
config file, and if the window port is capable of adjusting
here. You can safely add any of these options to your
config file, and if the window port is capable of adjusting
to suit your preferences, it will attempt to do so. If it
can't it will silently ignore it. You can find out if an
can't it will silently ignore it. You can find out if an
option is supported by the window port that you are currently
using by checking to see if it shows up in the Options list.
Some options are dynamic and can be specified during the game
@@ -3704,18 +3706,21 @@ with the `{\tt O}' command.
If {\it NetHack\/} can, it should display an ascii map.
%.lp
\item[\ib{color}]
If {\it NetHack\/} can, it should display color for different monsters objects, and dungeon features.
If {\it NetHack\/} can, it should display color for different monsters,
objects, and dungeon features.
%.lp
\item[\ib{eight\verb+_+bit\verb+_+tty}]
Pass eight-bit character values (for example, specified with the {\it
traps \/} option) straight through to your terminal (default off).
Pass eight-bit character values (for example, specified with the
{\it traps \/} option) straight through to your terminal (default off).
%.lp
\item[\ib{font\verb+_+map}]
If {\it NetHack\/} can, it should use a font by the chosen name for the map window.
If {\it NetHack\/} can, it should use a font by the chosen name for the
map window.
%.lp
\item[\ib{font\verb+_+menu}]
If {\it NetHack\/} can, it should use a font by the chosen name for menu windows.
If {\it NetHack\/} can, it should use a font by the chosen name for menu
windows.
%.lp
\item[\ib{font\verb+_+message}]
If {\it NetHack\/} can, it should use a font by the chosen name for the message window.
@@ -3803,22 +3808,23 @@ Use bold black instead of blue for black glyphs (TTY only).
If {\it NetHack\/} can, it should display inverse when the game specifies it.
%.lp
\item[\ib{vary\verb+_+msgcount}]
If {\it NetHack\/} can, it should display this number of messages at a time in the message window.
If {\it NetHack\/} can, it should display this number of messages at a time
in the message window.
%.lp
\item[\ib{windowcolors}]
If {\it NetHack\/} can, it should display windows with the specified foreground/background
colors if it can.
If {\it NetHack\/} can, it should display windows with the specified
foreground/background colors if it can.
%.lp
\item[\ib{wraptext}]
If {\it NetHack\/} can, it should wrap long lines of text if they don't fit in
the visible area of the window.
If {\it NetHack\/} can, it should wrap long lines of text if they don't fit
in the visible area of the window.
\elist
%.hn 2
\subsection*{Platform-specific Customization options}
%.pg
Here are explanations of options that are used by specific platforms
Here are explanations of options that are used by specific platforms
or ports to customize and change the port behavior.
\blist{}
@@ -3851,20 +3857,20 @@ finish cancelling such a count. At other prompts a single ESC suffices.
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
%.lp
\item[\ib{flush}]
(default off, {\it Amiga NetHack \/} only).
%.lp
%.lp
\item[\ib{Macgraphics}]
(default on, {\it Mac NetHack \/} only).
%.lp
%.lp
\item[\ib{page\verb+_+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).
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
@@ -3875,7 +3881,8 @@ Cannot be set with the `{\tt O}' command.
\item[\ib{subkeyvalue}]
({\it Win32 tty NetHack \/} only).
May be used to alter the value of keystrokes that the operating system
returns to {\it NetHack\/} to help compensate for international keyboard issues.
returns to {\it NetHack\/} to help compensate for international keyboard
issues.
OPTIONS=subkeyvalue:171/92
will return 92 to {\it NetHack\/}, if 171 was originally going to be returned.
You can use multiple subkeyvalue statements in the config file if needed.
@@ -3883,9 +3890,9 @@ 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.
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}]
@@ -3937,7 +3944,7 @@ The {\it autopickup\verb+_+exception\/} option should be followed by a regular
expression to be used as a pattern to match against the singular form of the
description of an object at your location.
In addition, some characters are treated specially if they occur as the first
In addition, some characters are treated specially if they occur as the first
character in the pattern, specifically:
%.sd
@@ -4258,7 +4265,7 @@ displayed with the ``uncursed'' description.
\subsection*{Configuring User Sounds}
%.pg
Some platforms allow you to define sound files to be played when a message
Some platforms allow you to define sound files to be played when a message
that matches a user-defined pattern is delivered to the message window.
At this time the Qt port and the win32tty and win32gui ports support the
use of user sounds.
@@ -4295,7 +4302,7 @@ The pattern should be a regular expression.
%.pg
Your copy of {\it NetHack\/} may have been compiled with support for {\it Status Hilites}.
If so, you can customize your game display by setting thresholds to
If so, you can customize your game display by setting thresholds to
change the color or appearance of fields in the status display.
%.pg
The format for defining status colors is:
@@ -4396,7 +4403,7 @@ Note that the platform used may interpret the attributes any way it
wants.
%.lp ""
The in-game options menu can help you determine the correct syntax for a
The in-game options menu can help you determine the correct syntax for a
config file.
%.lp ""
@@ -4425,7 +4432,7 @@ Example hilites:
{\it NetHack\/} can load entire symbol sets from the symbol file.
%.pg
The options that are used to select a particular symbol set from the
The options that are used to select a particular symbol set from the
symbol file are:
\blist{}
@@ -4436,12 +4443,12 @@ Set the name of the symbol set that you want to load.
%.lp
\item[\ib{roguesymset}]
Set the name of the symbol set that you want to load for display
Set the name of the symbol set that you want to load for display
on the rogue level.
\elist
You can also override one or more symbols using the {\it SYMBOLS\/} config
file option. Symbols are specified as {\it name:value\/} pairs. Note that
You can also override one or more symbols using the {\it SYMBOLS\/} config
file option. Symbols are specified as {\it name:value\/} pairs. Note that
{\it NetHack\/} escape-processes the {\it value\/} string in conventional C
fashion. This means that `\verb+\+' is a prefix to take the following
character literally. Thus `\verb+\+' needs to be represented as `\verb+\\+'.
@@ -4640,7 +4647,8 @@ Default & Symbol Name & Description\\
%.pg
{\it NetHack\/} can be set up to use only standard ASCII characters for making
maps of the dungeons. This makes the MS-DOS versions of {\it NetHack\/} completely
maps of the dungeons. This makes the MS-DOS versions of {\it NetHack\/}
completely
accessible to the blind who use speech and/or Braille access technologies.
Players will require a good working knowledge of their screen-reader's
review features, and will have to know how to navigate horizontally and
@@ -4666,12 +4674,12 @@ only parameter.
%.pg
While it is not difficult for experienced users to edit the {\it defaults.nh\/}
file to accomplish this, novices may find this task somewhat daunting.
Included within the symbol file of all official distributions of {\it NetHack\/}
Included within the symbol file of all official distributions of {\it NetHack\/}
is a symset called {\it NHAccess\/}. Selecting that symset in your
configuration file will cause the game to run in a manner accessible
to the blind. After you have gained some experience with the game
and with editing files, you may want to alter settings via {\it SYMBOLS=\/}
in your configuration file to better suit your preferences.
configuration file will cause the game to run in a manner accessible
to the blind. After you have gained some experience with the game
and with editing files, you may want to alter settings via {\it SYMBOLS=\/}
in your configuration file to better suit your preferences.
The most crucial settings to make the game accessible are:
%.pg
\blist{}
@@ -4680,7 +4688,7 @@ The most crucial settings to make the game accessible are:
Load a symbol set appropriate for use by blind players.
%.lp
\item[\ib{roguesymset:NHAccess}]
Load a symbol set for the rogue level that is appropriate for
Load a symbol set for the rogue level that is appropriate for
use by blind players.
%.lp
\item[\ib{menustyle:traditional}]
@@ -4691,8 +4699,8 @@ Show menus on a cleared screen and aligned to the left edge.
%.lp
\item[\ib{number\verb+_+pad}]
A lot of speech access programs use the number-pad to review the screen.
If this is the case, disable the number\verb+_+pad option and use the traditional
Rogue-like commands.
If this is the case, disable the number\verb+_+pad option and use the
traditional Rogue-like commands.
%.lp
\item[\ib{autodescribe}]
Automatically describe the terrain under the cursor when targeting.
@@ -4724,7 +4732,7 @@ seen via the {\tt \#attributes} command.
%.pg
If {\it NetHack\/} is compiled with the SYSCF option, a system administrator
should set up a global configuration; this is a file in the
should set up a global configuration; this is a file in the
same format as the traditional per-user configuration file (see above).
This file should be named sysconf and placed in the same directory as
@@ -5054,33 +5062,33 @@ simultaneously with 3.3.0 in December 1999 just in time for the Year 2000.
%.pg
\medskip
The 3.3 development team, consisting of {\it Michael Allison}, {\it Ken Arromdee},
{\it David Cohrs}, {\it Jessie Collet}, {\it Steve Creps}, {\it Kevin Darcy},
{\it Timo Hakulinen}, {\it Kevin Hugo}, {\it Steve Linhart}, {\it Ken Lorber},
{\it Dean Luick}, {\it Pat Rankin}, {\it Eric Smith}, {\it Mike Stephenson},
{\it Janet Walz}, and {\it Paul Winner}, released 3.3.0 in
The 3.3 development team, consisting of {\it Michael Allison}, {\it Ken Arromdee},
{\it David Cohrs}, {\it Jessie Collet}, {\it Steve Creps}, {\it Kevin Darcy},
{\it Timo Hakulinen}, {\it Kevin Hugo}, {\it Steve Linhart}, {\it Ken Lorber},
{\it Dean Luick}, {\it Pat Rankin}, {\it Eric Smith}, {\it Mike Stephenson},
{\it Janet Walz}, and {\it Paul Winner}, released 3.3.0 in
December 1999 and 3.3.1 in August of 2000.
%.pg
\medskip
Version 3.3 offered many firsts. It was the first version to separate race
and profession. The Elf class was removed in preference to an elf race,
and the races of dwarves, gnomes, and orcs made their first appearance in
the game alongside the familiar human race. Monk and Ranger roles joined
Archeologists, Barbarians, Cavemen, Healers, Knights, Priests, Rogues, Samurai,
Version 3.3 offered many firsts. It was the first version to separate race
and profession. The Elf class was removed in preference to an elf race,
and the races of dwarves, gnomes, and orcs made their first appearance in
the game alongside the familiar human race. Monk and Ranger roles joined
Archeologists, Barbarians, Cavemen, Healers, Knights, Priests, Rogues, Samurai,
Tourists, Valkyries and of course, Wizards. It was also the first version
to allow you to ride a steed, and was the first version to have a publicly
available web-site listing all the bugs that had been discovered. Despite
to allow you to ride a steed, and was the first version to have a publicly
available web-site listing all the bugs that had been discovered. Despite
that constantly growing bug list, 3.3 proved stable enough to last for
more than a year and a half.
%.pg
\medskip
The 3.4 development team initially consisted of
The 3.4 development team initially consisted of
{\it Michael Allison}, {\it Ken Arromdee},
{\it David Cohrs}, {\it Jessie Collet}, {\it Kevin Hugo}, {\it Ken Lorber},
{\it Dean Luick}, {\it Pat Rankin}, {\it Mike Stephenson},
{\it Janet Walz}, and {\it Paul Winner}, with {\it Warwick Allison} joining
{\it Dean Luick}, {\it Pat Rankin}, {\it Mike Stephenson},
{\it Janet Walz}, and {\it Paul Winner}, with {\it Warwick Allison} joining
just before the release of {\it NetHack\/} 3.4.0 in March 2002.
%.pg
@@ -5095,7 +5103,8 @@ runs on:
%.pg
\medskip
\nd {\it Michael Allison} maintained {\it NetHack\/} 3.4 for the MS-DOS platform.
\nd {\it Michael Allison} maintained {\it NetHack\/} 3.4 for the MS-DOS
platform.
{\it Paul Winner} and {\it Yitzhak Sapir} provided encouragement.
%.pg
@@ -5105,17 +5114,20 @@ enhanced the Macintosh port of 3.4.
%.pg
\medskip
\nd {\it Michael Allison}, {\it David Cohrs}, {\it Alex Kompel}, {\it Dion Nicolaas}, and
{\it Yitzhak Sapir} maintained and enhanced 3.4 for the Microsoft Windows platform.
{\it Alex Kompel} contributed a new graphical interface for the Windows port.
\nd {\it Michael Allison}, {\it David Cohrs}, {\it Alex Kompel},
{\it Dion Nicolaas}, and
{\it Yitzhak Sapir} maintained and enhanced 3.4 for the Microsoft Windows
platform.
{\it Alex Kompel} contributed a new graphical interface for the Windows port.
{\it Alex Kompel} also contributed a Windows CE port for 3.4.1.
%.pg
\medskip
\nd {\it Ron Van Iwaarden} was the sole maintainer of {\it NetHack\/} for OS/2 the past
\nd {\it Ron Van Iwaarden} was the sole maintainer of {\it NetHack\/} for
OS/2 the past
several releases. Unfortunately Ron's last OS/2 machine stopped working in
early 2006. A great many thanks to Ron for keeping {\it NetHack\/} alive on OS/2
all these years.
early 2006. A great many thanks to Ron for keeping {\it NetHack\/} alive on
OS/2 all these years.
%.pg
\medskip
@@ -5130,27 +5142,27 @@ resurrected it for 3.3.1.
%.pg
\medskip
The release of {\it NetHack\/} 3.4.3 in December 2003 marked the beginning of a
long release hiatus. 3.4.3 proved to be a remarkably stable version that
provided continued enjoyment by the community for more than a decade. The
devteam slowly and quietly continued to work on the game behind the scenes
during the tenure of 3.4.3. It was during that same period that several new
variants emerged within the {\it NetHack\/} community. Notably sporkhack by
Derek S. Ray, {\it unnethack\/} by Patric Mueller, {\it nitrohack\/} and its successors
originally by Daniel Thaler and then by Alex Smith, and
{\it Dynahack\/} by Tung Nguyen. Some of those variants continue to be developed,
maintained, and enjoyed by the community to this day.
The release of {\it NetHack\/} 3.4.3 in December 2003 marked the beginning of
a long release hiatus. 3.4.3 proved to be a remarkably stable version that
provided continued enjoyment by the community for more than a decade. The
devteam slowly and quietly continued to work on the game behind the scenes
during the tenure of 3.4.3. It was during that same period that several new
variants emerged within the {\it NetHack\/} community. Notably sporkhack by
Derek S. Ray, {\it unnethack\/} by Patric Mueller, {\it nitrohack\/} and its
successors originally by Daniel Thaler and then by Alex Smith, and
{\it Dynahack\/} by Tung Nguyen. Some of those variants continue to be
developed, maintained, and enjoyed by the community to this day.
%.pg
\medskip
In September 2014, an interim snapshot of the code under development was
released publicly by other parties. Since that code was a work-in-progress
In September 2014, an interim snapshot of the code under development was
released publicly by other parties. Since that code was a work-in-progress
and had not gone through the process of debugging it as a suitable release,
it was decided that the version numbers present on that code snapshot would
be retired and never used in an official {\it NetHack\/} release. An announcement
was posted on the devteam's official {\it nethack.org\/} website to that effect,
stating that there would never be a 3.4.4, 3.5, or 3.5.0 official release
version.
it was decided that the version numbers present on that code snapshot would
be retired and never used in an official {\it NetHack\/} release. An
announcement was posted on the devteam's official {\it nethack.org\/} website
to that effect, stating that there would never be a 3.4.4, 3.5, or 3.5.0
official release version.
%.pg
\medskip
@@ -5159,10 +5171,10 @@ In January 2015, preparation began for the release of NetHack 3.6.
%.pg
\medskip
At the beginning of development for what would eventually get released
as 3.6.0, the development team consisted of {\it Warwick Allison},
as 3.6.0, the development team consisted of {\it Warwick Allison},
{\it Michael Allison}, {\it Ken Arromdee},
{\it David Cohrs}, {\it Jessie Collet},
{\it Ken Lorber}, {\it Dean Luick}, {\it Pat Rankin},
{\it David Cohrs}, {\it Jessie Collet},
{\it Ken Lorber}, {\it Dean Luick}, {\it Pat Rankin},
{\it Mike Stephenson}, {\it Janet Walz}, and {\it Paul Winner}.
In early 2015, ahead of the release of 3.6.0, new members
{\it Sean Hunt}, {\it Pasi Kallinen}, and {\it Derek S. Ray}
@@ -5178,32 +5190,35 @@ passed away. The 3.6 versions of the game include a tribute to him.
%.pg
\medskip
3.6.0 was released in December 2015, and merged work done by the development
team since the release of 3.4.3 with some of the beloved community
team since the release of 3.4.3 with some of the beloved community
patches. Many bugs were fixed and some code was restructured.
%.pg
\medskip
In 2018, several hundred bug fixes for 3.6.0 and some new features
were assembled and released as NetHack 3.6.1. The development team at
the time of release of 3.6.1 consisted of {\it Michael Allison}, {\it Ken Arromdee},
{\it David Cohrs}, {\it Jessie Collet}, {\it Pasi Kallinen}, {\it Ken Lorber},
{\it Dean Luick}, {\it Patric Mueller}, {\it Pat Rankin}, {\it Derek S. Ray},
{\it Alex Smith}, {\it Mike Stephenson}, {\it Janet Walz}, and {\it Paul Winner}.
In 2018, several hundred bug fixes for 3.6.0 and some new features
were assembled and released as NetHack 3.6.1. The development team at
the time of release of 3.6.1 consisted of {\it Michael Allison},
{\it Ken Arromdee}, {\it David Cohrs}, {\it Jessie Collet},
{\it Pasi Kallinen}, {\it Ken Lorber}, {\it Dean Luick},
{\it Patric Mueller}, {\it Pat Rankin}, {\it Derek S. Ray},
{\it Alex Smith}, {\it Mike Stephenson}, {\it Janet Walz}, and
{\it Paul Winner}.
%.pg
\medskip
The development team, as well as {\it Steve VanDevender} and
{\it Kevin Smolkowski}, ensured that {\it NetHack\/} 3.6 continued to operate on
various Unix flavors and maintained the X11 interface.
The development team, as well as {\it Steve VanDevender} and
{\it Kevin Smolkowski}, ensured that {\it NetHack\/} 3.6 continued to
operate on various Unix flavors and maintained the X11 interface.
%.pg
{\it Ken Lorber}, {\it Haoyang Wang}, {\it Pat Rankin}, and {\it Dean Luick}
{\it Ken Lorber}, {\it Haoyang Wang}, {\it Pat Rankin}, and {\it Dean Luick}
maintained the port of {\it NetHack\/} 3.6 for Mac OSX.
%.pg
\medskip
{\it Michael Allison}, {\it David Cohrs}, {\it Barton House}, {\it Pasi Kallinen},
{\it Alex Kompel}, {\it Dion Nicolaas}, {\it Derek S. Ray} and {\it Yitzhak Sapir}
{\it Michael Allison}, {\it David Cohrs}, {\it Barton House},
{\it Pasi Kallinen}, {\it Alex Kompel}, {\it Dion Nicolaas},
{\it Derek S. Ray} and {\it Yitzhak Sapir}
maintained the port of {\it NetHack\/} 3.6 for Microsoft Windows.
%.pg
@@ -5220,7 +5235,7 @@ necessary updates to the community at large.
%.pg
\medskip
\nd The official {\it NetHack\/} web site is maintained by {\it Ken Lorber} at
\nd The official {\it NetHack\/} web site is maintained by {\it Ken Lorber} at
{\catcode`\#=11
\special{html:<a href="http://www.nethack.org/">}}
http:{\tt /}{\tt /}www.nethack.org{\tt /}.
@@ -5231,10 +5246,10 @@ http:{\tt /}{\tt /}www.nethack.org{\tt /}.
%.hn 2
\subsection*{Special Thanks}
\nd On behalf ot the {\it NetHack\/} community, thank you very much once
\nd On behalf ot the {\it NetHack\/} community, thank you very much once
again to {\it M. Drew Streib}, {\it Pasi Kallinen} and {\it Robin Bandy} for
providing public {\it NetHack\/} servers at {\it nethack.alt.org\/} and {\it devnull.net\/}
and/or for hosting annual {\it NetHack\/} tournaments.
providing public {\it NetHack\/} servers at {\it nethack.alt.org\/} and
{\it devnull.net\/} and/or for hosting annual {\it NetHack\/} tournaments.
\clearpage
%.hn

6
doc/fixes36.1
View File

@@ -80,7 +80,7 @@ change "unlockable chest" to "broken chest" so that it won't be misunderstood
use doname instead of xname when using '/' or ';' to look at objects on map
when a pet moves reluctantly, name the top item of the pile it is reluctant
to step on if the hero sees or remembers any object(s) at that spot
ensure sufficient messages are given to clarify the transition from detected
ensure sufficient messages are given to clarify the transition from detected
vampire bats to fog clouds in Vlad's tower
fix "killing by kicking something weird" when kicking an object causes death
avoid accessing mextra fields which haven't been allocated
@@ -519,7 +519,7 @@ change the deity's "congratulations" message upon ascension to something which
sounds a bit more archaic to fit better with the other messages
prayer boon of 'fix all troubles' could get stuck in an infinite loop for
TROUBLE_STUCK_IN_WALL if there was no spot to teleport into available
It shouldn't be considered hypocrisy if you speed up your pet while standing
It shouldn't be considered hypocrisy if you speed up your pet while standing
on Elbereth
fix 'object lost' panic if hero with lycanthropy but in human form is wielding
a potion of unholy water which gets boiled/exploded by fire, causing
@@ -869,7 +869,7 @@ Ray Chason's fix: window interfaces that support transparency may give away
Ray Chason's xprname should honor iflags.menu_tab_sep
Ray Chason's punctuation for "That foo is really a mimic."
Ray Chason's proper background tiles for lava and water
Ray Chason's MS-DOS port restored to functionality with credit to Reddit user
Ray Chason's MS-DOS port restored to functionality with credit to Reddit user
b_helyer for the fix to sys/share/pcmain.c
Ray Chason's MSDOS port support for some VESA modes
Ray Chason's Qt4 windowport