document curses options

Add curses options to the Guidebook.

The TeX one hasn't been tested (particularly "term_cols and\nterm_rows")
and windowborders #3).

diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn
index 1005bee2d904f6764249c9671a42a0c2b457d9bb..8f0fb925fb19cf31460bf40f5a0eb42805e09224 100644 (file)
--- a/doc/Guidebook.mn
+++ b/doc/Guidebook.mn
@@ -1,4 +1,4 @@
-.\" $NHDT-Branch: NetHack-3.6.2-beta01 $:$NHDT-Revision: 1.297 $ $NHDT-Date: 1550883608 2019/02/23 01:00:08 $
+.\" $NHDT-Branch: NetHack-3.6.2-beta01 $:$NHDT-Revision: 1.298 $ $NHDT-Date: 1551312285 2019/02/28 00:04:45 $
 .\"
 .\" This is an excerpt from the 'roff' man page from the 'groff' package.
 .\" NetHack's Guidebook.mn currently does *not* adhere to these guidelines.
@@ -24,7 +24,7 @@
 .ds vr "NetHack 3.6
 .ds f0 "\*(vr
 .ds f1
-.ds f2 "February 10, 2019
+.ds f2 "February 27, 2019
 .
 .\" A note on some special characters:
 .\" \(lq = left double quote
