=== Option Descriptions ===

Options are accessible through the '=' command, which provides an 
interface to the various sets of options available to the player.

In the decriptions below, each option is listed as the textual summary
which is shown on the "options" screen, plus the internal name of the
option in brackets, followed by a textual description of the option.

Note that the internal name of the option can be used in user pref files 
to force the option to a given setting, see "customize.txt" for more 
info.

Various concepts are mentioned in the descriptions below, including 
"disturb", (cancel any running, resting, or repeated commands, which are 
in progress), "flush" (forget any keypresses waiting in the keypress 
queue), "fresh" (dump any pending output to the screen), and "sub-windows" 
(see below).


=== Interface options ===

***** <use_sound>
Use sound    [use_sound]
    Turns on sound effects, if your system supports them.

***** <rogue_like_commands>
Rogue-like commands    [rogue_like_commands]
    Selects the "roguelike" command set (see "command.txt" for info).

***** <use_old_target>
Use old target by default    [use_old_target]
    Forces all commands which normally ask for a "direction" to use the
    current "target" if there is one.  Use of this option can be dangerous
    if you target locations on the ground, unless you clear them when done.

***** <pickup_always>
***** <pickup_inven>
Always pickup items                           [pickup_always]
Always pickup items matching inventory        [pickup_inven]
    If pickup_always is on, all items are always picked up, providing it is
    safe to do so.  If pickup_inven is on, then items matching those in your
    inventory are always picked up.

***** <easy_open>
Open/Disarm/Close without direction    [easy_open]
    If there is only one closed door next to the character, the game will 
    not bother asking for a direction when the player asks to "o"pen 
    something. The same applies for "c"losing doors and "D"isarming traps.

***** <mouse_movement>
Allow mouse clicks to move the player  [mouse_movement]
    Clicking on the main window will be interpreted as a move command to 
    that spot.

***** <mouse_buttons>
Show mouse status line buttons         [mouse_buttons]
    Creates clickable "buttons" on the bottom line of the main window, to
    enhance mouse-led play.

***** <xchars_to_file>
Allow accents in output files          [xchars_to_file]
    Extended characters (accents, umlauts and so on) will be printed in
    files created by the game (character dumps, screenshots etc.).

=== Display options ===

***** <hp_changes_color>
Player color indicates low hit points    [hp_changes_color]
    This option makes the player @ turn various shades of colour from white
    to red, depending on percentage of HP remaining.

***** <center_player>
Center map continuously                  [center_player]
    The map always centres on the player with this option on. With it off, it
    is divided into 25 sections, with coordinates (0,0) to (4,4), and will 
    show one section at a time - the display will "flip" to the next section
    when the player nears the edge.

***** <show_flavors>
Show flavors in object descriptions    [show_flavors]
    Display "flavors" (color or variety) in object descriptions, even for
    objects whose type is known.  This does not affect objects in stores.

***** <view_yellow_light>
Use special colors for torch-lit grids    [view_yellow_light]
    This option causes special colors to be used for "torch-lit" grids in
    certain situations (see "view_granite_light" and "view_special_light").
    Turning this option off will slightly improve game speed.

***** <animate_flicker>
Animate multi-coloured monsters and items   [animate_flicker]
    Certain powerful monsters and items will shimmer in real time, i.e. 
    between keypresses. 

***** <purple_uniques>
Show unique monsters in a special colour     [purple_uniques]
    All "unique" monsters will be shown in a light purple colour, which 
    is not used for any "normal" monsters - so you can tell at a glance
    that they are unique. If you like the idea but don't like the colour, 
    you can edit it via the "interact with colors" option.

=== Disturbance options ===

***** <disturb_move>
Disturb whenever any monster moves    [disturb_move]
    Disturb the player when any monster moves, appears, or disappears.
    This includes monsters which are only visible due to telepathy, so
    you should probably turn this option off if you want to "rest" near
    such monsters.

***** <disturb_near>
Disturb whenever viewable monster moves    [disturb_near]
    Disturb the player when any viewable monster moves, whenever any
    monster becomes viewable for the first time, and also whenever any
    viewable monster becomes no longer viewable.  This option ignores
    the existance of "telepathy" for the purpose of determining whether
    a monster is "viewable".  See also the "view_reduce_view" option.

