completely_random ? 9 : std::min(9, you.get_experience_level());

                (completely_random ? 9
                                   : std::min(9, you.get_experience_level()));

    std::vector<bool> avoid_seen(spell_list.size(), !completely_random);

           // Only once.
           avoid_memorised[spell_pos] = false;
           continue;

            // Only once.
            avoid_memorised[spell_pos] = false;
            continue;
        }
        if (avoid_seen[spell_pos] && you.seen_spell[spell] && coinflip())
        {
            // Only once.
            avoid_seen[spell_pos] = false;
            continue;

    std::vector<int> spellcount;

                        junk1, junk2, true);

                        junk1, junk2, !completely_random);

        spellcount.push_back(spell_list.size());

            int skill = skills[i];
            skill_weights[i] = you.skills[skill]
                               * 100 / species_skills(skill, you.species);

            int skill  = skills[i];
            int weight = you.skills[skill]
                         * 200 / species_skills(skill, you.species) + 1;
            if (spellcount[i] < 5)
                weight -= 5 - spellcount[i];

            skill_weights[i] = std::max(0, weight);

                              && lowest_level > 1);

                              && (lowest_level > 1 || coinflip()));

bool is_invalid_skill(int skill);

    if (best_skill == SK_UNUSED_1
        || best_skill > SK_UNARMED_COMBAT && best_skill < SK_SPELLCASTING
        || best_skill >= NUM_SKILLS)
    {

    if (is_invalid_skill(best_skill))

    }

        if (i == excl_skill
            || i == SK_UNUSED_1
            || i > SK_UNARMED_COMBAT && i < SK_SPELLCASTING)
        {

        if (i == excl_skill || is_invalid_skill(i))

        }

        if (i == SK_UNUSED_1
            || (i > SK_UNARMED_COMBAT && i < SK_SPELLCASTING))

        if (is_invalid_skill(i))

            if (i == j
                || j == SK_UNUSED_1
                || (j > SK_UNARMED_COMBAT && j < SK_SPELLCASTING))
            {

            if (i == j || is_invalid_skill(j))

            }

}
bool is_invalid_skill(int skill)
{
    if (skill < 0 || skill == SK_UNUSED_1 || skill >= NUM_SKILLS)
        return (true);
    if (skill > SK_UNARMED_COMBAT && skill < SK_SPELLCASTING)
        return (true);
    return (false);

        int max_level   = std::min( 9, std::max(1, item_level / 3) );
        int spell_level = random_range(1, max_level);
        int num_spells  = 5 - (spell_level + 1) / 2 + random_range(1, 3);
        make_book_level_randart(item, spell_level, num_spells);

        int max_level  = std::min( 9, std::max(1, item_level / 3) );
        int spl_level  = random_range(1, max_level);
        int max_spells = 5 + spl_level/3;
        make_book_level_randart(item, spl_level, max_spells);

    dump_book_spells       = true;

    else BOOL_OPTION(dump_book_spells);

    bool        dump_book_spells;

        if (i == SK_UNUSED_1)

        if (is_invalid_skill(i))

    int level = spell_difficulty(spell) - 1;

    int leveldiff = 5 - spell_difficulty(spell);
    return std::max(0, 2 * weight/count + leveldiff);

    return std::max(0, weight/count - 2*level);

            if (i > SK_UNARMED_COMBAT && i < SK_SPELLCASTING)

            if (is_invalid_skill(i))

        book.sub_type = BOOK_RANDART_LEVEL;
        int num_spells = 5 - (level + 1) / 2 + random_range(1, 3);
        make_book_level_randart(book, level, num_spells, owner);

        book.sub_type  = BOOK_RANDART_LEVEL;
        int max_spells = 5 + level/3;
        make_book_level_randart(book, level, max_spells, owner);

            if (i == SK_UNUSED_1
                || i > SK_UNARMED_COMBAT && i < SK_SPELLCASTING)

            if (is_invalid_skill(i))

    for (int j = 0; j < 8; j++)

    for (int j = 0; j < SPELLBOOK_SIZE; j++)

        else if (!verbose && is_random_artefact( item ))

        else if (!verbose
                 && (Options.dump_book_spells || is_random_artefact(item)))

            mprf("book: %s, option: %s", item.name(DESC_PLAIN).c_str(),
                 Options.dump_book_spells ? "true" : "false");

        if (i == SK_UNUSED_1 || (i > SK_UNARMED_COMBAT && i < SK_SPELLCASTING))

        if (is_invalid_skill(i))

            if (i == SK_UNUSED_1
                || (i > SK_UNARMED_COMBAT && i < SK_SPELLCASTING))
            {

            if (is_invalid_skill(i))

            }

                        if (is_dumpable_artefact( you.inv[j], false ))

                        if (is_dumpable_artefact( you.inv[j], false )
                            || Options.dump_book_spells
                               && you.inv[j].base_type == OBJ_BOOKS)

}                               // end dump_inventory()

}

# dump_order += turns_by_place, skills,s pells, overview, mutations,

# dump_order += turns_by_place, skills, spells, overview, mutations,

# dump_book_spells = false

This document explains all of the options in the latest version of 

This document explains all of the options in the latest version of

work properly, ask for help on the newsgroup rec.games.roguelike.misc. 
Please flag queries with '-crawl-', as other roguelikes are discussed 

work properly, ask for help on the newsgroup rec.games.roguelike.misc.
Please flag queries with '-crawl-', as other roguelikes are discussed

                weapon, book, chaos_knight, death_knight, priest, 

                weapon, book, chaos_knight, death_knight, priest,

                stash.lua, wield.lua, kills.lua, runrest.lua, 

                stash.lua, wield.lua, kills.lua, runrest.lua,

                chunks_autopickup, assign_item_slot, drop_mode, 

                chunks_autopickup, assign_item_slot, drop_mode,

                detected_monster_colour, detected_item_colour, 

                detected_monster_colour, detected_item_colour,