@@ -3010,6 +3010,10 @@ Gold is never blessed or cursed, but it is not described as \(lquncursed\(rq
 even when the
 .op implicit_uncursed
 option is \(lqoff\(rq.
+.lp guicolor
+Use color text and/or highlighting attributes when displaying some
+non-map data (such as menu selector letters).
+Curses interface only; default is on.
 .lp "help    "
 If more information is available for an object looked at
 with the \(oq/\(cq command, ask if you want to see it (default on).
@@ -3026,6 +3030,12 @@ Visually distinguish pets from similar animals (default off).
 The behavior of this option depends on the type of windowing you use.
 In text windowing, text highlighting or inverse video is often used;
 with tiles, generally displays a heart symbol near pets.
+.lp ""
+With the curses interface, the
+.op petattr
+option controls how to highlight pets and setting it will turn the
+.op hilite_pet
+option on or off as warranted.
 .lp hilite_pile
 Visually distinguish piles of objects from individual objects (default off).
 The behavior of this option depends on the type of windowing you use.
@@ -3272,6 +3282,35 @@ such as \(lqparanoid_confirmation:attack pray Remove\(rq.
 .lp perm_invent
 If true, always display your current inventory in a window.  This only
 makes sense for windowing system interfaces that implement this feature.
+.lp petattr
+Specifies one or more text highlighting attributes to use when showing
+pets on the map.
+Effectively a superset of the
+.op hilite_pet
+boolean option.
+Curses interface only; value is one or more of the following letters.
+.sd
+.si
+.CC N "Normal text (no highlighting)"
+.CC I "Inverse video (default)"
+.CC B "Bold text"
+.CC U "Underlined text"
+.CC K "blinKing text"
+.CC D "Dim text"
+.CC T "iTalic text"
+.CC L "Left line indicator"
+.CC R "Right line indicator"
+.ei
+.ed
+Some of those choices might not work, particularly the final three,
+depending upon terminal hardware or terminal emulation software.
+.lp ""
+Currently multiple highlight-style letters can be combined by simply
+stringing them together (for example, \(lqBK\(rq), but in the future
+they might require being separated by plus signs (such as \(lqB+K\(rq,
+which works already).
+When using the \(oqN\(cq choice, it should be specified on its own,
+not in combination with any of the other letters.
 .lp pettype
 Specify the type of your initial pet, if you are playing a character class
 that uses multiple types of pets; or choose to have no initial pet at all.
@@ -3435,6 +3474,13 @@ and prior versions (for example \(lqsuppress_alert:3.3.1\(rq).
 This option may be used to select one of the named symbol sets found within
 \(lqsymbols\(rq to alter the symbols displayed on the screen.
 Use \(lqsymset:default\(rq to explicitly select the default symbols.
+.lp "term_cols\ \ \fIand\fP"
+.lp term_rows
+Curses interface only.
+Number of columns and rows to use for the display.
+Curses will attempt to resize to the values specified but will settle
+for smaller sizes if they are too big.
+Default is the current window size.
 .lp "time    "
 Show the elapsed game time in turns on bottom line (default off).
 Persistent.
@@ -3479,7 +3525,6 @@ The possible settings are:
 .CC n "none (no coordinates shown) [default]."
 .ei
 .ed
-.lp ""
 The
 .op whatis_coord
 option is also used with the \(lq/m\(rq, \(lq/M\(rq, \(lq/o\(rq,
@@ -3488,7 +3533,6 @@ where the \(lqnone\(rq setting is overridden with \(lqmap\(rq.
 .lp whatis_filter
 When getting a location on the map, and using the keys to cycle through
 next and previous targets, allows filtering the possible targets.
-.lp ""
 .sd
 .si
 .CC n "no filtering [default]"
@@ -3496,7 +3540,6 @@ next and previous targets, allows filtering the possible targets.
 .CC a "in same area only"
 .ei
 .ed
-.lp ""
 The area-filter tries to be slightly predictive \(em if you're standing
 on a doorway,
 it will consider the area on the side of the door you were last moving towards.
@@ -3512,6 +3555,21 @@ When getting a location on the map, and using shifted movement keys or
 meta-digit keys to fast-move, instead of moving 8 units at a time,
 move by skipping the same glyphs.
 (default off)
+.lp windowborders
+Whether to draw boxes around the map, status area, message area, and
+persistent inventory window if enabled.
+Curses interface only.
+Acceptable values are
+.sd
+.si
+.CC 1 "on, always show borders"
+.CC 2 "off, never show borders"
+.CC 3 "auto, on if terminal or window is at least (24+2)x(80+2)\ \ (default)"
+.ei
+.ed
+.lp ""
+(The 26x82 size threshold for \(oq3\(cq refers to number of rows and
+columns of the display.)
 .lp windowtype
 When the program has been built to support multiple interfaces,
 select which one to use, such as \(lqtty\(rq or \(lqX11\(rq

diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex
index ea42dbc0c23ae89a7dc66b569d3dfb24bc9c68ba..743a53e217234fc729471366aedee3dcd01a15b7 100644 (file)
--- a/doc/Guidebook.tex
+++ b/doc/Guidebook.tex
@@ -45,7 +45,7 @@
 %.au
 \author{Original version - Eric S. Raymond\\
 (Edited and expanded for 3.6 by Mike Stephenson and others)}
-\date{February 10, 2019}
+\date{February 27, 2019}
 
 \maketitle
 
@@ -3305,6 +3305,11 @@ or {\tt U} (known to be uncursed, when `off', the default).
 Gold is never blessed or cursed, but it is not described as ``uncursed''
 even when the {\it implicit\verb+_+uncursed\/} option is `off'.
 %.lp
+\item[\ib{guicolor}]
+Use color text and/or highlighting attributes when displaying some
+non-map data (such as menu selector letters).
+Curses interface only; default is on.
+%.lp
 \item[\ib{help}]
 If more information is available for an object looked at
 with the `{\tt /}' command, ask if you want to see it (default on).
@@ -3322,6 +3327,10 @@ Visually distinguish pets from similar animals (default off).
 The behavior of this option depends on the type of windowing you use.
 In text windowing, text highlighting or inverse video is often used;
 with tiles, generally displays a heart symbol near pets.
+%.lp ""
+With the curses interface, the {\it petattr\/}
+option controls how to highlight pets and setting it will turn the
+{\it hilite\verb+_+pet\/} option on or off as warranted.
 %.lp
 \item[\ib{hilite\verb+_+pile}]
 Visually distinguish piles of objects from individual objects (default off).
@@ -3576,6 +3585,38 @@ such as ``{\it par\-a\-noid\verb+_+con\-fir\-ma\-tion:attack~pray~Remove}''.
 \item[\ib{perm\verb+_+invent}]
 If true, always display your current inventory in a window.  This only
 makes sense for windowing system interfaces that implement this feature.
+%.lp
+\item[\ib{petattr}]
+Specifies one or more text highlighting attributes to use when showing
+pets on the map.
+Effectively a superset of the {\it hilite\verb+_+pet\/} boolean option.
+Curses interface only; value is one or more of the following letters.
+
+%.sd
+%.si
+{\tt N} --- Normal text (no highlighting)\\
+{\tt I} --- Inverse video (default)\\
+{\tt B} --- Bold text\\
+{\tt U} --- Underlined text\\
+{\tt K} --- blinKing text\\
+{\tt D} --- Dim text\\
+{\tt T} --- iTalic text\\
+{\tt L} --- Left line indicator\\
+{\tt R} --- Right line indicator\\
+%.ei
+%.ed
+
+Some of those choices might not work, particularly the final three,
+depending upon terminal hardware or terminal emulation software.
+
+%.lp ""
+Currently multiple highlight-style letters can be combined by simply
+stringing them together (for example, ``BK''), but in the future
+they might require being separated by plus signs (such as ``B\verb&+&K'',
+which works already).
+When using the `N' choice, it should be specified on its own,
+not in combination with any of the other letters.
+
 %.lp
 \item[\ib{pettype}]
 Specify the type of your initial pet, if you are playing a character class
@@ -3754,6 +3795,15 @@ This option may be used to select one of the named symbol sets found within
 {\tt symbols} to alter the symbols displayed on the screen.
 Use ``{\tt symset:default}'' to explicitly select the default symbols.
 %.lp
+\item[\ib{term\verb+_+cols}\ \ {\it and}]"
+%.lp
+\item[\ib{term\verb+_+rows}]
+Curses interface only.
+Number of columns and rows to use for the display.
+Curses will attempt to resize to the values specified but will settle
+for smaller sizes if they are too big.
+Default is the current window size.
+%.lp
 \item[\ib{time}]
 Show the elapsed game time in turns on bottom line (default off).  Persistent.
 %.lp
@@ -3845,6 +3895,25 @@ meta-digit keys to fast-move, instead of moving 8 units at a time,
 move by skipping the same glyphs.
 (default off)
 %.lp
+\item[\ib{windowborders}]
+Whether to draw boxes around the map, status area, message area, and
+persistent inventory window if enabled.
+Curses interface only.
+Acceptable values are
+
+%.sd
+%.si
+{\tt 1} --- on, always show borders\\
+{\tt 2} --- off, never show borders\\
+{\tt 3} --- auto, on if terminal or window is at least
+(24\verb&+&2)x(80\verb&+&2)\ \ (default)\\
+%.ei
+%.ed
+
+%.lp ""
+(The 26x82 size threshold for `3' refers to number of rows and
+columns of the display.)
+%.lp
 \item[\ib{windowtype}]
 When the program has been built to support multiple interfaces,
 select whichone to use, such as ``{\tt tty}'' or ``{\tt X11}''