***** <disturb_detect>
Disturb whenever leaving trap detected area    [disturb_detect]
    This option causes you to be disturbed when you reach the edge of your
    last invocation of detect traps. 

***** <disturb_state>
Disturb whenever player state changes    [disturb_state]
    This option causes you to be disturbed whenever the player state
    changes, including changes in hunger, resistance, confusion, etc.

***** <auto_more>
Automatically clear -more- prompts    [auto_more]
    The game does not wait for a keypress when it comes to a -more-
    prompt, but carries on going.

***** <notify_recharge>
Notify on object recharge        [notify_recharge]
    This causes the game to print a message when any rechargeable object 
    (i.e. a rod or activatable weapon or armour item) finishes recharging.
    It is the equivalent of inscribing {!!} on all such items. 

=== Birth options ===

***** <birth_maximize>
Maximize effect of race/class bonuses    [birth_maximize]
     Normally, if a character should find potions that permanently increase
     his stats, the maximum that can be achieved without equipment bonuses 
     is 18/100. If maximize mode is on (which is the default), then the race
     and class bonuses and penalties apply to this limit, so your half-troll 
     will have a greater maximum possible strength (unassisted by his 
     equipment) than a hobbit. With maximize mode off, all characters max 
     out at 18/100 for all stats. This also affects the start of the game, 
     because race and class bonuses are applied as if they were "rings" in 
     maximize mode (at an exact rate of 0/10 percentile points equals 1 point
     for stats over 18), and as "potions" in non-maximize mode (drinking six
     potions of [stat] will probably increase your stat by more than 0/60 if 
     it was at 18 to start with.) To cut a long story short and a confusing 
     explanation simple, you get better starting stats in non-maximize mode,
     but can't get as good at what you're supposed to be best at in the later 
     stages of the game.

***** <birth_randarts>
Randomize the artifacts (except a very few)    [birth_randarts]
     A different set of artifacts will be created, in place of the standard 
     ones. This is intended primarily for people who have played enough to
     know what most of the standard artifacts do and want some variety. The
     number, findability and power of random artifacts will all match the 
     standard set - approximately.

***** <birth_keep_randarts>
Use previous set of randarts    [birth_keep_randarts]
     Does what it says on the tin. Note that this option must be set at the
     END of the game, from the death menu. Once you have restarted the game,
     it is too late to set it (but you can still un-set it if you change your
     mind). Note that switching to non-random artifacts will wipe randarts,
     regardless of this option.

***** <birth_ai_smell>
Monsters chase recent locations    [birth_ai_smell]
     Allow monsters to take advantage of "old" trails that you may have left
     in the dungeon.  This has no effect unless "flow_by_sound" is also set.

***** <birth_ai_packs>
Monsters act smarter in groups    [birth_ai_packs]
     "Group" monsters will use tactics that groups of monsters might 
     reasonably employ - such as hiding out of sight around a corner, 
     trying to draw the character out into the middle of a room so they 
     can surround him and all attack at once, rather than chasing one
     by one down a corridor.

***** <birth_ai_learn>
Monsters learn from their mistakes    [birth_ai_learn]
     Allow monsters to learn what spell attacks you are resistant to,
     and to use this information to choose the best attacks.

***** <birth_ai_cheat>
Monsters exploit players weaknesses    [birth_ai_cheat]
     Allow monsters to know what spell attacks you are resistant to,
     and to use this information to choose the best attacks.

***** <birth_ai_smart>
Monsters behave more intelligently (broken)    [birth_ai_smart]
     Monsters have a certain amount of intelligence and will use it - 
     teleporting away when low on hit points, using their more powerful
     spells in preference to the less powerful spells, etc. Not all 
     monsters are, of course, intelligent - but those who are are almost
     unkillable with this option on (especially if they can heal 
     themselves).

***** <birth_ironman>
Restrict the use of stairs/recall    [birth_ironman]
     This option, not recommended for non-advanced players, prevents the 
     generation of up staircases, and makes the scroll and effect of Word 
     of Recall not function: and teleport-level always goes down, as does 
     the spell of stair-creation, except on the quest levels of Sauron and 
     Morgoth.

