#include "command.h"

        opts.push_back(
            make_stringf("press . for all items on level"));

        opts.push_back("? for help");

class stash_search_reader : public line_reader
{
public:
    stash_search_reader(char *buf, size_t sz,
                        int wcol = get_number_of_cols())
        : line_reader(buf, sz, wcol)
    {
    }
protected:
    int process_key(int ch)
    {
        if (ch == '?' && !pos)
        {
            *buffer = 0;
            return (ch);
        }
        return line_reader::process_key(ch);
    }
};

    show_stash_search_prompt();

    char buf[400];
    stash_search_reader reader(buf, sizeof buf);
    bool validline = false;
    while (true)
    {
        show_stash_search_prompt();
        int ret = reader.read_line();
        if (!ret)
        {
            validline = true;
            break;
        }
        else if (ret == '?')
        {
            show_stash_search_help();
            redraw_screen();
        }
        else
        {
            break;
        }
    }

    char buf[400];
    bool validline = 
        !cancelable_get_line(buf, sizeof buf, 80, &search_history);

    // CONSTRUCT SCOREFILE ENTRY

    // construct scorefile entry.

        path += FILE_SEPARATOR;        

        path += FILE_SEPARATOR;

std::string getHelpString(const std::string &topic);

    DB_HELP,

    SingleFileDB("speak")

    SingleFileDB("speak"),
    SingleFileDB("help")

            std::string err = "{{" + clua.error;
            err += "}}";

            std::string err = "{{" + clua.error + "}}";

static void trim_right(std::string &s)
{
    s.erase(s.find_last_not_of(" \r\t\n") + 1);
}

            trim_right(line);

            trim_string_right(line);

static std::string query_database(DBM *db, std::string key,
                                  bool canonicalise_key, bool run_lua)
{
    if (canonicalise_key)
    {
        // We have to canonicalize the key (in case the user typed it
        // in and got the case wrong.)
        lowercase(key);
    }
    
    // Query the DB.
    datum result = database_fetch(db, key);
    
    std::string str((const char *)result.dptr, result.dsize);
    if (run_lua)
        execute_embedded_lua(str);
    
    return (str);
}

    // We have to canonicalize the key (in case the user typed it
    // in and got the case wrong.)
    std::string canonical_key = key;
    lowercase(canonical_key);
    
    // Query the DB.
    datum result = database_fetch(descriptionDB, canonical_key);
    
    // Cons up a (C++) string to return.  The caller must release it.
    std::string str((const char *)result.dptr, result.dsize);

    execute_embedded_lua(str);
    return (str);

    return query_database(descriptionDB, key, true, true);

/////////////////////////////////////////////////////////////////////////////
// Help DB specific functions.

std::string getHelpString(const std::string &topic)
{
    return query_database(get_dbm(DB_HELP), topic, false, true);
}

%%%%
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 show you 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>cloak</w>         find all cloaks in the dungeon.
<w>Lair:2</w>        find everything known to be on Lair:2.
<w>Lair:[2-4]</w>    finds everything on Lair:2-4. Regexes are allowed! Note
              that Lair:[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>Lair.*axe</w> 
or
<w>axe && Lair</w>   both show all axes in the Lair.
<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 <w>stash.lua</w>, 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
init.txt, 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>.
The stash search string is case-insensitive.
<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 main screen):
<w>Esc</w> : leave level map (also Space)
<w>Dir.</w>: move cursor
<w>/ Dir.</w>, <w>Shift-Dir.</w>: move cursor far
<w>-</w>/<w>+</w> : scroll level map up/down
<w>.</w>   : travel (also <w>Enter</w> and <w>,</w> and <w>;</w>)
       (moves cursor to last travel
       destination if still on @)
<w><<</w>/<w>></w> : cycle through up/down stairs
<w>^</w>   : cycle through traps
<w>Tab</w> : cycle through shops and portals
<w>X</w>   : cycle through travel eXclusions
<w>x</w>   : change the radius of a travel exclusion
<w>W</w>   : cycle through waypoints
<w>*</w>   : cycle forward through stashes
<w>/</w>   : cycle backward through stashes
<w>_</w>   : cycle through altars
<w>Ctrl-X</w> : set travel eXclusion
<w>Ctrl-E</w> : Erase all travel exclusions
<w>Ctrl-W</w> : set Waypoint
<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.
%%%%