4-g     Travel and Exploration. 

4-g     Travel and Exploration.

                runrest_ignore_message, runrest_ignore_poison, 
                runrest_ignore_monster, trapwalk_safe_hp, 

                runrest_ignore_message, runrest_ignore_poison,
                runrest_ignore_monster, trapwalk_safe_hp,

                auto_list, easy_open, easy_unequip, easy_confirm, 
                allow_self_target, easy_butcher, always_confirm_butcher, 

                auto_list, easy_open, easy_unequip, easy_confirm,
                allow_self_target, easy_butcher, always_confirm_butcher,

                easy_eat_contaminated, prompt_for_swap, 

                easy_eat_contaminated, prompt_for_swap,

                mlist_min_height, msg_max_height, 

                mlist_min_height, msg_max_height,

                monster_damage, rotten_meat, equipment, floor, multiturn, 

                monster_damage, rotten_meat, equipment, floor, multiturn,

                tile_monster_col, tile_neutral_col, tile_friendly_col, 
                tile_plant_col, tile_item_col, tile_unseen_col, 
                tile_floor_col, tile_wall_col, tile_mapped_wall_col, 
                tile_door_col, tile_downstairs_col, tile_upstairs_col, 
                tile_feature_col, tile_trap_col, tile_water_col, 

                tile_monster_col, tile_neutral_col, tile_friendly_col,
                tile_plant_col, tile_item_col, tile_unseen_col,
                tile_floor_col, tile_wall_col, tile_mapped_wall_col,
                tile_door_col, tile_downstairs_col, tile_upstairs_col,
                tile_feature_col, tile_trap_col, tile_water_col,

                kill_map, dump_kill_places, dump_item_origins, 
                dump_item_origin_price, dump_message_count, dump_order

                kill_map, dump_kill_places, dump_item_origins,
                dump_item_origin_price, dump_message_count, dump_order,
                dump_book_spells

* settings/init.txt 

* settings/init.txt

Note that these are treated as if their content was entered verbatim 

Note that these are treated as if their content was entered verbatim

files in the settings/ directory but you can specify a special folder 

files in the settings/ directory but you can specify a special folder

External option files have several uses: They allow quick customisation 
of Crawl's general appearance (colouring/suppression of messages, and 

External option files have several uses: They allow quick customisation
of Crawl's general appearance (colouring/suppression of messages, and

many options to old defaults, i.e. those of Crawl 0.3.4 and before. 

many options to old defaults, i.e. those of Crawl 0.3.4 and before.

Note that, in the tutorial, some of your options settings may get 
overwritten to facilitate the explanations. This concerns the 

Note that, in the tutorial, some of your options settings may get
overwritten to facilitate the explanations. This concerns the

You can define shortcuts for option values (variables). For example, 

You can define shortcuts for option values (variables). For example,

The following options are a convenience to help you quickly start your 

