%%%%
pick-up

<h>Picking up and dropping items</h>

You will pick up and drop items very often. There are four ways to do this:

* Single items
* Category shortcuts
* Regular expressions

Note that selecting an already selected item will deselect it.


<h>Item letters</h>

Pressing an item's letter key will select the item.


<h>Regular expressions</h>

By pressing <w>Ctrl-F</w> you can enter a word (which could even be a
regular expression). All matching items will be selected.


<h>Category shortcuts</w>

You can quickly select items by type by pressing
<w>(</w>         weapons
<w>)</w>         ammunition
<w>[</w>         armour
<w>=</w> or <w>"</w>    jewellery
<w>!</w>         potions
<w>?</w>         scrolls
<w>:</w> or <w>+</w>    books
<w>/</w>         wands
<w>%</w>         food
<w>&</w>         carrion (corpses, skeletons, useless chunks)

Apart from these, there are the general shortcuts
<w>-</w>         deselect everything
<w>,</w>         select everything
<w>*</w>         invert selection

Note that for dropping, the <w>,</w> and <w>-</w> commands use the
<w>drop_filter</w> option which narrows the range of items to be (de)selected.
The default value of the option is useless items.
%%%%
stash-search.prompt

<h>Searching the stash-tracker</h>

You can search for items and dungeon features by name (or a substring of the
name). In the list of search results, you can select a search result by its
hotkey to travel to its location.

You can also examine shops and items in the search results by pressing <w>?</w> and
then hitting the hotkey for the search result. This will give a description
of the item or the contents of the shop.

Some examples of search strings:
<w>cure mutation</w> find all potions of cure mutation, including potions in shops.
<w>jell</w>          finds every single royal jelly and heaps of royal jellies
<w>Lair:2</w>        find everything known to be on Lair:2.
<w>D:[2-4]</w>       finds everything on Dungeon levels 2-4. Regexes are allowed!
              Note that D:[3-10] will not work as intended, since [x-y] is a
              regex character range.
<w>.</w>             is a shortcut to find everything on your current level.
<w>..</w>            is a shortcut for listing all items you know.
<w>Lair.*axe</w> and <w>axe && Lair</w> both show all axes in the Lair.

The stash search string is case-insensitive.


<h>Searching by item properties:</h>

You can search for spell names (such as <w>Ignite Poison</w>) to find spellbooks
or rods that contain the spell.

You can search for artefact item properties (such as <w>prevents.*teleport</w>)
to find artefacts that have the property.

If you're using stash.lua (which is the default), you can also search by
some additional item properties: <w>artefact</w> will find identified artefacts.
Skill names (such as <w>Polearms</w> or <w>Long Blades</w>) will find all weapons that
train that skill.

If you're using stash.lua and have set annotate_item_class = true in your
initfile, you can also search by item types such as <w>book</w> or <w>jewellery</w>.


<h>Finding Dungeon Features:</h>

You can search for dungeon features by name: all shops will be found by a
search for <w>shop</w> (including shops that do not have "shop" in their name);
other dungeon features can also be found by name: <w>fountain</w>, <w>axe trap</w>,
<w>altar</w>, etc. You can also search for altars by deity name: <w>Zin</w>.


<h>Non-regex operators:</h>

You can use !! to negate a search string, && for a boolean AND, || for
boolean OR, and <<<< >> for grouping.

For instance, to find rings (jewellery) but not ring mail you could use:
<w>ring && !!mail</w>
%%%%
level-map

<h>Level Map ('<w>X</w><h>' in the main screen):
<w>Esc</w>    : Leave level map (also <w>Space</w> or any unused key).
<w>Dir.</w>   : Move the cursor.
<w>Shift-Dir.</w> : Move the cursor in larger steps (7 by default).
<w>-</w>/<w>+</w>    : Scroll level map 20 grids up/down.
<w>.</w>      : Start travel (also <w>Enter</w> and <w>,</w> and <w>;</w>).
         (Moves cursor to the last travel destination if still on @.)
<w>[</w>/<w>]</w>    : Examine the next higher/lower level
<w>G</w>      : Go to another level by branch and depth

<h>Travel exclusions
<w>e</w>      : Create a travel exclusion, change its radius, or remove it.
<w>E</w>      : Cycle through travel exclusions.
<w>Ctrl-E</w> : Erase all travel exclusions on the level.

<h>Waypoints
<w>Ctrl-W</w> : Set waypoint to current position.
<w>W</w>      : Cycle through all waypoints on the level.

<h>Cycle through features
<w><<</w>/<w>></w>    : Cycle through up/down stairs.
<w>^</w>      : Cycle through traps.
<w>Tab</w>    : Cycle through shops and portals.
<w>*</w>      : Cycle forward through stashes (by default, all items).
<w>/</w>      : Cycle backward through stashes (by default, all items).
<w>_</w>      : Cycle through altars.

<h>Other
<w>Ctrl-C</w> : Clear level and main maps.
<w>Ctrl-F</w> : Forget level map.
%%%%
interlevel-travel.branch.prompt

<h>Interlevel Travel (choose a branch):
 Use the shortcut letter for a branch to select the branch for travel.

 Once you select a branch, you will be prompted for a depth in that
 branch (more help is available there).

 <w>Enter</w>  : Repeat last interlevel travel.
 <w>.</w>      : Travel to a level in the current branch.
 <w><<</w>      : Go up the nearest stairs.
 <w>></w>      : Go down the nearest stairs.
 <w>Ctrl-P</w> : Travel to a level in the branch above this one.
 <w>*</w>      : Show available waypoints (if any are set).
 <w>0</w>-<w>9</w>    : Go to the numbered waypoint.
%%%%
interlevel-travel.depth.prompt

<h>Interlevel Travel (go to a specific level in the selected branch)
 Type in the level number you want to go to and hit Enter, or use:
 <w>Enter</w>  : Go to the default level.
 <w><<</w>      : Change the default to one level above the current.
 <w>></w>      : Change default to one level below the current.
 <w>-</w>/<w>p</w>    : Change default to the branch above this one.
 <w>$</w>      : Change default to deepest visited level in this branch.
 <w>^</w>      : Change default to the entrance to the current level.
%%%%
butchering

<h>Butchering<h>
<w>y, c</w>: Butcher/bottle the selected corpse.
<w>a</w>   : Butcher/bottle this corpse and all the ones following in the stack.
      If the prompt is about bottling the blood, all bloodless corpses
      will be skipped.
<w>q</w>   : Quit the prompt (don't butcher/bottle anything).
<w>n</w>   : Don't butcher/bottle this corpse, skip to the next one.
      (This is the default behaviour if you answer with anything not
       listed here.)

<h>Notes for Tiles</h>
If you are playing with Tiles you can butcher (or bottle) a single
corpse on the ground by clicking the <w>left mouse button</w> while pressing
<w>Shift</w>.
%%%%