void show_stash_search_help();

static const char *level_map_help = 
    "<h>Level Map ('<w>X</w><h>' in main screen):\n"
    "<w>Esc</w> : leave level map (also Space)\n"
    "<w>Dir.</w>: move cursor\n"
    "<w>/ Dir.</w>, <w>Shift-Dir.</w>: move cursor far\n"
    "<w>-</w>/<w>+</w> : scroll level map up/down\n"
    "<w>.</w>   : travel (also <w>Enter</w> and <w>,</w> and <w>;</w>)\n"
    "       (moves cursor to last travel\n"
    "       destination if still on @)\n"
    "<w><<</w>/<w>></w> : cycle through up/down stairs\n"
    "<w>^</w>   : cycle through traps\n"
    "<w>Tab</w> : cycle through shops and portals\n"
    "<w>X</w>   : cycle through travel eXclusions\n"
    "<w>x</w>   : change the radius of a travel exclusion\n"
    "<w>W</w>   : cycle through waypoints\n"
    "<w>*</w>   : cycle forward through stashes\n"
    "<w>/</w>   : cycle backward through stashes\n"
    "<w>_</w>   : cycle through altars\n"
    "<w>Ctrl-X</w> : set travel eXclusion\n"
    "<w>Ctrl-E</w> : Erase all travel exclusions\n"
    "<w>Ctrl-W</w> : set Waypoint\n"
    "<w>Ctrl-C</w> : Clear level and main maps\n"
    "<w>Ctrl-F</w> : Forget level map\n";

static const char *interlevel_travel_branch_help =
    "<h>Interlevel Travel (choose a branch):\n"
    " Use the shortcut letter for a branch to select the branch for travel.\n"
    "\n"
    " Once you select a branch, you will be prompted for a depth in that\n"
    " branch (more help is available there).\n"
    "\n"
   " <w>Enter</w>  : Repeat last interlevel travel.\n"
    " <w>.</w>      : Travel to a level in the current branch.\n"
    " <w><<</w>      : Go up the nearest stairs.\n"
    " <w>></w>      : Go down the nearest stairs.\n"
    " <w>Ctrl-P</w> : Travel to a level in the branch above this one.\n"
    " <w>*</w>      : Show available waypoints (if any are set).\n"
    " <w>0</w>-<w>9</w>    : Go to the numbered waypoint.\n";
static const char *interlevel_travel_depth_help =
    "<h>Interlevel Travel (go to a specific level in the selected branch)\n"
    " Type in the level number you want to go to and hit Enter, or use:\n"
    " <w>Enter</w>  : Go to the default level.\n"
    " <w><<</w>      : Change the default to one level above the current.\n"
    " <w>></w>      : Change default to one level below the current.\n"
    " <w>-</w>/<w>p</w>    : Change default to the branch above this one.\n"
    " <w>$</w>      : Change default to deepest visited level in this branch.\n"
    " <w>^</w>      : Change default to the entrance to the current level.\n"
    "\n";

void show_specific_help( const char* help )

void show_specific_help( const std::string &help )

    show_specific_help( level_map_help );

    show_specific_help( getHelpString("level-map") );

    show_specific_help( interlevel_travel_branch_help );

    show_specific_help( getHelpString("interlevel-travel.branch.prompt") );

    show_specific_help( interlevel_travel_depth_help );

    show_specific_help( getHelpString("interlevel-travel.depth.prompt") );
}
void show_stash_search_help()
{
    show_specific_help( getHelpString("stash-search.prompt") );

            "              <w>4</w>-5-<w>6</w>"
                              "      <w>h</w>-.-<w>l</w>\n"

            "              <w>4</w>-<w>5</w>-<w>6</w>"
                    "      <w>h</w>-<w>.</w>-<w>l</w>\n"

            "or 'artefact' or 'long blades'.\n",

            "or 'artefact' or 'long blades'.\n"
            "\n"
            "For more help on searching, you can\n"
            "hit ? at the search prompt.\n",

    virtual ~line_reader();

    int process_key(int ch);

    virtual int process_key(int ch);

private:

protected:

{
}
line_reader::~line_reader()