Source:NetHack 5.0.0/dat/optmenu

From NetHackWiki
Jump to navigation Jump to search

Below is the full text to optmenu from the source code of NetHack 5.0.0. To link to a particular line, write [[Source:NetHack 5.0.0/dat/optmenu#line12]], for example.

The NetHack General Public License applies to screenshots, source code and other content from NetHack.

This content was modified from the original NetHack source code distribution (by splitting up NetHack content between wiki pages, and possibly further editing). See the page history for a list of who changed it, and on what dates.

1.  How dynamically setting options works:
2. 
3.  The simple options menu shows a relatively small subset of options
4.  and operates on each choice you make immediately, then is put back
5.  up to allow further changes.
6. 
7.  The full options menu shows the current value for all options and
8.  lets you pick ones that you'd like to change.  Picking them doesn't
9.  make any changes though.  That will take place once you close the
10.  menu.  For most of NetHack's interfaces, closing the menu is done
11.  by pressing the <enter> key or <return> key; others might require
12.  clicking on [ok].  Pressing the <escape> key or clicking on [cancel]
13.  will close the menu and discard any pending changes.
14. 
15.  The options menu is too long to fit on one screen.  Some interfaces
16.  paginate menus; use the '>' key to advance a page or '<' to back
17.  up.  They typically re-use selection letters (a-z) on each page.
18.  Others use one long page and you need to use a scrollbar; once past
19.  a-z and A-Z they'll have entries without selection letters.  Those
20.  can be selected by clicking on them.
21. 
22.  For toggling boolean (True/False or On/Off) options, selecting them
23.  is all that is needed.  For compound options (which take a number,
24.  a choice of several particular values, or something more complex,
25.  and are listed in a second section after the boolean ones), you will
26.  be prompted to supply a new value.
27. 
28.  At the start of each of the two sections are the values of some
29.  unselectable options which can only be set before the game starts.
30.  After the compound section are some "other" options which take a set
31.  of multiple values and tend to be more complicated to deal with.
32. 
33.  Some changes will only last until you save (or quit) the current
34.  game.  Usually those are for things that might not be appropriate
35.  if you were to restore the saved game on another computer with
36.  different capabilities.  Other options will be included in this
37.  game's save file and retain their settings after restore.  None set
38.  in the options menu will affect other games, either already saved or
39.  new ones.  For that, you need to update your run-time configuration
40.  file and specify the desired options settings there.  Even then,
41.  restoring existing games that contain saved option values will use
42.  those saved ones.
43.