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

Guidebook: implicit_uncursed

Browse Source 
Some old beta-tester mail suggested mentioning the implicit_uncursed
option in the "Curses and Blessings" section; this patch does that.
It also mentions that option in the "Configuring Menu Colors" section
since anyone trying to specify a color for " uncursed " will want
objects to be explicitly described as "uncursed".

The changes to the LaTeX version haven't been tested.  The generated
plain text version has a lot of spurious changes due to the padding
method it uses to right-justify short lines.
This commit is contained in:
PatR
2015-11-30 12:59:17 -08:00
parent 99fb812101
commit 0a5fadab68
3 changed files with 690 additions and 669 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/Guidebook.mn
+11 -1
View File
@@ -1,4 +1,4 @@
.\" $NHDT-Branch: master $:$NHDT-Revision: 1.181 $ $NHDT-Date: 1438735256 2015/08/05 00:40:56 $ .\" $NHDT-Branch: master $:$NHDT-Revision: 1.186 $ $NHDT-Date: 1448917136 2015/11/30 20:58:56 $
.ds h0 "NetHack Guidebook .ds h0 "NetHack Guidebook
.ds h1 .ds h1
.ds h2 % .ds h2 %
@@ -1314,6 +1314,10 @@ by the presence of the word ``cursed'', ``uncursed'' or ``blessed'' in the
description of the item. description of the item.
In some cases ``uncursed'' will be omitted as being redundant when In some cases ``uncursed'' will be omitted as being redundant when
enough other information is displayed. enough other information is displayed.
The
.op implicit_uncursed
option can be used to control this; toggle it off to have ``uncursed''
be displayed even when that can be deduced from other attributes.
.hn 2 .hn 2
Weapons (`)') Weapons (`)')
.pg .pg
@@ -2798,6 +2802,12 @@ on the same line will be shown in red color and underlined.
You can have multiple MENUCOLOR entries in your config file, You can have multiple MENUCOLOR entries in your config file,
and the last MENUCOLOR-line in your config file that matches and the last MENUCOLOR-line in your config file that matches
a menu line will be used for the line. a menu line will be used for the line.
.pg
Note that if you intend to have one or more color specifications match
" uncursed ", you will probably want to turn the
.op implicit_uncursed
option off so that all items known to be uncursed are actually
displayed with the ``uncursed'' description.
.hn 2 .hn 2
Configuring User Sounds Configuring User Sounds
.pg .pg
doc/Guidebook.tex
+11
View File
@@ -1607,6 +1607,10 @@ by the presence of the word ``cursed'', ``uncursed'' or ``blessed'' in the
description of the item. description of the item.
In some cases ``uncursed'' will be omitted as being redundant when In some cases ``uncursed'' will be omitted as being redundant when
enough other information is displayed. enough other information is displayed.
The
{\it implicit\verb+_+uncursed\/}
option can be used to control this; toggle it off to have ``uncursed''
be displayed even when that can be deduced from other attributes.
%.hn 2 %.hn 2
\subsection*{Weapons (`{\tt )}')} \subsection*{Weapons (`{\tt )}')}
@@ -3374,6 +3378,13 @@ You can have multiple MENUCOLOR entries in your config file,
and the last MENUCOLOR-line in your config file that matches and the last MENUCOLOR-line in your config file that matches
a menu line will be used for the line. a menu line will be used for the line.
%.pg
Note that if you intend to have one or more color specifications match
" uncursed ", you will probably want to turn the
{\it implicit\verb+_+uncursed\/}
option off so that all items known to be uncursed are actually
displayed with the ``uncursed'' description.
%.lp %.lp
%.hn 2 %.hn 2
\subsection*{Configuring User Sounds} \subsection*{Configuring User Sounds}
doc/Guidebook.txt
+99 -99
View File
@@ -1639,9 +1639,9 @@
distinguished in your inventory by the presence of the word distinguished in your inventory by the presence of the word
``cursed'', ``uncursed'' or ``blessed'' in the description of the ``cursed'', ``uncursed'' or ``blessed'' in the description of the
item. In some cases ``uncursed'' will be omitted as being redun- item. In some cases ``uncursed'' will be omitted as being redun-
dant when enough other information is displayed. dant when enough other information is displayed. The implic-
it_uncursed option can be used to control this; toggle it off to
have ``uncursed'' be displayed even when that can be deduced from
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -1654,6 +1654,8 @@
other attributes.
7.2. Weapons (`)') 7.2. Weapons (`)')
Given a chance, most monsters in the Mazes of Menace will Given a chance, most monsters in the Mazes of Menace will
@@ -1705,9 +1707,7 @@
mand which allows you to unwield the current weapon in addition mand which allows you to unwield the current weapon in addition
to taking off other worn items. to taking off other worn items.
Those of you in the audience who are AD&D players, be aware
that each weapon which existed in AD&D does roughly the same dam-
age to monsters in NetHack. Some of the more obscure weapons
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -1720,6 +1720,9 @@
Those of you in the audience who are AD&D players, be aware
that each weapon which existed in AD&D does roughly the same dam-
age to monsters in NetHack. Some of the more obscure weapons
(such as the aklys, lucern hammer, and bec-de-corbin) are defined (such as the aklys, lucern hammer, and bec-de-corbin) are defined
in an appendix to Unearthed Arcana, an AD&D supplement. in an appendix to Unearthed Arcana, an AD&D supplement.
@@ -1768,12 +1771,9 @@
in the same direction; if the first ones kill a monster, the oth- in the same direction; if the first ones kill a monster, the oth-
ers can still continue beyond that spot. ers can still continue beyond that spot.
7.2.2. Weapon proficiency
You will have varying degrees of skill in the weapons avail-
able. Weapon proficiency, or weapon skills, affect how well you
can use particular types of weapons, and you'll be able to im-
prove your skills as you progress through a game, depending on
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -1786,6 +1786,12 @@
7.2.2. Weapon proficiency
You will have varying degrees of skill in the weapons avail-
able. Weapon proficiency, or weapon skills, affect how well you
can use particular types of weapons, and you'll be able to im-
prove your skills as you progress through a game, depending on
your role, your experience level, and use of the weapons. your role, your experience level, and use of the weapons.
For the purposes of proficiency, weapons have been divided For the purposes of proficiency, weapons have been divided
@@ -1834,12 +1840,6 @@
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 after you stop--or before you begin, for that matter--wielding
two weapons at once. The primary is your wielded weapon and the two weapons at once. The primary is your wielded weapon and the
secondary is just an item in your inventory that's been designat-
ed as alternate weapon.)
If your primary weapon is wielded but your off hand is empty
or has the wrong weapon, use the sequence 'x', 'w', 'x' to first
swap your primary into your off hand, wield whatever you want as
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -1852,6 +1852,12 @@
secondary is just an item in your inventory that's been designat-
ed as alternate weapon.)
If your primary weapon is wielded but your off hand is empty
or has the wrong weapon, use the sequence 'x', 'w', 'x' to first
swap your primary into your off hand, wield whatever you want as
secondary weapon, then swap them both back into the intended secondary weapon, then swap them both back into the intended
hands. If your secondary or alternate weapon is correct but your hands. If your secondary or alternate weapon is correct but your
primary one is not, simply use 'w' to wield the primary. Lastly, primary one is not, simply use 'w' to wield the primary. Lastly,
@@ -1899,12 +1905,6 @@
orcish ring mail 8 orcish ring mail 8
leather armor 8 leather armor 8
leather jacket 9 leather jacket 9
no armor 10
You can also wear other pieces of armor (ex. helmets, boots,
shields, cloaks) to lower your armor class even further, but you
can only wear one item of each category (one suit of armor, one
cloak, one helmet, one shield, and so on) at a time.
@@ -1918,6 +1918,13 @@
no armor 10
You can also wear other pieces of armor (ex. helmets, boots,
shields, cloaks) to lower your armor class even further, but you
can only wear one item of each category (one suit of armor, one
cloak, one helmet, one shield, and so on) at a time.
If a piece of armor is enchanted, its armor protection will If a piece of armor is enchanted, its armor protection will
be better (or worse) than normal, and its ``plus'' (or minus) be better (or worse) than normal, and its ``plus'' (or minus)
will subtract from your armor class. For example, a +1 chain will subtract from your armor class. For example, a +1 chain
@@ -1966,13 +1973,6 @@
``THANX MAUD'' backwards). Scrolls disappear after you read them ``THANX MAUD'' backwards). Scrolls disappear after you read them
(except for blank ones, without magic spells on them). (except for blank ones, without magic spells on them).
One of the most useful of these is the scroll of identify,
which can be used to determine what another object is, whether it
is cursed or blessed, and how many uses it has left. Some ob-
jects of subtle enchantment are difficult to identify without
these.
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -1984,6 +1984,12 @@
One of the most useful of these is the scroll of identify,
which can be used to determine what another object is, whether it
is cursed or blessed, and how many uses it has left. Some ob-
jects of subtle enchantment are difficult to identify without
these.
A mail daemon may run up and deliver mail to you as a scroll A mail daemon may run up and deliver mail to you as a scroll
of mail (on versions compiled with this feature). To use this of mail (on versions compiled with this feature). To use this
feature on versions where NetHack mail delivery is triggered by feature on versions where NetHack mail delivery is triggered by
@@ -2031,13 +2037,7 @@
such an explosion starts out very small and increases each time such an explosion starts out very small and increases each time
the wand is recharged. the wand is recharged.
In a truly desperate situation, when your back is up against
the wall, you might decide to go for broke and break your wand.
This is not for the faint of heart. Doing so will almost cer-
tainly cause a catastrophic release of magical energies.
When you have fully identified a particular wand, inventory
display will include additional information in parentheses: the
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -2050,6 +2050,13 @@
In a truly desperate situation, when your back is up against
the wall, you might decide to go for broke and break your wand.
This is not for the faint of heart. Doing so will almost cer-
tainly cause a catastrophic release of magical energies.
When you have fully identified a particular wand, inventory
display will include additional information in parentheses: the
number of times it has been recharged followed by a colon and number of times it has been recharged followed by a colon and
then by its current number of charges. A current charge count of then by its current number of charges. A current charge count of
-1 is a special case indicating that the wand has been cancelled. -1 is a special case indicating that the wand has been cancelled.
@@ -2097,13 +2104,6 @@
Some spells are directional--you must give a direction in Some spells are directional--you must give a direction in
which to cast them. You can also cast them at yourself (just which to cast them. You can also cast them at yourself (just
give a `.' or `s' for the direction). Be warned, however, for give a `.' or `s' for the direction). Be warned, however, for
this is often unwise. Other spells are nondirectional--they
don't require a direction.
Just as weapons are divided into groups in which a character
can become proficient (to varying degrees), spells are similarly
grouped. Successfully casting a spell exercises its skill group;
using the `#enhance' command to advance a sufficiently exercised
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -2116,6 +2116,13 @@
this is often unwise. Other spells are nondirectional--they
don't require a direction.
Just as weapons are divided into groups in which a character
can become proficient (to varying degrees), spells are similarly
grouped. Successfully casting a spell exercises its skill group;
using the `#enhance' command to advance a sufficiently exercised
skill will affect all spells within the group. Advanced skill skill will affect all spells within the group. Advanced skill
may increase the potency of spells, reduce their risk of failure may increase the potency of spells, reduce their risk of failure
during casting attempts, and improve the accuracy of the estimate during casting attempts, and improve the accuracy of the estimate
@@ -2163,13 +2170,6 @@
Like rings, amulets have various magical properties, some benefi- Like rings, amulets have various magical properties, some benefi-
cial, some harmful, which are activated by putting them on. cial, some harmful, which are activated by putting them on.
Only one amulet may be worn at a time, around your neck.
The commands to use amulets are the same as for rings, `P'
(put on) and `R' (remove).
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -2182,6 +2182,11 @@
Only one amulet may be worn at a time, around your neck.
The commands to use amulets are the same as for rings, `P'
(put on) and `R' (remove).
7.12. Gems (`*') 7.12. Gems (`*')
Some gems are valuable, and can be sold for a lot of gold. Some gems are valuable, and can be sold for a lot of gold.
@@ -2231,11 +2236,6 @@
a physiological need for water; thus there is no restriction on a physiological need for water; thus there is no restriction on
drinking beverages, even if they provide some minor food bene- drinking beverages, even if they provide some minor food bene-
fits. Calling upon your god for help with starvation does not fits. Calling upon your god for help with starvation does not
violate any food challenges either.
A strict vegan diet is one which avoids any food derived
from animals. The primary source of nutrition is fruits and veg-
etables. The corpses and tins of blobs (`b'), jellies (`j'), and
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -2248,6 +2248,11 @@
violate any food challenges either.
A strict vegan diet is one which avoids any food derived
from animals. The primary source of nutrition is fruits and veg-
etables. The corpses and tins of blobs (`b'), jellies (`j'), and
fungi (`F') are also considered to be vegetable matter. Certain fungi (`F') are also considered to be vegetable matter. Certain
human food is prepared without animal products; namely, lembas human food is prepared without animal products; namely, lembas
wafers, cram rations, food rations (gunyoki), K-rations, and C- wafers, cram rations, food rations (gunyoki), K-rations, and C-
@@ -2298,11 +2303,6 @@
figure; a true atheist would hear the words but attach no special figure; a true atheist would hear the words but attach no special
meaning to them. meaning to them.
Most players fight with a wielded weapon (or tool intended
to be wielded as a weapon). Another challenge is to win the game
without using such a wielded weapon. You are still permitted to
throw, fire, and kick weapons; use a wand, spell, or other type
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -2314,6 +2314,10 @@
Most players fight with a wielded weapon (or tool intended
to be wielded as a weapon). Another challenge is to win the game
without using such a wielded weapon. You are still permitted to
throw, fire, and kick weapons; use a wand, spell, or other type
of item; or fight with your hands and feet. of item; or fight with your hands and feet.
In NetHack, a pacifist refuses to cause the death of any In NetHack, a pacifist refuses to cause the death of any
@@ -2366,10 +2370,6 @@
configuration for system administrators. configuration for system administrators.
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -3609,6 +3609,11 @@
file, and the last MENUCOLOR-line in your config file that file, and the last MENUCOLOR-line in your config file that
matches a menu line will be used for the line. matches a menu line will be used for the line.
Note that if you intend to have one or more color specifica-
tions match " uncursed ", you will probably want to turn the im-
plicit_uncursed option off so that all items known to be uncursed
are actually displayed with the ``uncursed'' description.
9.11. Configuring User Sounds 9.11. Configuring User Sounds
Some platforms allow you to define sound files to be played Some platforms allow you to define sound files to be played
@@ -3616,11 +3621,6 @@
to the message window. At this time the Qt port and the win32tty to the message window. At this time the Qt port and the win32tty
and win32gui ports support the use of user sounds. and win32gui ports support the use of user sounds.
The following config file entries are relevant to mapping
user sounds to messages:
SOUNDDIR
The directory that houses the sound files to be played.
@@ -3634,6 +3634,12 @@
The following config file entries are relevant to mapping
user sounds to messages:
SOUNDDIR
The directory that houses the sound files to be played.
SOUND SOUND
An entry that maps a sound file to a user-specified message An entry that maps a sound file to a user-specified message
pattern. Each SOUND entry is broken down into the following pattern. Each SOUND entry is broken down into the following
@@ -3683,12 +3689,6 @@
Allowed attributes are bold, inverse, normal. Note that the Allowed attributes are bold, inverse, normal. Note that the
platform used may interpret the attributes any way it wants. platform used may interpret the attributes any way it wants.
Behaviours can occur based on percentage thresholds, updown, or
absolute values. The in-game options menu can help you deter-
mine the correct syntax for a config file.
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -3700,6 +3700,10 @@
Behaviours can occur based on percentage thresholds, updown, or
absolute values. The in-game options menu can help you deter-
mine the correct syntax for a config file.
The whole feature can be disabled by setting option sta- The whole feature can be disabled by setting option sta-
tushilites off. tushilites off.
@@ -3749,10 +3753,6 @@
( S_boomright (boomerang open right) ( S_boomright (boomerang open right)
` S_boulder (boulder) ` S_boulder (boulder)
- S_brcorn (bottom right corner) - S_brcorn (bottom right corner)
C S_centaur (centaur)
_ S_chain (iron chain)
# S_cloud (cloud)
c S_cockatrice (cockatrice)
@@ -3766,6 +3766,10 @@
C S_centaur (centaur)
_ S_chain (iron chain)
# S_cloud (cloud)
c S_cockatrice (cockatrice)
$ S_coin (pile of coins) $ S_coin (pile of coins)
# S_corr (corridor) # S_corr (corridor)
- S_crwall (wall) - S_crwall (wall)
@@ -3815,10 +3819,6 @@
j S_jelly (jelly) j S_jelly (jelly)
k S_kobold (kobold) k S_kobold (kobold)
K S_kop (Keystone Kop) K S_kop (Keystone Kop)
^ S_land_mine (land mine)
} S_lava (molten lava)
l S_leprechaun (leprechaun)
^ S_level_teleporter (level teleporter)
@@ -3832,6 +3832,10 @@
^ S_land_mine (land mine)
} S_lava (molten lava)
l S_leprechaun (leprechaun)
^ S_level_teleporter (level teleporter)
L S_lich (lich) L S_lich (lich)
y S_light (light) y S_light (light)
# S_litcorr (lit corridor) # S_litcorr (lit corridor)
@@ -3881,10 +3885,6 @@
| S_sw_ml (swallow middle left) | S_sw_ml (swallow middle left)
| S_sw_mr (swallow middle right) | S_sw_mr (swallow middle right)
- S_sw_tc (swallow top center) - S_sw_tc (swallow top center)
/ S_sw_tl (swallow top left)
`\' S_sw_tr (swallow top right)
- S_tdwall (wall)
^ S_teleportation_trap (teleportation trap)
@@ -3898,6 +3898,10 @@
/ S_sw_tl (swallow top left)
`\' S_sw_tr (swallow top right)
- S_tdwall (wall)
^ S_teleportation_trap (teleportation trap)
S_throne (opulent throne) S_throne (opulent throne)
- S_tlcorn (top left corner) - S_tlcorn (top left corner)
| S_tlwall (wall) | S_tlwall (wall)
@@ -3947,11 +3951,7 @@
examine this Guidebook before playing so you have an idea what examine this Guidebook before playing so you have an idea what
the screen layout is like. You'll also need to be able to locate the screen layout is like. You'll also need to be able to locate
the PC cursor. It is always where your character is located. the PC cursor. It is always where your character is located.
Merely searching for an @-sign will not always find your charac- Merely searching for an @-sign will not always find your
ter since there are other humanoids represented by the same sign.
Your screen-reader should also have a function which gives you
the row and column of your review cursor and the PC cursor.
These co-ordinates are often useful in giving players a better
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -3964,6 +3964,10 @@
character since there are other humanoids represented by the same
sign. Your screen-reader should also have a function which gives
you the row and column of your review cursor and the PC cursor.
These co-ordinates are often useful in giving players a better
sense of the overall location of items on the screen. sense of the overall location of items on the screen.
While it is not difficult for experienced users to edit the While it is not difficult for experienced users to edit the
@@ -4014,10 +4018,6 @@
EXPLORERS A list of users who are allowed to use the explore EXPLORERS A list of users who are allowed to use the explore
mode. The syntax is the same as WIZARDS. mode. The syntax is the same as WIZARDS.
MAXPLAYERS Limit the maximum number of games that can be run-
ning at the same time.
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015
@@ -4030,6 +4030,9 @@
MAXPLAYERS Limit the maximum number of games that can be run-
ning at the same time.
SUPPORT A string explaining how to get local support (no de- SUPPORT A string explaining how to get local support (no de-
fault value). fault value).
@@ -4083,9 +4086,6 @@
NetHack 3.6 June 22, 2015 NetHack 3.6 June 22, 2015