more 'roff Guidebook tweaks
Fix the alignment of three short tables which use 'key dash meaning' so that the dashes line up using Keni's .PS/.PL/.PE macros. (There might be others that need this.) Center the "- - - -" separator which precedes the list of dungeoneers at the end. (Thinking about it now, possibly it should be forced to have zero paragraph indentation prior to centering rather than tacking on some trailing spaces to shift the non-blank part to the left. The title for the table of display symbols might be in the same boat here. But I'm roff'd out for the time being.) Try to explain object filtering for commands that can take multiple object classes combined with multiple BUCX states (and/or 'unpaid'). At the moment it is attached to the 'D' command where it is most likely to be used, but probably ought to have its own subsection in the Objects chapter so that it doesn't bog down the command list. The filtering paragraph ought to be duplicated in Guidebook.tex, but there's enough quoting going on that I didn't trust myself to attempt an untested change.
This commit is contained in:
PatR
121
doc/Guidebook.mn
121
doc/Guidebook.mn
@@ -1,6 +1,6 @@
|
||||
.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.253 $ $NHDT-Date: 1523842417 2018/04/16 01:33:37 $
|
||||
.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.254 $ $NHDT-Date: 1523867058 2018/04/16 08:24:18 $
|
||||
.\"
|
||||
.\" This is an excerpt for the 'roff' man page from the 'groff' package.
|
||||
.\" This is an excerpt from the 'roff' man page from the 'groff' package.
|
||||
.\" NetHack's Guidebook.mn currently does *not* adhere to these guidelines.
|
||||
.\"|||
|
||||
.\"| o Never include empty or blank lines in a roff document. Instead, use
|
||||
@@ -22,6 +22,7 @@
|
||||
.ds f0 "\*(vr
|
||||
.ds f1
|
||||
.ds f2 "April 14, 2018
|
||||
.
|
||||
.\" labeled paragraph start (should be part of tmac.n, but I don't want to
|
||||
.\" make changes to that file)
|
||||
.\" .PS word
|
||||
@@ -676,19 +677,41 @@ In answer to the question
|
||||
you should type zero or more object symbols possibly followed by
|
||||
`a' and/or `i' and/or `u' and/or `m'. In addition, one or more of
|
||||
the blessed/uncursed/cursed groups may be typed.
|
||||
.sd
|
||||
.si
|
||||
DB - drop all objects known to be blessed.
|
||||
DU - drop all objects known to be uncursed.
|
||||
DC - drop all objects known to be cursed.
|
||||
DX - drop all objects of unknown B/U/C status.
|
||||
Da - drop all objects, without asking for confirmation.
|
||||
Di - examine your inventory before dropping anything.
|
||||
Du - drop only unpaid objects (when in a shop).
|
||||
Dm - use a menu to pick which object(s) to drop.
|
||||
D%u - drop only unpaid food.
|
||||
.ei
|
||||
.ed
|
||||
.PS D%u
|
||||
.PL DB
|
||||
drop all objects known to be blessed.
|
||||
.PL DU
|
||||
drop all objects known to be uncursed.
|
||||
.PL DC
|
||||
drop all objects known to be cursed.
|
||||
.PL DX
|
||||
drop all objects of unknown B/U/C status.
|
||||
.PL Da
|
||||
drop all objects, without asking for confirmation.
|
||||
.PL Di
|
||||
examine your inventory before dropping anything.
|
||||
.PL Du
|
||||
drop only unpaid objects (when in a shop).
|
||||
.PL Dm
|
||||
use a menu to pick which object(s) to drop.
|
||||
.PL D%u
|
||||
drop only unpaid food.
|
||||
.PE
|
||||
The last example shows a combination.
|
||||
There are three categories of object filtering: class (`!' for
|
||||
potions, `?' for scrolls, and so on), shop status (`u' for unpaid, in
|
||||
other words, owned by the shop), and bless/curse state (`B', `U',
|
||||
`C', and `X' as shown above).
|
||||
If you specify more than one value in a category (such as `!?' for
|
||||
potions and scrolls or `BU' for blessed and uncursed), an inventory
|
||||
object will meet the criteria if it matches any of the specified
|
||||
values (so `!?' means `!' or '?').
|
||||
If you specify more than one category, an inventory object must meet
|
||||
each of the category criteria (so `%u' means class `%' and unpaid `u').
|
||||
Lastly, you may specify multiple values within multiple categories:
|
||||
`!?BU' will select all potions and scrolls which are known to be
|
||||
blessed or uncursed.
|
||||
(In versions prior to 3.6, filter combinations behaved differently.)
|
||||
.lp ^D
|
||||
Kick something (usually a door).
|
||||
.lp e
|
||||
@@ -724,18 +747,24 @@ List your inventory (everything you're carrying).
|
||||
.lp I
|
||||
List selected parts of your inventory, usually be specifying the character
|
||||
for a particular set of objects, like `[' for armor or `!' for potions.
|
||||
.sd
|
||||
.si
|
||||
I* - list all gems in inventory;
|
||||
Iu - list all unpaid items;
|
||||
Ix - list all used up items that are on your shopping bill;
|
||||
IB - list all items known to be blessed;
|
||||
IU - list all items known to be uncursed;
|
||||
IC - list all items known to be cursed;
|
||||
IX - list all items whose bless/curse status is known;
|
||||
I$ - count your money.
|
||||
.ei
|
||||
.ed
|
||||
.PS IX
|
||||
.PL I*
|
||||
list all gems in inventory;
|
||||
.PL Iu
|
||||
list all unpaid items;
|
||||
.PL Ix
|
||||
list all used up items that are on your shopping bill;
|
||||
.PL IB
|
||||
list all items known to be blessed;
|
||||
.PL IU
|
||||
list all items known to be uncursed;
|
||||
.PL IC
|
||||
list all items known to be cursed;
|
||||
.PL IX
|
||||
list all items whose bless/curse status is known;
|
||||
.PL I$
|
||||
count your money.
|
||||
.PE
|
||||
.lp o
|
||||
Open a door.
|
||||
.lp O
|
||||
@@ -3988,19 +4017,27 @@ random statue names (default is 10).
|
||||
DUMPLOGFILE\ =\ A filename where the end-of-game dumplog is saved.
|
||||
Not defining this will prevent dumplog from being created. Only available
|
||||
if your game is compiled with DUMPLOG. Allows the following placeholders:
|
||||
.sd
|
||||
.si
|
||||
%% - literal '%'
|
||||
%v - version (eg. "3.6.1-0")
|
||||
%u - game UID
|
||||
%t - game start time, UNIX timestamp format
|
||||
%T - current time, UNIX timestamp format
|
||||
%d - game start time, YYYYMMDDhhmmss format
|
||||
%D - current time, YYYYMMDDhhmmss format
|
||||
%n - player name
|
||||
%N - first character of player name
|
||||
.ei
|
||||
.ed
|
||||
.\" note: %M is not an entry in the table, but 'M' is the widest letter
|
||||
.PS %M
|
||||
.PL %%
|
||||
literal '%'
|
||||
.PL %v
|
||||
version (eg. "3.6.1-0")
|
||||
.PL %u
|
||||
game UID
|
||||
.PL %t
|
||||
game start time, UNIX timestamp format
|
||||
.PL %T
|
||||
current time, UNIX timestamp format
|
||||
.PL %d
|
||||
game start time, YYYYMMDDhhmmss format
|
||||
.PL %D
|
||||
current time, YYYYMMDDhhmmss format
|
||||
.PL %n
|
||||
player name
|
||||
.PL %N
|
||||
first character of player name
|
||||
.PE
|
||||
.
|
||||
.hn 1
|
||||
Scoring
|
||||
@@ -4331,7 +4368,9 @@ 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.
|
||||
.pg
|
||||
\ - - - - - - - - - -
|
||||
.ce
|
||||
- - - - - - - - - -\ \ \ \ \" when centered, the dashes look a little too far
|
||||
. \" to the right, so pad them with a few spaces
|
||||
.pg
|
||||
From time to time, some depraved individual out there in netland sends a
|
||||
particularly intriguing modification to help out with the game. The Gods of
|
||||
|
||||
Reference in New Issue
Block a user