***** <birth_no_stores>
Restrict the use of stores/home    [birth_no_stores]
     The stores are all closed. The home is someone else's, and locked. You 
     can keep nothing but what you carry with you, and get nothing but what 
     you find in the dungeon. No selling items, or buying potions of 
     restore stat... Not recommended for new players, or indeed for 
     sane players.

***** <birth_no_artifacts>
Restrict the creation of artifacts    [birth_no_artifacts]
     No artifacts will be created. Ever. Just *how* masochistic are you?

***** <birth_no_stacking>
Don't stack objects on the floor   [birth_no_stacking]
     Items dropped on the floor will spread out instead of stacking.
     Normal items will disappear if there is no empty grid within a radius
     of three squares.

***** <birth_no_preserve>
Lose artifacts when leaving level    [birth_no_preserve]
     Normally if you leave a level with an unidentified artifact on it 
     you may still find it later. With this option on, if you leave a level
     with an artifact on it's gone for the rest of the game whether you 
     knew it was there or not. Note that this option has no effect on 
     artifacts which you have already identified (i.e. picked up) - these
     will always be permanently lost if you leave a level without taking
     them with you.

***** <birth_no_stairs>
Don't generate connected stairs    [birth_no_stairs]
     Never generate a staircase back to the level you came from, if you used
     a staircase to get to the level.

***** <birth_no_feelings>
Don't show level feelings          [birth_no_feelings]
     The "quality" of a level is never revealed, no matter how long you 
     spend on the level.

***** <birth_no_selling>
Items always sell for 0 gold       [birth_no_selling]
     Shopkeepers will never pay you for items you sell, though they will 
     still identify unknown items for you, and will still sell you their 
     wares. To balance out income in the game, gold found in the dungeon 
     will be increased if this option is on.

=== Cheating options ===

***** <cheat_hear>
Peek into monster creation    [cheat_hear]
    Cheaters never win.  But they can peek at monster creation.

***** <cheat_room>
Peek into dungeon creation    [cheat_room]
    Cheaters never win.  But they can peek at room creation.

***** <cheat_xtra>
Peek into something else    [cheat_xtra]
    Cheaters never win.  But they can see debugging messages.

***** <cheat_know>
Know complete monster info    [cheat_know]
    Cheaters never win.  But they can know all about monsters.

***** <cheat_live>
Allow player to avoid death    [cheat_live]
    Cheaters never win.  But they can cheat death.


=== Window flags ===

Some platforms support "sub-windows", which are windows which can be used to
display useful information generally available through other means.  The best
thing about these windows is that they are updated automatically (usually) to
reflect the current state of the world.  The "window options" can be used to
specify what should be displayed in each window.  The possible choices should
be pretty obvious.

Display inven/equip
    Display the player inventory (and sometimes the equipment).

Display equip/inven
    Display the player equipment (and sometimes the inventory).

Display player (basic)
    Display a brief description of the character, including a breakdown
    of the current player "skills" (including attacks/shots per round).

Display player (extra)
    Display a special description of the character, including some of the
    "flags" which pertain to a character, broken down by equipment item.

Display player (compact)
    Display a brief description of the character, including a breakdown
    of the contributions of each equipment item to various resistances
    and stats.

Display map view
    Display the area around the player or around the target while
    targetting.  This allows using graphical tiles in their original
    size.

Display messages
    Display the most recently generated "messages".

Display overhead view
    Display an overhead view of the entire dungeon level.

Display monster recall
    Display a description of the most monster which has been most recently
    attacked, targetted, or examined in some way.

Display object recall
    Display a description of the most recently selected object.  Currently
    this only affects spellbooks and prayerbooks.  This window flag may be
    usefully combined with others, such as "monster recall".

Display monster list
    Display a list of monsters you know about and their distance from you.

Display status
    ???

Display item list
    Display a list of items you know about and their distance from you.
 
Display borg messages
    This window flag is currently used only by the Borg.

Display borg status
    This window flag is currently used only by the Borg.


=== Left Over Information ===

The "hitpoint_warn" value, if non-zero, is the percentage of maximal hitpoints
at which the player is warned that he may die.  It is also used as the cut-off
for using the color red to display both hitpoints and mana.

The "delay_factor" value, if non-zero, will slow down the visual effects used
for missile, bolt, beam, and ball attacks.  The actual time delay is equal to
"delay_factor" squared, in milliseconds.

