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

Merge branch 'NetHack-3.7'

Browse Source
This commit is contained in:
nhmall
2019-12-27 08:52:42 -05:00
parent e3d8b93b10 6d8d3a9557
commit b241945672
98 changed files with 1137 additions and 843 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
doc/Guidebook.mn
View File

@@ -1,4 +1,4 @@
.\" $NHDT-Branch: NetHack-3.6 $:$NHDT-Revision: 1.337 $ $NHDT-Date: 1576431522 2019/12/15 17:38:42 $
.\" $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.345 $ $NHDT-Date: 1577050469 2019/12/22 21:34:29 $
.\"
.\" This is an excerpt from the 'roff' man page from the 'groff' package.
.\" NetHack's Guidebook.mn currently does *not* adhere to these guidelines.
@@ -3422,6 +3422,14 @@ something pushes the old item into your alternate weapon slot (default off).
Likewise for the \(oqa\(cq (apply) command if it causes the applied item to
become wielded.
Persistent.
.lp quick_farsight
When set, usually prevents the \(lqyou sense your surroundings\(rq message
where play pauses to allow you to browse the map whenever clairvoyance
randomly activates.
Some situations, such as being underwater or engulfed, ignore this option.
It does not affect the clairvoyance spell where pausing to examine revealed
objects or monsters is less intrusive.
Default is off. Persistent.
.lp "race "
Selects your race (for example, \(lqrace:human\(rq).
Default is random.

11
doc/Guidebook.tex
View File

@@ -3760,7 +3760,16 @@ Using the `w' (wield) command when already wielding
something pushes the old item into your alternate weapon slot (default off).
Likewise for the `a' (apply) command if it causes the applied item to
become wielded. Persistent.
%.Ip
%.lp
\item[\ib(quick\verb+_+farsight}
When set, usually prevents the ``you sense your surroundings'' message
where play pauses to allow you to browse the map whenever clairvoyance
randomly activates.
Some situations, such as being underwater or engulfed, ignore this option.
It does not affect the clairvoyance spell where pausing to examine revealed
objects or monsters is less intrusive.
Default is off. Persistent.
%.lp
\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

380
doc/Guidebook.txt
View File

@@ -3934,6 +3934,15 @@
off). Likewise for the `a' (apply) command if it causes the
applied item to become wielded. Persistent.
quick_farsight
When set, usually prevents the "you sense your surroundings"
message where play pauses to allow you to browse the map when-
ever clairvoyance randomly activates. Some situations, such as
being underwater or engulfed, ignore this option. It does not
affect the clairvoyance spell where pausing to examine revealed
objects or monsters is less intrusive. Default is off. Per-
sistent.
race
Selects your race (for example, "race:human"). Default is ran-
dom. If you prefix the value with `!' or "no", you will ex-
@@ -3944,15 +3953,6 @@
Make the space bar a synonym for the `.' (#wait) command (de-
fault off). Persistent.
role
Pick your type of character (for example "role:Samurai"); syn-
onym for "character". See "name" for an alternate method of
specifying your role. Normally only the first letter of the
value is examined; `r' is an exception with "Rogue", "Ranger",
and "random" values. If you prefix the value with `!' or "no",
you will exclude that role from being picked randomly. Cannot
be set with the `O' command. Persistent.
NetHack 3.7 December 18, 2019
@@ -3964,6 +3964,15 @@
role
Pick your type of character (for example "role:Samurai"); syn-
onym for "character". See "name" for an alternate method of
specifying your role. Normally only the first letter of the
value is examined; `r' is an exception with "Rogue", "Ranger",
and "random" values. If you prefix the value with `!' or "no",
you will exclude that role from being picked randomly. Cannot
be set with the `O' command. Persistent.
roguesymset
This option may be used to select one of the named symbol sets
found within "symbols" to alter the symbols displayed on the
@@ -4009,15 +4018,6 @@
Show your accumulated experience points on bottom line (default
off). Persistent.
showrace
Display yourself as the glyph for your race, rather than the
glyph for your role (default off). Note that this setting af-
fects only the appearance of the display, not the way the game
treats you. Persistent.
showscore
Show your approximate accumulated score on bottom line (default
off). Persistent.
NetHack 3.7 December 18, 2019
@@ -4030,6 +4030,16 @@
showrace
Display yourself as the glyph for your race, rather than the
glyph for your role (default off). Note that this setting af-
fects only the appearance of the display, not the way the game
treats you. Persistent.
showscore
Show your approximate accumulated score on bottom line (default
off). Persistent.
silent
Suppress terminal beeps (default on). Persistent.
@@ -4075,16 +4085,6 @@
screen. Use "symset:default" to explicitly select the default
symbols.
time
Show the elapsed game time in turns on bottom line (default
off). Persistent.
timed_delay
When pausing momentarily for display effect, such as with ex-
plosions and moving objects, use a timer rather than sending
extra characters to the screen. (Applies to "tty" interface
only; "X11" interface always uses a timer based delay. The
NetHack 3.7 December 18, 2019
@@ -4096,7 +4096,16 @@
default is on if configured into the program.) Persistent.
time
Show the elapsed game time in turns on bottom line (default
off). Persistent.
timed_delay
When pausing momentarily for display effect, such as with ex-
plosions and moving objects, use a timer rather than sending
extra characters to the screen. (Applies to "tty" interface
only; "X11" interface always uses a timer based delay. The de-
fault is on if configured into the program.) Persistent.
tombstone
Draw a tombstone graphic upon your death (default on). Persis-
@@ -4141,15 +4150,6 @@
through next and previous targets, allows filtering the possi-
ble targets.
n - no filtering [default]
v - in view only
a - in same area only
The area-filter tries to be slightly predictive -- if you're
standing on a doorway, it will consider the area on the side of
the door you were last moving towards.
NetHack 3.7 December 18, 2019
@@ -4162,6 +4162,14 @@
n - no filtering [default]
v - in view only
a - in same area only
The area-filter tries to be slightly predictive -- if you're
standing on a doorway, it will consider the area on the side of
the door you were last moving towards.
Filtering can also be changed when getting a location with the
"getpos.filter" key.
@@ -4208,14 +4216,6 @@
ing 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 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 with the `O'
command.
align_message
Where to align or place the message window (top, bottom, left,
or right)
NetHack 3.7 December 18, 2019
@@ -4228,6 +4228,14 @@
checking to see if it shows up in the Options list. Some options
are dynamic and can be specified during the game with the `O'
command.
align_message
Where to align or place the message window (top, bottom, left,
or right)
align_status
Where to align or place the status window (top, bottom, left,
or right).
@@ -4274,14 +4282,6 @@
font_size_message
If NetHack can, it should use this size font for the message
window.
font_size_status
If NetHack can, it should use this size font for the status
window.
font_size_text
If NetHack can, it should use this size font for text windows.
NetHack 3.7 December 18, 2019
@@ -4294,6 +4294,15 @@
window.
font_size_status
If NetHack can, it should use this size font for the status
window.
font_size_text
If NetHack can, it should use this size font for text windows.
fullscreen
If NetHack can, it should try and display on the entire screen
rather than in a window.
@@ -4338,16 +4347,7 @@
games for the player to choose from at game startup, if it can.
Not all ports support this option.
softkeyboard
Display an onscreen keyboard. Handhelds are most likely to
support this option.
splash_screen
If NetHack can, it should display an opening splash screen when
it starts up (default yes).
statuslines
Number of lines for traditional below-the-map status display.
NetHack 3.7 December 18, 2019
@@ -4360,6 +4360,16 @@
softkeyboard
Display an onscreen keyboard. Handhelds are most likely to
support this option.
splash_screen
If NetHack can, it should display an opening splash screen when
it starts up (default yes).
statuslines
Number of lines for traditional below-the-map status display.
Acceptable values are 2 and 3 (default is 2). Curses and tty
interfaces only.
@@ -4405,16 +4415,6 @@
1 - on, always show borders
2 - auto, on if display is at least (24+2)x(80+2) (default)
(The 26x82 size threshold for `2' refers to number of rows and
columns of the display. A width of at least 110 columns
(80+2+26+2) is needed for align_status set to left or right.)
windowcolors
If NetHack can, it should display windows with the specified
foreground/background colors. Windows GUI only. The format is
NetHack 3.7 December 18, 2019
@@ -4426,6 +4426,14 @@
(The 26x82 size threshold for `2' refers to number of rows and
columns of the display. A width of at least 110 columns
(80+2+26+2) is needed for align_status set to left or right.)
windowcolors
If NetHack can, it should display windows with the specified
foreground/background colors. Windows GUI only. The format is
OPTION=windowcolors:wintype foreground/background
where wintype is one of "menu", "message", "status", or
@@ -4472,14 +4480,6 @@
abort the count by typing ESC will leave NetHack waiting for
another character to complete the two character sequence. Type
a second ESC to finish cancelling such a count. At other
prompts a single ESC suffices.
BIOS
Use BIOS calls to update the screen display quickly and to read
the keyboard (allowing the use of arrow keys to move) on ma-
chines with an IBM PC compatible BIOS ROM (default off, OS/2,
PC, and ST NetHack only).
NetHack 3.7 December 18, 2019
@@ -4492,6 +4492,14 @@
prompts a single ESC suffices.
BIOS
Use BIOS calls to update the screen display quickly and to read
the keyboard (allowing the use of arrow keys to move) on ma-
chines with an IBM PC compatible BIOS ROM (default off, OS/2,
PC, and ST NetHack only).
flush
(default off, Amiga NetHack only).
@@ -4538,14 +4546,6 @@
not correct the problem, try !color. Cannot be set with the
`O' command.
9.7. Regular Expressions
Regular expressions are normally POSIX extended regular ex-
pressions. It is possible to compile NetHack without regular ex-
pression support on a platform where there is no regular expres-
sion library. While this is not true of any modern platform, if
your NetHack was built this way, patterns are instead glob pat-
terns. This applies to Autopickup exceptions, Message types, Menu
NetHack 3.7 December 18, 2019
@@ -4558,6 +4558,14 @@
9.7. Regular Expressions
Regular expressions are normally POSIX extended regular ex-
pressions. It is possible to compile NetHack without regular ex-
pression support on a platform where there is no regular expres-
sion library. While this is not true of any modern platform, if
your NetHack was built this way, patterns are instead glob pat-
terns. This applies to Autopickup exceptions, Message types, Menu
colors, and User sounds.
9.8. Configuring Autopickup Exceptions
@@ -4601,16 +4609,8 @@
any corpse from autopickup. The last example results in the ex-
clusion of items known to be cursed from autopickup.
9.9. Changing Key Bindings
It is possible to change the default key bindings of some
special commands, menu accelerator keys, and extended commands,
by using BIND stanzas in the configuration file. Format is key,
followed by the command to bind to, separated by a colon. The
key can be a single character ("x"), a control key ("^X", "C-x"),
a meta key ("M-x"), or a three-digit decimal ASCII code.
For example:
@@ -4624,6 +4624,17 @@
9.9. Changing Key Bindings
It is possible to change the default key bindings of some
special commands, menu accelerator keys, and extended commands,
by using BIND stanzas in the configuration file. Format is key,
followed by the command to bind to, separated by a colon. The
key can be a single character ("x"), a control key ("^X", "C-x"),
a meta key ("M-x"), or a three-digit decimal ASCII code.
For example:
BIND=^X:getpos.autodescribe
BIND={:menu_first_page
BIND=v:loot
@@ -4668,17 +4679,6 @@
When asked for a direction, the key to target yourself. De-
fault is `.'.
getdir.self2
When asked for a direction, the key to target yourself. De-
fault is `s'.
getpos.autodescribe
When asked for a location, the key to toggle autodescribe. De-
fault is `#'.
getpos.all.next
When asked for a location, the key to go to next closest
NetHack 3.7 December 18, 2019
@@ -4690,7 +4690,17 @@
interesting thing. Default is `a'.
getdir.self2
When asked for a direction, the key to target yourself. De-
fault is `s'.
getpos.autodescribe
When asked for a location, the key to toggle autodescribe. De-
fault is `#'.
getpos.all.next
When asked for a location, the key to go to next closest inter-
esting thing. Default is `a'.
getpos.all.prev
When asked for a location, the key to go to previous closest
@@ -4734,16 +4744,6 @@
or meta-digit keys to fast-move around, move by skipping the
same glyphs instead of by 8 units. Default is `*'.
getpos.filter
When asked for a location, change the filtering mode when using
one of the next or previous keys to cycle through targets.
Toggles between no filtering, in view only, and in the same
area only. Default is `"'.
getpos.pick
When asked for a location, the key to choose the location, and
possibly ask for more info. Default is `.'.
NetHack 3.7 December 18, 2019
@@ -4756,6 +4756,16 @@
getpos.filter
When asked for a location, change the filtering mode when using
one of the next or previous keys to cycle through targets.
Toggles between no filtering, in view only, and in the same
area only. Default is `"'.
getpos.pick
When asked for a location, the key to choose the location, and
possibly ask for more info. Default is `.'.
getpos.pick.once
When asked for a location, the key to choose the location, and
skip asking for more info. Default is `,'.
@@ -4799,16 +4809,6 @@
redraw
Key to redraw the screen. Default is `^R'.
redraw.numpad
Key to redraw the screen. With number_pad only. Default is
`^L'.
repeat
Key to repeat previous command. Default is `^A'.
reqmenu
Prefix key to request menu from some commands. Default is `m'.
@@ -4822,6 +4822,16 @@
redraw.numpad
Key to redraw the screen. With number_pad only. Default is
`^L'.
repeat
Key to repeat previous command. Default is `^A'.
reqmenu
Prefix key to request menu from some commands. Default is `m'.
run
Prefix key to run towards a direction. Default is `G'.
@@ -4867,16 +4877,6 @@
the user is prompted with more-prompt, and a message matching
"You displaced <something>." is not shown at all.
The order of the defined MSGTYPE lines is important; the last
matching rule is used. Put the general case first, exceptions
below them.
9.11. Configuring Menu Colors
Some platforms allow you to define colors used in menu lines
when the line matches a user-defined pattern. At this time the
tty, curses, win32tty and win32gui interfaces support this.
NetHack 3.7 December 18, 2019
@@ -4888,6 +4888,16 @@
The order of the defined MSGTYPE lines is important; the last
matching rule is used. Put the general case first, exceptions
below them.
9.11. Configuring Menu Colors
Some platforms allow you to define colors used in menu lines
when the line matches a user-defined pattern. At this time the
tty, curses, win32tty and win32gui interfaces support this.
In general, the configuration file entries to describe the
menu color mappings look like this:
@@ -4932,16 +4942,6 @@
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.12. Configuring User Sounds
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.
NetHack 3.7 December 18, 2019
@@ -4954,6 +4954,15 @@
are actually displayed with the "uncursed" description.
9.12. Configuring User Sounds
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.
The following configuration file entries are relevant to
mapping user sounds to messages:
@@ -4999,15 +5008,6 @@
OPTION=hilite_status:wisdom/down/red/up/green
Allowed colors are black, red, green, brown, blue, magenta,
cyan, gray, orange, light-green, yellow, light-blue, light-magen-
ta, light-cyan, and white. And "no-color", the default fore-
ground color on the display, which is not necessarily the same as
black or white or any of the other colors.
Allowed attributes are none, bold, dim, underline, blink,
and inverse. "Normal" is a synonym for "none"; they should not
be used in combination with any of the other attributes.
NetHack 3.7 December 18, 2019
@@ -5020,6 +5020,16 @@
Allowed colors are black, red, green, brown, blue, magenta,
cyan, gray, orange, light-green, yellow, light-blue, light-magen-
ta, light-cyan, and white. And "no-color", the default fore-
ground color on the display, which is not necessarily the same as
black or white or any of the other colors.
Allowed attributes are none, bold, dim, underline, blink,
and inverse. "Normal" is a synonym for "none"; they should not
be used in combination with any of the other attributes.
To specify both a color and an attribute, use `&' to combine
them. To specify multiple attributes, use `+' to combine those.
For example: "magenta&inverse+dim".
@@ -5064,16 +5074,6 @@
* "always" will set the default attributes for that field.
* "up", "down" set the field attributes for when the field
value changes upwards or downwards. This attribute times
out after statushilites turns.
* "changed" sets the field attribute for when the field val-
ue changes. This attribute times out after statushilites
turns. (If a field has both a "changed" rule and an "up"
or "down" rule which matches a change in the field's val-
ue, the "up" or "down" one takes precedence.)
NetHack 3.7 December 18, 2019
@@ -5086,6 +5086,16 @@
* "up", "down" set the field attributes for when the field
value changes upwards or downwards. This attribute times
out after statushilites turns.
* "changed" sets the field attribute for when the field val-
ue changes. This attribute times out after statushilites
turns. (If a field has both a "changed" rule and an "up"
or "down" rule which matches a change in the field's val-
ue, the "up" or "down" one takes precedence.)
* percentage sets the field attribute when the field value
matches the percentage. It is specified as a number be-
tween 0 and 100, followed by `%' (percent sign). If the
@@ -5129,16 +5139,6 @@
The whole feature can be disabled by setting option sta-
tushilites to 0.
Example hilites:
@@ -5152,6 +5152,8 @@
Example hilites:
OPTION=hilite_status: gold/up/yellow/down/brown
OPTION=hilite_status: characteristics/up/green/down/red
OPTION=hilite_status: hitpoints/100%/gray&normal
@@ -5203,8 +5205,6 @@
B S_bat (bat or bird)
^ S_bear_trap (bear trap)
- S_blcorn (bottom left corner)
b S_blob (blob)
+ S_book (spellbook)
@@ -5218,6 +5218,8 @@
b S_blob (blob)
+ S_book (spellbook)
) S_boomleft (boomerang open left)
( S_boomright (boomerang open right)
` S_boulder (boulder)
@@ -5269,8 +5271,6 @@
. S_hodbridge (horizontal lowered drawbridge)
| S_hodoor (open door in horizontal wall)
^ S_hole (hole)
@ S_human (human or elf)
h S_humanoid (humanoid)
@@ -5284,6 +5284,8 @@
@ S_human (human or elf)
h S_humanoid (humanoid)
- S_hwall (horizontal wall)
. S_ice (ice)
i S_imp (imp or minor demon)
@@ -5335,8 +5337,6 @@
s S_spider (arachnid or centipede)
^ S_spiked_pit (spiked pit)
^ S_squeaky_board (squeaky board)
0 S_ss1 (magic shield 1 of 4)
# S_ss2 (magic shield 2 of 4)
@@ -5350,6 +5350,8 @@
0 S_ss1 (magic shield 1 of 4)
# S_ss2 (magic shield 2 of 4)
@ S_ss3 (magic shield 3 of 4)
* S_ss4 (magic shield 4 of 4)
^ S_statue_trap (statue trap)
@@ -5401,8 +5403,6 @@
x S_xan (xan or other extraordinary insect)
X S_xorn (xorn)
Y S_yeti (apelike creature)
Z S_zombie (zombie)
z S_zruty (zruty)
@@ -5416,6 +5416,8 @@
Z S_zombie (zombie)
z S_zruty (zruty)
S_pet_override (any pet if ACCESSIBILITY=1 is set)
S_hero_override (hero if ACCESSIBILITY=1 is set)
@@ -5468,8 +5470,6 @@
ficial distributions of NetHack is a symset called NHAccess. Se-
lecting 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 SYMBOLS= and ROGUESYMBOLS= in your
NetHack 3.7 December 18, 2019
@@ -5482,6 +5482,8 @@
gained some experience with the game and with editing files, you
may want to alter settings via SYMBOLS= and ROGUESYMBOLS= in your
configuration file to better suit your preferences. See the pre-
vious section for the special symbols S_pet_override to force a
consistent symbol for all pets and S_hero_override to force a
@@ -5536,8 +5538,6 @@
formation can be seen via the "#attributes" command.
NetHack 3.7 December 18, 2019

31
doc/fixes37.0
View File

@@ -1,8 +1,7 @@
$NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.22 $ $NHDT-Date: 1576288434 2019/12/14 01:53:54 $
$NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.35 $ $NHDT-Date: 1577190687 2019/12/24 12:31:27 $
General Fixes and Modified Features
-----------------------------------
fix compile when DLB isn't defined
hero polymorphed into a vampire can use #monster to shape-shift rather than
just do a one-shot polymorph into bat/cloud/wolf and shifted vampire
hero can use #monster again to take on another form (randomly chosen
@@ -12,10 +11,28 @@ fix internal self-recover to work with recent fields added to checkpoint file
improvements to pronoun usage when hallucinating
function calls made from mapglyph based on dungeon level are now called once
per level
fix accessing mons[-1] when trying to gate in a non-valid demon
fast hero could have random clairvoyance happen more than once on same turn
using 'Q' on wielded weapon would offer to split stack; make using 'w' on a
quivered stack behave similarly
weight for giant spider was too low for creature of size 'large';
weight for giant beetle was much too low for 'large'
leave some menu items out of "invert all" via '@' when their inclusion would
degrade the usefulness of that interface feature
change crysknife from mineral to bone and worm tooth from unspecified to bone
worn meat ring shouldn't cause increased hunger; neither should fake Amulet
worn +0 ring of protection should cause increased hunger if it is the only
source of extrinsic Protection
Fixes to Pre-3.7.0 Problems that Were Exposed Via git Repository
Fixes to 3.7.0-x Problems that Were Exposed Via git Repository
------------------------------------------------------------------
fix compile when DLB isn't defined
urealtime.realtime was being incorrectly calculated
revised "mysterious force" when climbing out of gehennom could generate
warnings about "rn2(0) attempted" or "rn2(-n) attempted"
after 'w' on split stack patch, wielding '-' would cause an object_lost panic
same patch allowed partial stack from getobj to replace cursed wielded weapon
Platform- and/or Interface-Specific Fixes
@@ -40,6 +57,9 @@ split off some of the functionality that was in makedefs (compiled-in options
replace quest.txt and associated conversion to quest.dat via makedefs with
lua quest texts loaded at runtime
some altars are displayed in different colors (for tty and curses at least)
add 'quick_farsight' option to provide some control over random clairvoyance
where pausing to be able to browse temporarily visible aspects of the
revealed map can seem intrusive; doesn't affect clairvoyance spell
Platform- and/or Interface-Specific New Features
@@ -57,7 +77,8 @@ Code Cleanup and Reorganization
move majority of global variables into instance_globals struct g
move zeroobj, zeromonst, zeroany into const_globals struct cg
remove STATIC_DCL, STATIC_OVL, STATIC_VAR, STATIC_PTR
old Qt moved from win/Qt to win/Qt3
old Qt moved from win/Qt to win/Qt3 and files renamed to use qt3_ prefix
more current Qt for Qt version 4 and 5 moved from win/Qt4 to win/Qt; qt4
moniker changed to qt_
window-port-interface: add_menu() modified to take a more general itemflags
parameter to support uses beyond just 'preselected'

5
doc/window.doc
View File

@@ -310,7 +310,7 @@ start_menu(window)
be used for menus.
add_menu(windid window, int glyph, const anything identifier,
char accelerator, char groupacc,
int attr, char *str, boolean preselected)
int attr, char *str, unsigned itemflags)
-- Add a text line str to the given menu window. If identifier
is 0, then the line cannot be selected (e.g. a title).
Otherwise, identifier is the value returned if the line is
@@ -337,8 +337,7 @@ add_menu(windid window, int glyph, const anything identifier,
the menu command (or their user defined aliases), it loses.
The menu commands and aliases take care not to interfere
with the default object class symbols.
-- If you want this choice to be preselected when the
menu is displayed, set preselected to TRUE.
-- itemflags on this item (such as MENU_ITEMFLAGS_SELECTED etc.).
end_menu(window, prompt)
-- Stop adding entries to the menu and flushes the window