The following options are a convenience to help you quickly start your

        If set, that's the name all your Crawl characters will get. 

        If set, that's the name all your Crawl characters will get.

        Crawl remembers the options (class, race etc.) you used to 
        create your last character. You may recycle them in the 
        starting screen for a new character. If this option is set to 

        Crawl remembers the options (class, race etc.) you used to
        create your last character. You may recycle them in the
        starting screen for a new character. If this option is set to

        If you use this option and want to enter a name _after_ 
        choosing your race and class, you must enter . at the initial 
        name prompt - hitting Enter at the name prompt will simply 

        If you use this option and want to enter a name _after_
        choosing your race and class, you must enter . at the initial
        name prompt - hitting Enter at the name prompt will simply

        If set to true, the character selection screen will offer 

        If set to true, the character selection screen will offer

        Note that this needs to be set before the "race" or "class" 

        Note that this needs to be set before the "race" or "class"

        Specifying the weapon option allows you to bypass the weapon 
        selection screen.  Note that tridents are restricted to only 
        merfolk and gladiators, but you'll get the standard query in 

        Specifying the weapon option allows you to bypass the weapon
        selection screen.  Note that tridents are restricted to only
        merfolk and gladiators, but you'll get the standard query in

        Several spellcasting classes can choose their starting 

        Several spellcasting classes can choose their starting

        The above three make in advance the additional choices for 

        The above three make in advance the additional choices for

        The above options (weapons and class options) will override 

        The above options (weapons and class options) will override

        The path used for the relative paths when looking for other 
        files. Defaults to the directory that contains the Crawl 

        The path used for the relative paths when looking for other
        files. Defaults to the directory that contains the Crawl

        Directory where morgue dumps files (morgue*.txt and 

        Directory where morgue dumps files (morgue*.txt and

        Directory where saves and bones are stored. This option may be 
        ignored depending on the settings used to compile Crawl, but 

        Directory where saves and bones are stored. This option may be
        ignored depending on the settings used to compile Crawl, but

        Plays the sound file if a message contains regex. The regex 

        Plays the sound file if a message contains regex. The regex

        roguelikes or old computer RPGs. Alternatively, ask for help 

        roguelikes or old computer RPGs. Alternatively, ask for help

  stash.lua     -- annotates the stash file for better searching 

  stash.lua     -- annotates the stash file for better searching

                   up all weapons with the long blade skill. Similarly, 
                   you can use 'altar','portal' etc. Also, you can look 
                   for spellbooks ('book'), artefacts ('artefact'), and 
                   ego items ('ego'). 

                   up all weapons with the long blade skill. Similarly,
                   you can use 'altar','portal' etc. Also, you can look
                   for spellbooks ('book'), artefacts ('artefact'), and
                   ego items ('ego').

  kills.lua     -- improves the Vanquished Creatures list in dump files; 
                   currently gives three lists (Vanquished, Friendly, 

  kills.lua     -- improves the Vanquished Creatures list in dump files;
                   currently gives three lists (Vanquished, Friendly,

  runrest.lua   -- allows overriding certain stop conditions when 

  runrest.lua   -- allows overriding certain stop conditions when

                   New options: runrest_ignore_poison, 

                   New options: runrest_ignore_poison,

  gearset.lua   -- provides commands for switching of complete sets via 

  gearset.lua   -- provides commands for switching of complete sets via

  trapwalk.lua  -- allows travel to cross certain traps if you have 

  trapwalk.lua  -- allows travel to cross certain traps if you have

        Note that _whether_ items are picked up automatically or not, is 
        controlled by the in-game toggle Ctrl-A. Also note that picking 
        up takes a turn, but only one turn (regardless of the number of 
        items). If you teleport or blink onto a square with interesting 

        Note that _whether_ items are picked up automatically or not, is
        controlled by the in-game toggle Ctrl-A. Also note that picking
        up takes a turn, but only one turn (regardless of the number of
        items). If you teleport or blink onto a square with interesting

        A set of regexes that force matching items to be picked up (if 
        prefixed with <), or never picked up (if prefixed with >). 
        Excludes (>) take precedence over includes (<), so if the same 
        item is matched by both an exclude and an include, it will not 

        A set of regexes that force matching items to be picked up (if
        prefixed with <), or never picked up (if prefixed with >).
        Excludes (>) take precedence over includes (<), so if the same
        item is matched by both an exclude and an include, it will not

        Forces autopickup to grab all curare-tipped needles, even if 

        Forces autopickup to grab all curare-tipped needles, even if

        Whitespace between <> and the match expression is significant, 

        Whitespace between <> and the match expression is significant,

             autopickup_exceptions = inaccuracy, scrolls? of paper, 
             autopickup_exceptions = immolation, curse (armour|weapon), 

             autopickup_exceptions = inaccuracy, scrolls? of paper,
             autopickup_exceptions = immolation, curse (armour|weapon),

        autopickup exceptions for potions except maybe for very special 

        autopickup exceptions for potions except maybe for very special

        When set to false, the game starts with autopickup turned off. 

        When set to false, the game starts with autopickup turned off.

        your burden status (from unencumbered to burdened, or from 

        your burden status (from unencumbered to burdened, or from

        pickup_thrown = true causes autopickup to pick up thrown/fired 
        missiles, which can make life much easier for hunter types. Be 
        aware that autopickup uses a turn, though it won't trigger if 

        pickup_thrown = true causes autopickup to pick up thrown/fired
        missiles, which can make life much easier for hunter types. Be
        aware that autopickup uses a turn, though it won't trigger if

        pickup_dropped lets autopickup affect objects you've dropped. 
        Set to false to block autopickup for dropped objects. This can 

        pickup_dropped lets autopickup affect objects you've dropped.
        Set to false to block autopickup for dropped objects. This can

        When picking up items, the inventory slot into which the item 
        goes is normally the first free slot from a-zA-Z (this is the 
        default "forward" behaviour). Setting assign_item_slot to 
        "backward" changes the slot assignment to the first letter after 
        the last slot. 

        When picking up items, the inventory slot into which the item
        goes is normally the first free slot from a-zA-Z (this is the
        default "forward" behaviour). Setting assign_item_slot to
        "backward" changes the slot assignment to the first letter after
        the last slot.

          assign_item_slot = backward, the next item will go to 'd' 

          assign_item_slot = backward, the next item will go to 'd'

        With "backward", items dropped/fired and picked up later are 

        With "backward", items dropped/fired and picked up later are

        Single is the classic behaviour; when you select an inventory 
        letter, that item will be dropped immediately. Multidrop allows 
        you to select multiple items to be dropped. (You can also switch 

        Single is the classic behaviour; when you select an inventory
        letter, that item will be dropped immediately. Multidrop allows
        you to select multiple items to be dropped. (You can also switch

        Multidrop is the default and can be very convenient, but be 
        aware that every item dropped takes one turn. (This is different 
        from picking up.) 
        When selecting multidrops, the top right corner shows the 

        Multidrop is the default and can be very convenient, but be
        aware that every item dropped takes one turn. (This is different
        from picking up.)
        When selecting multidrops, the top right corner shows the

        The order in which items get dropped is from top to bottom in 
        the inventory listing, but equipped items will be dropped last, 

        The order in which items get dropped is from top to bottom in
        the inventory listing, but equipped items will be dropped last,

        Single is the classical behaviour (and default): when picking up 
        items, you are prompted for them one by one. Multi makes a menu 
        appear, where you can choose which items to pick up. Note that 
        no matter how many items you choose, picking up will always take 

        Single is the classical behaviour (and default): when picking up
        items, you are prompted for them one by one. Multi makes a menu
        appear, where you can choose which items to pick up. Note that
        no matter how many items you choose, picking up will always take

        If pickup_mode is auto:X, where X is some number (for example, 
        auto:5), then pickup will give a menu if there are at least X 

        If pickup_mode is auto:X, where X is some number (for example,
        auto:5), then pickup will give a menu if there are at least X

        When selecting items using the global (de)select keys (',' or 
        '-') in a multidrop menu, you can choose to select only items 

        When selecting items using the global (de)select keys (',' or
        '-') in a multidrop menu, you can choose to select only items

        For instance, to quickly select carrion and rotting chunks of 

        For instance, to quickly select carrion and rotting chunks of

        Other choices can come in handy as well, e.g. if you want to 

        Other choices can come in handy as well, e.g. if you want to

        When a drop_filter is set, using the select/deselect keys will 
        set/clear selection of items that match the filter 

        When a drop_filter is set, using the select/deselect keys will
        set/clear selection of items that match the filter

             friend = They will pick up anything they or another ally 

             friend = They will pick up anything they or another ally

        Note that this only works for intelligent allies (such as you 
        can get when worshipping Beogh or when summoning intelligent 
        monsters), and that monsters have their own reasonings for which 
        items they may need, and when they feel safe enough to pick them 
        up. Except for "none", these options won't let you override these 

        Note that this only works for intelligent allies (such as you
        can get when worshipping Beogh or when summoning intelligent
        monsters), and that monsters have their own reasonings for which
        items they may need, and when they feel safe enough to pick them
        up. Except for "none", these options won't let you override these

        Set to false to disable targeting zero exp monsters (i.e. 
        plants) in hostile targeting mode. This is usually convenient to 

        Set to false to disable targeting zero exp monsters (i.e.
        plants) in hostile targeting mode. This is usually convenient to

        When cycling through items with 'x' look-around, setting 
        target_oos to true allows you to jump the cursor to dungeon 
        features (<> for stairs, Tab for shops, ^ for traps) and stashes 
        (with the '*' and '/' keys) that are outside line-of-sight but 

        When cycling through items with 'x' look-around, setting
        target_oos to true allows you to jump the cursor to dungeon
        features (<> for stairs, Tab for shops, ^ for traps) and stashes
        (with the '*' and '/' keys) that are outside line-of-sight but

        When cycling through items/features with the 'x' look-around 
        command, setting target_los_first to true will force the cursor 

        When cycling through items/features with the 'x' look-around
        command, setting target_los_first to true will force the cursor

        If default_target = false, the targeting cursor will always 

        If default_target = false, the targeting cursor will always

        Cleans up out of sight monsters and clouds on the map. This is 
        like pressing Ctrl-C (clearing both main screen and level map) 

        Cleans up out of sight monsters and clouds on the map. This is
        like pressing Ctrl-C (clearing both main screen and level map)

   standout         -- often the same as reverse, might be underline or 

   standout         -- often the same as reverse, might be underline or

   bold             -- used by colour curses for brightening foreground 

   bold             -- used by colour curses for brightening foreground

   blink            -- used by colour curses for brightening background 

   blink            -- used by colour curses for brightening background

   highlight:colour -- set background colour of branded monsters to 

   highlight:colour -- set background colour of branded monsters to

See part Technical (6-) for dos_use_background_intensity under Windows 

See part Technical (6-) for dos_use_background_intensity under Windows

        Brand friends in some way. This is very helpful for summoners. 

        Brand friends in some way. This is very helpful for summoners.

        shows friends with a green background. If the friend is itself 

        shows friends with a green background. If the friend is itself

        Some deities object to you stabbing monsters. Certain classes 
        specialise in stabbing monsters. Still other characters are 
        happy if they spot a monster before the monster spots them. In 
        all these cases, it helps to identify monsters that are unaware 
        of the character (and hence susceptible to being stabbed) without 
        using the 'x' command. All the normal 'brand' options apply. For 

        Some deities object to you stabbing monsters. Certain classes
        specialise in stabbing monsters. Still other characters are
        happy if they spot a monster before the monster spots them. In
        all these cases, it helps to identify monsters that are unaware
        of the character (and hence susceptible to being stabbed) without
        using the 'x' command. All the normal 'brand' options apply. For

        Brands features (stairs, shops, altars) that would otherwise be 
        hidden by items. If you use this brand, the items on the square 
        are hidden by the feature symbol and the feature symbol is 

        Brands features (stairs, shops, altars) that would otherwise be
        hidden by items. If you use this brand, the items on the square
        are hidden by the feature symbol and the feature symbol is

        Brands traps that would otherwise be hidden by items. If you 

        Brands traps that would otherwise be hidden by items. If you

        How many squares the cursor moves on the level map when using 

        How many squares the cursor moves on the level map when using

        Whether to show the level name at the top of the level map 

        Whether to show the level name at the top of the level map

        Similar to view_max_width, but sets the viewport's maximum 

        Similar to view_max_width, but sets the viewport's maximum

        An aliased option that sets both scroll_margin_x and 

        An aliased option that sets both scroll_margin_x and

        platform. Setting to -1 will jump to end of travel - you will 

        platform. Setting to -1 will jump to end of travel - you will

        Prevent travel from routing through shallow water. By default, 
        this option is commented out. For merfolk and/or characters with 
        permanent levitation, 

        Prevent travel from routing through shallow water. By default,
        this option is commented out. For merfolk and/or characters with
        permanent levitation,

        They are 

        They are

          excluded: the colour for the centre of travel exclusions 

          excluded: the colour for the centre of travel exclusions

          excluded_circle: the colour for travel exclusions apart from 

          excluded_circle: the colour for travel exclusions apart from

        Travel will always stop upon hitpoint loss, confusion, stat 
        drain, getting encumbered, catching sight of a non-friendly 
        monster, and teleporting. In addition, a message containing one 
        of the expressions in travel_stop_message will stop travel. For 
        example, 

        Travel will always stop upon hitpoint loss, confusion, stat
        drain, getting encumbered, catching sight of a non-friendly
        monster, and teleporting. In addition, a message containing one
        of the expressions in travel_stop_message will stop travel. For
        example,

        stops travel if Xom grants us a gift suddenly. To limit a 
        substring match to a message channel, prefix the substring with 
        the channel name and a colon (see section 4-k below on Message 
        Channels). For instance, if you want travel to stop when you're 

        stops travel if Xom grants us a gift suddenly. To limit a
        substring match to a message channel, prefix the substring with
        the channel name and a colon (see section 4-k below on Message
        Channels). For instance, if you want travel to stop when you're

        If you'd like to stop travel for any message sent to a 
        particular channel, use a travel_stop_message line with that 
        message channel name and a colon alone. For example, if you're 

        If you'd like to stop travel for any message sent to a
        particular channel, use a travel_stop_message line with that
        message channel name and a colon alone. For example, if you're

        This only works if runrest.lua has already been sourced in 
        init.txt. Any message containing the string will *not* stop your 

        This only works if runrest.lua has already been sourced in
        init.txt. Any message containing the string will *not* stop your

        Note that monster talk and dungeon noises already do not 
        interrupt running or resting, by default. 

        Note that monster talk and dungeon noises already do not
        interrupt running or resting, by default.

        This only works if runrest.lua has already been sourced in 
        init.txt. Poison damage of x will be ignored if you have at 
        least y hp if you've defined a runrest_ignore_poison = x:y 
        option. Running here means shift-running and resting only. Only 
        one runrest_ignore_poison line is considered.  Note that for 
        this work, you should also tell Crawl to ignore the 

        This only works if runrest.lua has already been sourced in
        init.txt. Poison damage of x will be ignored if you have at
        least y hp if you've defined a runrest_ignore_poison = x:y
        option. Running here means shift-running and resting only. Only
        one runrest_ignore_poison line is considered.  Note that for
        this work, you should also tell Crawl to ignore the

             runrest_ignore_poison = 4:100 

             runrest_ignore_poison = 4:100

        This only works if runrest.lua has already been sourced in 

        This only works if runrest.lua has already been sourced in

        all of big fish, jellyfish, giant goldfish and lavafish will be 
        considered safe for travel, explore and resting as long as the 

        all of big fish, jellyfish, giant goldfish and lavafish will be
        considered safe for travel, explore and resting as long as the

        This only works if trapwalk.lua has already been sourced in 
        init.txt. Any square containing one of the listed trap types 
        will be considered safe for travel if your hp is greater than or 

        This only works if trapwalk.lua has already been sourced in
        init.txt. Any square containing one of the listed trap types
        will be considered safe for travel if your hp is greater than or

        All the existing trap types can be used, but in practice only 
        the mechanical traps (dart, bolt, arrow, needle, spear, axe, 
        blade) make sense. Note that travel tries to avoid traps if this 

        All the existing trap types can be used, but in practice only
        the mechanical traps (dart, bolt, arrow, needle, spear, axe,
        blade) make sense. Note that travel tries to avoid traps if this

        Whenever you encounter a sleeping or stationary monster during 

        Whenever you encounter a sleeping or stationary monster during

        travel exclusion is set centered on this monster, meaning 
        autoexplore won't ever bring you in its line of sight. If the 
        monster dies or wakes up while you are in sight, this exclusion 

        travel exclusion is set centered on this monster, meaning
        autoexplore won't ever bring you in its line of sight. If the
        monster dies or wakes up while you are in sight, this exclusion

        This only works if stash.lua has already been sourced in 
        init.txt. Automatically annotates items with their object class, 

        This only works if stash.lua has already been sourced in
        init.txt. Automatically annotates items with their object class,

        This only works if stash.lua has already been sourced in 

        This only works if stash.lua has already been sourced in

        automatically listed for commands like eat and read. This is 
        like immediately hitting '?', and can be confusing to beginners 
        because they won't get to see the prompts. This option does not 
        apply to spell casting... Conjurers would probably find that 
        really annoying. 

        automatically listed for commands like eat and read. This is
        like immediately hitting '?', and can be confusing to beginners
        because they won't get to see the prompts. This option does not
        apply to spell casting... Conjurers would probably find that
        really annoying.

        Open doors by moving on to them. Highly convenient. Note that 
        travel and exploration will automatically open doors depending 

        Open doors by moving on to them. Highly convenient. Note that
        travel and exploration will automatically open doors depending

        Allows auto removal of armour and jewellery when dropping it. 

        Allows auto removal of armour and jewellery when dropping it.

        WARNING TO KEYPAD USERS: The number 7 is mapped to the letter 
        'y', which can result in accidentally answering yes to 

        WARNING TO KEYPAD USERS: The number 7 is mapped to the letter
        'y', which can result in accidentally answering yes to

        If true, auto-switch to an appropriate uncursed weapon for 
        butchery. For such tools any special messages are ignored. If 

        If true, auto-switch to an appropriate uncursed weapon for
        butchery. For such tools any special messages are ignored. If

        If true, always request confirmation before butchering. If 
        false, butchering will proceed automatically if there is exactly 
        one corpse on the square. If there are multiple corpses on a 

        If true, always request confirmation before butchering. If
        false, butchering will proceed automatically if there is exactly
        one corpse on the square. If there are multiple corpses on a

        Poisonous, mutagenic, rot-inducing, and chunks forbidden by 

        Poisonous, mutagenic, rot-inducing, and chunks forbidden by

        If this is set to true then when using the (e)at command, the 
        game will automatically determine the oldest chunk that is safe 

        If this is set to true then when using the (e)at command, the
        game will automatically determine the oldest chunk that is safe

        Setting this option to true allows the quitting of item listing 
        with Space (as well as Escape, which always works). These lists 
        are essentially all of those that are requesting an inventory 
        item and accept '?' and '*'. The identify list will never easy 
        quit. 

        Setting this option to true allows the quitting of item listing
        with Space (as well as Escape, which always works). These lists
        are essentially all of those that are requesting an inventory
        item and accept '?' and '*'. The identify list will never easy
        quit.

        In multidrop (and pickup) menus, paging past the end will drop 

        In multidrop (and pickup) menus, paging past the end will drop

        having 4 kinds of potions would not sort them, but having 5 

        having 4 kinds of potions would not sort them, but having 5

        if only one of two different items is a known artefact, it will be 

        if only one of two different items is a known artefact, it will be

          enchantments, or curse-status. The qualified names for the 
          robes described above are "robe", "embroidered robe" and "robe 
          of Ponies", respectively.  The qualified names for the rings 
          described above are "brass ring" and "ring of fire 

          enchantments, or curse-status. The qualified names for the
          robes described above are "robe", "embroidered robe" and "robe
          of Ponies", respectively.  The qualified names for the rings
          described above are "brass ring" and "ring of fire

          Identified items show up before unidentified ones of the 
          same type. An item is regarded as identified once you know 

          Identified items show up before unidentified ones of the
          same type. An item is regarded as identified once you know

          If this sort criteria is placed before (or in the absence of) 

          If this sort criteria is placed before (or in the absence of)

        By default only pickup menus are sorted, and the sort criteria are: 

        By default only pickup menus are sorted, and the sort criteria are:

        For example, 

        For example,

        will produce the same inventory and drop menus as by default, 
        with the exception that all worn/wielded items come first. This 
        can be convenient if you use the '.' command to select 

        will produce the same inventory and drop menus as by default,
        with the exception that all worn/wielded items come first. This
        can be convenient if you use the '.' command to select

        hp_warning gives "* * * LOW HITPOINT WARNING * * *" on the 
        danger channel when the player takes damage and their hitpoints 
        are less than this percentage of their maximum (use 0 to turn 

        hp_warning gives "* * * LOW HITPOINT WARNING * * *" on the
        danger channel when the player takes damage and their hitpoints
        are less than this percentage of their maximum (use 0 to turn

        channel when the player's magic points drop below this 

        channel when the player's magic points drop below this

        Setting this option to true will delay the clearing of messages 
        until the message space is full (default is false which results 

        Setting this option to true will delay the clearing of messages
        until the message space is full (default is false which results

        When performing actions such as throwing or zapping, you can 
        toggle whether to show the beam path or not. This option 
        controls the initial status of this toggle. When set to true, 

        When performing actions such as throwing or zapping, you can
        toggle whether to show the beam path or not. This option
        controls the initial status of this toggle. When set to true,

        If you step over a stack with this number or more of items in 

        If you step over a stack with this number or more of items in

        rotting message, in the form of 

        rotting message, in the form of

        Display the monster list wherever Crawl may find space on 

        Display the monster list wherever Crawl may find space on

        screen) containing regex in the stated colour. There can be 
        several statements in a list, and also several menu_colour 
        lines. When using several menu_colour lines, the colour of the 
        _first_ matching regex is applied. For a list of colours, check 

        screen) containing regex in the stated colour. There can be
        several statements in a list, and also several menu_colour
        lines. When using several menu_colour lines, the colour of the
        _first_ matching regex is applied. For a list of colours, check

        The match specifies which listings are affected by the 
        colouring. If you specify 'any', or completely skip the <match>: 

        The match specifies which listings are affected by the
        colouring. If you specify 'any', or completely skip the <match>:

        When looking for menu_colour matches, these prefixes are prepended to 

        When looking for menu_colour matches, these prefixes are prepended to

        If you frequently die because you forget to use emergency items, 

        If you frequently die because you forget to use emergency items,

        menu_colour can also be applied to colour the in-game notes (to 
        be read with '?:'). The following line will show level ups in 

        menu_colour can also be applied to colour the in-game notes (to
        be read with '?:'). The following line will show level ups in

        message_colour allows you to override colours for individual 

        message_colour allows you to override colours for individual

        If the same message is repeated multiple times, then the Show 
        Previous Message command (Ctrl-P) will condense them into one 

        If the same message is repeated multiple times, then the Show
        Previous Message command (Ctrl-P) will condense them into one

        Controls the order of items autoselected for firing. Items 
        should be separated by commas and items that appear first get 
        higher priority. You can use multiple fire_order lines - all 

        Controls the order of items autoselected for firing. Items
        should be separated by commas and items that appear first get
        higher priority. You can use multiple fire_order lines - all

        Items in any position may be slash-separated to indicate that 
        these are of equal priority. If this is the case, the first item 
        in your inventory that fits one of these will be picked for 

        Items in any position may be slash-separated to indicate that
        these are of equal priority. If this is the case, the first item
        in your inventory that fits one of these will be picked for

        'launcher' refers to firing the appropriate missile for the 
        wielded weapon (i.e. crossbow, bow, sling, blowgun). You'll almost 
        certainly want it first, as it'll be ignored when you're not 
        wielding a ranged weapon. 'return' refers to (identified) 

        'launcher' refers to firing the appropriate missile for the
        wielded weapon (i.e. crossbow, bow, sling, blowgun). You'll almost
        certainly want it first, as it'll be ignored when you're not
        wielding a ranged weapon. 'return' refers to (identified)

belongs to one of the so-called channels. The behaviour of each channel 

belongs to one of the so-called channels. The behaviour of each channel

   floor           = messages when looking at or walking over a floor 

   floor           = messages when looking at or walking over a floor

   multiturn       = indicates long actions (wearing armour, dissecting 

   multiturn       = indicates long actions (wearing armour, dissecting

               (won't do anything silly like "mute" if plain == mute, 

               (won't do anything silly like "mute" if plain == mute,

COLOUR can be any of the colours described in section 6-a (colours 

COLOUR can be any of the colours described in section 6-a (colours

The only multi-colour channels currently are monster_damage and god. All 
other channels are defaulted to on, except for multiturn, which defaults 

The only multi-colour channels currently are monster_damage and god. All
other channels are defaulted to on, except for multiturn, which defaults

in order to help new players. You may want to comment out this option, 

in order to help new players. You may want to comment out this option,

        Any item whose description contains the regex will be 
        automatically inscribed (if autopickup is toggled on). For 
        example, marking all royal jellies and honeycombs eases the Hive 

        Any item whose description contains the regex will be
        automatically inscribed (if autopickup is toggled on). For
        example, marking all royal jellies and honeycombs eases the Hive

        Another use of autoinscription is making sure that you don't 

        Another use of autoinscription is making sure that you don't

        These are useful when using macros. Setting one of these 
        sub-options to true will cause the entire input buffer to be 
        dumped and thus effectively stop the macro. The sub-options 

        These are useful when using macros. Setting one of these
        sub-options to true will cause the entire input buffer to be
        dumped and thus effectively stop the macro. The sub-options

           failure -- when spells/abilities get miscast 

           failure -- when spells/abilities get miscast

           message -- whenever the game outputs a non-mute message 

           message -- whenever the game outputs a non-mute message

        macro_meta_entry lets you specify non-printable keycodes like 
        \{3} when creating a macro. For instance, if you want to keymap 

        macro_meta_entry lets you specify non-printable keycodes like
        \{3} when creating a macro. For instance, if you want to keymap

        First, in square brackets, list the key you want to use, with 
        ^X meaning Ctrl-X. After that name the command to be bound to 
        that key. You can bind several commands to the same key, as long 
        as they take effect in different areas of the game, i.e. one 

        First, in square brackets, list the key you want to use, with
        ^X meaning Ctrl-X. After that name the command to be bound to
        that key. You can bind several commands to the same key, as long
        as they take effect in different areas of the game, i.e. one

        For a full list of possible commands, see keybind.txt. 

        For a full list of possible commands, see keybind.txt.

                           map centre during level map mode ('X') 

                           map centre during level map mode ('X')

tile_tooltip_ms = 500 

tile_tooltip_ms = 500

tile_window_width  = 0 

tile_window_width  = 0

perished while the character was active. By default, dead monsters are 

perished while the character was active. By default, dead monsters are

        will merge friendly and other kills into the main vanquished 
        creatures list.  Note that the merging is only for display (the 
        game still maintains three separate lists internally) and that 
        kill places (see below) may be in the wrong order for merged 

        will merge friendly and other kills into the main vanquished
        creatures list.  Note that the merging is only for display (the
        game still maintains three separate lists internally) and that
        kill places (see below) may be in the wrong order for merged

        In the Vanquished Creatures list, this option controls how the 
        locations of each kill are displayed. Use 'none' to suppress 
        place display altogether, 'all' to display all known (up to 5) 
        kill places, anything else to the default of showing kill places 

        In the Vanquished Creatures list, this option controls how the
        locations of each kill are displayed. Use 'none' to suppress
        place display altogether, 'all' to display all known (up to 5)
        kill places, anything else to the default of showing kill places

        The game remembers where you find items. If you want this item 
        origin memory listed in your dumps, use this option to select 
        which items get annotated. Available selectors are: 
                artefacts, ego_arm, ego_weap, jewellery, runes, 

        The game remembers where you find items. If you want this item
        origin memory listed in your dumps, use this option to select
        which items get annotated. Available selectors are:
                artefacts, ego_arm, ego_weap, jewellery, runes,

        If you don't want any items to be annotated, set 

        If you don't want any items to be annotated, set

        Item origins are dumped if the price of the item is greater than 
        or equal to this amount. Set this to -1 to prevent selection by 

        Item origins are dumped if the price of the item is greater than
        or equal to this amount. Set this to -1 to prevent selection by

        The number of last messages to be displayed in character dump 
        files. 

        The number of last messages to be displayed in character dump
        files.

        dump_order lines - all lines but the first must use 

        dump_order lines - all lines but the first must use

        Two optional dump sections are turns_by_place and 
        kills_by_place, which add detailed statistics to where turns 
        were spent and monsters were killed. You can add them to your 

        Two optional dump sections are turns_by_place and
        kills_by_place, which add detailed statistics to where turns
        were spent and monsters were killed. You can add them to your

dump_book_spells = true
        By default all randart spellbooks in inventory will have all their
        spells listed in the dump. If this option is set to true, spells will
        also be dumped for non-randart spellbooks.

Crawl can automatically log certain events during play. You can read 

Crawl can automatically log certain events during play. You can read

        Monsters whose name matches an item in this comma-separated list 
        are considered interesting. You can have multiple note_monsters 

        Monsters whose name matches an item in this comma-separated list
        are considered interesting. You can have multiple note_monsters

        Monsters which are out of depth (OOD for short) for their 
        current level, e.g. a dragon on level 2, will be noted if they 
        are out of depth by at least ood_interesting levels. To disable 

        Monsters which are out of depth (OOD for short) for their
        current level, e.g. a dragon on level 2, will be noted if they
        are out of depth by at least ood_interesting levels. To disable

        If your HP falls below a certain note_hp_percentage of your max 

        If your HP falls below a certain note_hp_percentage of your max

        This sets which skill levels are noteworthy. You can have 
        multiple note_skill_levels lines. The default is nothing (no 

        This sets which skill levels are noteworthy. You can have
        multiple note_skill_levels lines. The default is nothing (no

        This is a shortcut for note_skill_levels = 1,2,..,27. If you set 

        This is a shortcut for note_skill_levels = 1,2,..,27. If you set

        Setting this option will cause a note whenever a new maximum in 
        skill levels is reached. If note_skill_max is true and 
        note_skill_levels is nonempty, notes will be taken whenever 

        Setting this option will cause a note whenever a new maximum in
        skill levels is reached. If note_skill_max is true and
        note_skill_levels is nonempty, notes will be taken whenever

        Messages which match an item in this comma-separated list are 
        considered interesting. You can have multiple note_messages 

        Messages which match an item in this comma-separated list are
        considered interesting. You can have multiple note_messages

        When enabled, the mouse_input option allows the game to use 

        When enabled, the mouse_input option allows the game to use

          no    -- still allows player to enter wizard mode after start 

          no    -- still allows player to enter wizard mode after start

        Chooses different character sets for the game play screen. DOS 
        and Windows users will want to use the IBM character set, Unix 

        Chooses different character sets for the game play screen. DOS
        and Windows users will want to use the IBM character set, Unix

        On Unix, Crawl may be built with Unicode support, in which case 
        you can use char_set = unicode to use unicode characters in the 

        On Unix, Crawl may be built with Unicode support, in which case
        you can use char_set = unicode to use unicode characters in the

        Crawl uses 4.0 b26/0.1.x-like item colours if 
        classic_item_colours is set to true. The default (false) is to 

        Crawl uses 4.0 b26/0.1.x-like item colours if
        classic_item_colours is set to true. The default (false) is to

        This option will not affect the colour of existing items, only 

        This option will not affect the colour of existing items, only

        Useful for terminals where some colours are hard to read (and 
        cannot be adjusted), as well as for creating a custom scheme, 
        especially when used with the background option on a terminal 

        Useful for terminals where some colours are hard to read (and
        cannot be adjusted), as well as for creating a custom scheme,
        especially when used with the background option on a terminal

        Format is colour.OLDCOLOUR = NEWCOLOUR, later rules take 
        precedence and the NEWCOLOUR is always literal (ie. it won't 

        Format is colour.OLDCOLOUR = NEWCOLOUR, later rules take
        precedence and the NEWCOLOUR is always literal (ie. it won't

                black, blue, green, cyan, red, magenta, brown, lightgrey, 
                darkgrey, lightblue, lightgreen, lightcyan, lightred, 

                black, blue, green, cyan, red, magenta, brown, lightgrey,
                darkgrey, lightblue, lightgreen, lightcyan, lightred,

        Can be used to change individual characters in a specific 
        character set (the character set used for display is determined 
        by the char_set option). The syntax is the same for all of 

        Can be used to change individual characters in a specific
        character set (the character set used for display is determined
        by the char_set option). The syntax is the same for all of

           wall, wall_magic, floor, floor_magic, door_open, door_closed, 
           trap, stairs_down, stairs_up, altar, arch, fountain, wavy, 

           wall, wall_magic, floor, floor_magic, door_open, door_closed,
           trap, stairs_down, stairs_up, altar, arch, fountain, wavy,

           item_armour, item_wand, item_food, item_scroll, item_ring, 
           item_potion, item_missile, item_book, item_stave, 

           item_armour, item_wand, item_food, item_scroll, item_ring,
           item_potion, item_missile, item_book, item_stave,

        magic-mapped squares on the level map. "invis_exposed" is the 
        character for water creatures submerged in shallow water, or 

        magic-mapped squares on the level map. "invis_exposed" is the
        character for water creatures submerged in shallow water, or

        Symbols can be specified using a letter, or by a number (decimal 

        Symbols can be specified using a letter, or by a number (decimal

        shows walls as solid blocks, shops and portals as '0', and water 

        shows walls as solid blocks, shops and portals as '0', and water

        where <regex> is a regular expression describing a dungeon 
        feature. This regex should match the description when using the 
        'x' command. In case the regex matches several descriptions, all 

        where <regex> is a regular expression describing a dungeon
        feature. This regex should match the description when using the
        'x' command. In case the regex matches several descriptions, all

        The list in {...} specifies the appearance of the dungeon 
        feature(s), and should be self-explanatory. <symbol> can be used 

        The list in {...} specifies the appearance of the dungeon
        feature(s), and should be self-explanatory. <symbol> can be used

        'magic' always refers to magic mapping. So the <magicmap symbol> 
        entry determines what symbol will be used for features only 

        'magic' always refers to magic mapping. So the <magicmap symbol>
        entry determines what symbol will be used for features only

        Leading parameters in the {...} list can be omitted by leaving 
        them blank and using placeholder commas. Trailing parameters can 

        Leading parameters in the {...} list can be omitted by leaving
        them blank and using placeholder commas. Trailing parameters can

        Multiple feature option lines can be used, as can multiple 
        feature descriptions strung together on the same line separated 

        Multiple feature option lines can be used, as can multiple
        feature descriptions strung together on the same line separated

        You can customise symbols based on monster names or their 
        existing symbols. For instance, if you want to put elves on E 

        You can customise symbols based on monster names or their
        existing symbols. For instance, if you want to put elves on E

        high-intensity background colours, set this option to true for 
        superior friend-branding. If your console doesn't like this 
        option, some friendly monsters will appear as blinking 

        high-intensity background colours, set this option to true for
        superior friend-branding. If your console doesn't like this
        option, some friendly monsters will appear as blinking

        Sets the default background colour by name (defaults to BLACK). 
        This may be useful if you're using a terminal with a background 
        colour other than black (such as an xterm), but this option is 

        Sets the default background colour by name (defaults to BLACK).
        This may be useful if you're using a terminal with a background
        colour other than black (such as an xterm), but this option is

        targeting screens instead of relying on the term to draw the 
        cursor. Use this if your term cannot show a cursor over 

        targeting screens instead of relying on the term to draw the
        cursor. Use this if your term cannot show a cursor over

{ Possibly multi-line 

{ Possibly multi-line

Code {}, it is executed right away.  Other Lua code is executed only 

Code {}, it is executed right away.  Other Lua code is executed only

< 

<