for ( long i = 0; i < TUT_EVENTS_NUM; ++i )

    for (long i = 0; i < TUT_EVENTS_NUM; ++i)

// override init file definition for some options

// Override init file definition for some options.

    // show all items in inventory

    // Show all items in inventory.

// tutorial selection screen and choice

// Tutorial selection screen and choice.

        // choose character for tutorial game and set starting values

        // Choose character for tutorial game and set starting values.

            // activate all triggers

            // Activate all triggers.

            // store whether explore, stash search or travelling was used

            // Store whether explore, stash search or travelling was used.

            // used to compare which fighting means was used most often

            // Used to compare which fighting means was used most often.
            // XXX: Not stored across save games.

            // in this case, undo previous choices

            // In this case, undo previous choices.

      default: // use something fancy for debugging

      default:
          // Use something fancy for debugging.

// TO DO: check whether job and species are compatible...

    switch(type)

    switch (type)

      default: // use something fancy for debugging

      default:
          // Use something fancy for debugging.

// the tutorial welcome screen

// Prints the tutorial welcome screen.

// Lists all triggerable events and whether they actually were triggered
// at some point, at game start or reload.

        // break text into 2 columns where possible

        // Break text into 2 columns where possible.

        // map window (starts at 1) or message window (starts at 18)
        // FIXME: This should be done more cleanly using the crawl_view settings

        // Map window (starts at 1) or message window (starts at 18).
        // FIXME: This should be done more cleanly using the
        //        crawl_view settings!

        // Skip map and stats explanation for Tiles.

// once a tutorial character dies, offer some playing hints

// Once a tutorial character dies, offer some playing hints.

// if a character survives until Xp 7, the tutorial is declared finished

// If a character survives until Xp 7, the tutorial is declared finished

// know by now

// know by now.

// occasionally remind religious characters of sacrifices

// Occasionally remind religious characters of sacrifices.

    // when hungry, give appropriate message or at least don't suggest
    // sacrifice

    // When hungry, give appropriate message or at least don't suggest
    // sacrifice.

// occasionally remind injured characters of resting

// Occasionally remind injured characters of resting.

// Give a message if you see, pick up or inspect an item type for the
// first time.

      default: /* nothing to be done */

      default: // nothing to be done

            return true;

            return (true);

        if (obj.name(DESC_PLAIN).find("empty") != std::string::npos

        if (obj.plus2 == ZAPCOUNT_EMPTY

            return true;

            return (true);

    return false;

    return (false);

    // crude hack:
    // if the first monster is sleeping wake it
    // (highlighting is an unnecessary complication)

    // XXX: Crude hack (and doesn't really work either):
    // If the first monster is sleeping wake it
    // (highlighting is an unnecessary complication).

    // highlight item

    // Highlight item. XXX: Doesn't work, unfortunately.

// force more() to highlight this item

    // Force more() to highlight this item.

    text << "You've just converted to worshiping " << new_god_name
         << ". ";

    text << "You've just converted to worshipping <w>" << new_god_name
         << "</w>. ";

        // Xom is a special case.

            "<w>not</w> want Xom to grow bored with you.  If you've "
            "kept him amused he'll treat you like a plaything, "
            "randomly helping and harming you for his own amusement.";

                "absolutely not want this god to grow bored with you!\n"
                "If you keep Xom amused he'll treat you like a plaything, "
                "randomly helping and harming you for his own amusement; "
                "otherwise he'll treat you like a disfavoured plaything.";
        formatted_message_history(text.str(), MSGCH_TUTORIAL, 0,
                                  _get_tutorial_cols());

    text << "Your piety (divine favor) gradually decreases over time, and "
        "if it runs out " << new_god_name << " will excommunicate you "
        "and punish you.  You can prevent this, and even gain "
        "enough piety to get powers and divine gifts, by doing things "
        "to please " << new_god_name << ".  And don't panic: you "
        "start out with a decent amount of piety, so any danger of "
        "excommunication is far off.\n";

    if (is_good_god(you.religion))
    {
        // For the good gods, piety grows over them.
        text << "From now on, " << new_god_name << " will watch over you and "
                "judge your behaviour. Thus, your actions will greatly "
                "influence your piety (divine favour). If your piety runs out ";
    }
    else
    {
        text << "Your piety (divine favour) will gradually decrease over time, "
                "and if it runs out ";
    }

    text << new_god_name << " will excommunicate you and punish you. "
            "You can prevent this, however, and even gain enough piety to get "
            "powers and divine gifts, by doing things to please "
         << new_god_name << ". But don't panic: you start out with a decent "
            "amount of piety, so any danger of excommunication is far off.\n";

    // Unique/unusual piety gain methods first

    // Unique/unusual piety gain methods first.

                        "never touched) via the <w>a</w> key");

                        "never touched) via the <w>a</w> command");

                        "the <w>a</w> key");

                        "the <w>a</w> command");

    // Unusual kills

    // Unusual kills.

    text.str("");
    text << "\nYou can check your god's likes and dislikes, as well as your "
            "current standing and divine abilites, at any time by typing "
            "<w>^</w> "
#ifdef USE_TILE
            "(alternatively press <w>Control</w> while "
            "<w>right-clicking</w> on your avatar)"
#endif
            ".";
    formatted_message_history(text.str(), MSGCH_TUTORIAL, 0,
                              _get_tutorial_cols());

    // already learned about that

    // Already learned about that.

    // don't trigger twice in the same turn

    // Don't trigger twice in the same turn.

                // highlight item

                // Highlight item (if it works).

        // monsters standing on stairs

        // Is a monster blocking the view?

        text << "These ";

        text << "This ";

        // monsters standing on stairs

        // Is a monster blocking the view?

        // XXX: Branch entrace character not being colored yellow.

        // FIXME: Branch entrance character is not being colored yellow.

        text << "are the entrance to a different branch of the dungeon, "

        text << "is the entrance to a different branch of the dungeon, "

                "a single level.  They can also contain entrances to other "

                "a single level. They can also contain entrances to other "

        // monster or player standing on stairs
        if (mgrd[x][y] != NON_MONSTER || (you.x_pos == x
                                          && you.y_pos == y))

        // Monster or player standing on stairs.
        if (mgrd[x][y] != NON_MONSTER || (you.x_pos == x && you.y_pos == y))

                "<w>></w> symbol, instead of hiding the stair/hatch symbol "
                "with an item sybmol.";

                "<w>></w> symbol, instead of hiding the stair symbol with "
                "an item glyph.";

                "was a secret door.  You can actively try to find secret "

                "was a secret door. You can actively try to find secret "

                "off by them.  If you can't find any secret doors then the "
                "missing stairs are in sections of the level totally "

                "off by them. If you can't find any secret doors then the "
                "missing stairs are probably in sections of the level totally "

                "parentheses at the end of the \"Health\" line in the "
                "stat area of the window).  While you can wait it out, "
                "you'll probably want to stop it as soon as possible by "
                "drinking a potion of healing, since the longer you wait "
                "the more your maximum HP will be reduced.  Once you've "
                "stopped rotting you can restore your maximum HP to normal "
                "by drinking potions of healing and heal wounds while "
                "fully healed.";

                "parentheses).\n"
                "While you can wait it out, you'll probably want to stop "
                "rotting as soon as possible by drinking a potion of healing, "
                "since the longer you wait the more your maximum HP will be "
                "reduced.  Once you've stopped rotting you can restore your "
                "maximum HP to normal by drinking potions of healing and heal "
                "wounds while fully healed.";

            text << "\nNote that you cannot Berserk while hungry.";

            text << "\nNote that you cannot Berserk while hungry or worse.";

        // XXX: You'll only get this message if you're using auto exploration.

                    ".\n\n"
                    "When resting up on the next (deeper) level it's wise "
                    "to retreat to an up staircase or hatch so you can "
                    "retreat to the previous level if a monster wanders "
                    "across you.  Monsters can only follow you up if they're "
                    "standing right next to you, so if they're still at least "
                    "two squares away you can flee and safely rest on the "
                    "the previous level.  They'll still be there when you "
                    "go back down, though, so you'd want to go back down a "
                    "different set of stairs so they can't get the jump on "
                    "you when you return.";

                    ".\n\n";

        // to prevent this text being immediately followed by the next one

        // To prevent this text being immediately followed by the next one...

        text << "If retreating to another level, keep in mind that monsters "
                "may follow you if they're standing right next to you when "
                "you start climbing or descending the stairs. And even if "
                " you'vemanaged to shake them off, they'll still be there when "
                "you come back, though, so you'll want to use a different set "
                "of stairs when you return.";

        // FIXME: Modify the tutorial texts to be more generic concerning
        //        the gods' genders.

            {

                        "to nothing). Either you repeatedly annoyed him, "
                        "you weren't doing things that pleased him often "
                        "enough, or some combination of the two.  If you "
                        "can find an altar dedicated to " << old_god
                     << " you can re-convert and all will be well, otherwise "
                        "you'll have to weather his displeasure until his "
                        "wrath is spent.";

                        "to nothing). Maybe you repeatedly annoyed him, "
                        "or maybe you weren't doing things that pleased him "
                        "often enough, or some combination of the two.  If you "
                        "can find an altar dedicated to " << old_god;
            }

                text << "You just renounced your religion?  Are you "
                        "<w>sure</w> about that?  If you can find an "
                        "altar dedicated to " << old_god << " you can "
                        "re-convert and all will be well, otherwise you'll "
                        "have to weather his displeasure until his wrath is "
                        "spent.";

            {
                text << "If you decide that abandoning " << old_god << "wasn't "
                        "such a smart move after all, and you'd like to return "
                        "to your old faith you'll have to find an altar "
                        "dedicated to " << old_god << " where";
            }
            text << " you can re-convert and all will be well; otherwise "
                    "you'll have to weather this god's displeasure until their "
                    "divine wrath is spent.";

            {

            }

            {

                        "converting to " << new_god << " (it's only safe to "
                        "convert between gods if both of them is among the "
                        "three good gods). Unfortunately, converting back to "
                     << old_god << " will annoy " << new_god <<
                        ", so you're stuck with having to suffer the wrath "
                        "of one god or another.";

                        "converting to " << new_god << "! (It's only safe to "
                        "convert between the three good gods.) Unfortunately, "
                        "converting back to " << old_god << " will annoy "
                     << new_god << ", so you're stuck with having to suffer "
                        "the wrath of one god or another.";
            }

        text << "Uh-oh, you've wound up in the Abyss!.  The Abyss is filled "
                "with nasty monsters, you can't remember or map where you've "
                "been, and you're probably going to die. If you want to "
                "survive until you can find the exit (a flickering "
                "<w>\\</w>), keep moving, don't fight any of the "
                "monsters, and don't bother picking up any items on the "
                "ground.  If you're encumbered or overburdened then "
                "lighten up your load, and if the monsters are closing in "
                "use potions of speed to get away.  And if you can, move "

        text << "Uh-oh, you've wound up in the Abyss! The Abyss is a special "
                "place where you cannot remember or map where you've been; it "
                "is filled with nasty monsters, and you're probably going to "
                "die.\n";
        text << "You can increase your chances of survival until you can find "
                "the exit (a flickering <w>\\</w>), keep moving, don't fight "
                "any of the monsters, and don't bother picking up any items "
                "on the ground. If you're encumbered or overburdened then "
                "lighten up your load, and if the monsters are closing in, try "
                "to use items of speed to get away. And where possible, move "

                "as you'll likely miss the exist if you keep heading solely "

                "as you'll likely miss the exit if you keep heading solely "

        text << "You just miscast a spell.  If the spell casting success "

        text << "You just miscast a spell. If the spell casting success "

                "then a miscast merely means the spell not working, along "
                "with a harmless side effect.  However, for spells with a "
                "low success rate there's a chance of contaminating "
                "yourself with magical energy, plus a chance of an "
                "additional harmful side effect.  Normally this isn't a "
                "problem, since magical contamination bleeds off over time, "
                "but if you're repeatedly contaminated too often in a short"
                "amount of time you'll mutate and suffer from other ill "
                "side effects.\n\n"

                "then a miscast merely means the spell is not working, along "
                "with a harmless side effect. However, for spells with a "
                "low success rate there's a chance of contaminating yourself "
                "with magical energy, plus a chance of an additional harmful "
                "side effect. Normally this isn't a problem, since magical "
                "contamination bleeds off over time, but if you're repeatedly "
                "contaminated in a short amount of time you'll mutate or "
                "suffer from other ill side effects.\n\n"

        text << "The spell you just cast made you hungrier; you can see "
                "how hungry spells make you by entering <w>z\?!</w>.  The "
                "amount of nutrition consumed increases with the level of "
                "the spell and decreases according to your intelligence "
                "stat multiplied by your Spellcasting skill; if your "
                "intelligence and Spellcasting are high enough a spell " 
                "might not cost you any nutrition at all.";

        text << "The spell you just cast made you hungrier; you can see how "
                "hungry spells make you by entering <w>z\?!</w>. The amount of "
                "nutrition consumed increases with the level of the spell and "
                "decreases in dependence of your intelligence stat and your "
                "Spellcasting skill. If both of these are high enough a spell "
                "might even not cost you any nutrition at all.";

                "you're glowing!  You acquire magical contamination from "
                "using some powerful magics, like invisibility, haste/speed "
                "and potions of resistance.  This normally isn't a problem, "
                "since contamination slowly bleeds off on its own, but it"
                "seems that you've contaminated yourself so many time is "
                "such a short amount of time that you're in trouble. "
                "Now that you're glowing the contamination is going to "
                "mutate you, and possibly even damage you via magical "
                "storms. Additionally, glowing is going to make you much "
                "less stealthy.";

                "you're glowing! You usually acquire magical contamination "
                "from using some powerful magics, like invisibility, haste "
                "or potions of resistance. This normally isn't a problem as "
                "contamination slowly bleeds off on its own, but it seems that "
                "you've accumulated so much contamination over a short amount "
                "of time, that it can have nasty effects, such as mutate you "
                "or deal direct damage. In addition, glowing is going to make "
                "you much more noticeable.";

// aptitude information.

// aptitude information. (Toggling is still possible, of course.)

// A short explanation of Crawl's target mode
// and the most important commands.

// A short explanation of Crawl's target mode and its most important commands.

// Explains the most important commands necessary to use an item, and mentions
// special effects, etc.
// NOTE: For identified artefacts don't give all this information!
//       (The screen is likely to overflow.) Artefacts need special information
//       if they are evokable or grant resistances.
//       In any case, check whether we still have enough space for the
//       inscription prompt and answer.

            // for identified artefacts don't give all this information
            // (The screen is likely to overflow.)

                // exception: you can activate it

                    // You can activate it.

                } // or if it grants a resistance

                }

                    // It grants a resistance.

               // weapon skill used by this weapon and the best weapon skill

               // Weapon skill used by this weapon and the best weapon skill.

               // maybe this is a launching weapon

               // Maybe this is a launching weapon?

                   // then only compare with other launcher skills

                   // Then only compare with other launcher skills.

                   // compare with other melee weapons

                   // Compare with other melee weapons.

                   // maybe unarmed is better

                   // Maybe unarmed is better.

                      ostr << "\nOn second look you've been training in <w>"
                           << skill_name(best_wpskill)
                           << "</w> for a while, so maybe you should "
                              "continue training that rather than <w>"
                           << skill_name(curr_wpskill)
                           << "</w>. (Type <w>m</w> to see the skill "
                              "management screen for the actual numbers.)";
                      long_text = true;

                    ostr << "\nOn second look you've been training in <w>"
                         << skill_name(best_wpskill)
                         << "</w> for a while, so maybe you should "
                            "continue training that rather than <w>"
                         << skill_name(curr_wpskill)
                         << "</w>. (Type <w>m</w> to see the skill "
                            "management screen for the actual numbers.)";
                    long_text = true;

            if (!item_type_known(item) &&
                (is_artefact(item) || get_equip_desc( item ) != ISFLAG_NO_DESC))

            if (!item_type_known(item)
                && (is_artefact(item)
                    || get_equip_desc( item ) != ISFLAG_NO_DESC))

            if (item_known_cursed( item ) && wearable)
            {
                ostr << "\nA cursed piece of armour, once worn, cannot be "
                        "removed again until the curse has been lifted by "
                        "reading a scroll of remove curse or enchant armour.";
            }
            if (gives_resistance(item))

            if (wearable)

                ostr << "\n\nThis armour offers its wearer protection from "
                        "certain sources. For an overview of your resistances "
                        "(among other things) type <w>%</w>"

                if (item_known_cursed( item ))
                {
                    ostr << "\nA cursed piece of armour, once worn, cannot be "
                            "removed again until the curse has been lifted by "
                            "reading a scroll of remove curse or enchant "
                            "armour.";
                }
                if (gives_resistance(item))
                {
                    ostr << "\n\nThis armour offers its wearer protection from "
                            "certain sources. For an overview of your"
                            " resistances (among other things) type <w>%</w>"

                        " or click on your avatar with the <w>right mouse "
                        "button</w>"

                            " or click on your avatar with the <w>right mouse "
                            "button</w>"

                        ".";
            }
            if (is_artefact(item) && gives_ability(item))
            {
                ostr << "\nWhen worn, some types of armour (such as this one) "
                        "offer abilities that can be e<w>v</w>oked. ";
                ostr << _tut_abilities();

                            ".";
                }
                if (is_artefact(item) && gives_ability(item))
                {
                    ostr << "\nWhen worn, some types of armour (such as this "
                            "one) offer abilities that can be e<w>v</w>oked. ";
                    ostr << _tut_abilities();
                }

                if (you.religion == GOD_TROG)

                if (you.religion == GOD_TROG
                    && (item.sub_type != BOOK_DESTRUCTION
                        || !item_ident(item, ISFLAG_KNOW_TYPE)))

                else if (item.sub_type == BOOK_DESTRUCTION)
                {
                    ostr << "This magical item can cause great destruction "
                            "- to you, or your surroundings. Use with care!";
                }

#ifdef USE_TILE

#ifdef USE_TILE

                        EOL
                        "If there are several items in your inventory you'd "
                        "like to drop, the more convenient way is to use the "

                        EOL;
#endif
                ostr << "If there are several items in your inventory you'd "
                        "like to drop, the most convenient way is to use the "

                        "for <w>y</w>es, or directly chopping <w>a</w>ll "

                        "for <w>y</w>es or you can directly chop <w>a</w>ll "

#endif

                if (!gives_resist && Options.tutorial_type == TUT_BERSERK_CHAR
                                  && you.religion == GOD_TROG)

                if (!gives_resist && you.religion == GOD_TROG)

} // tutorial_describe_item

}        // tutorial_describe_item()

    // Don't print anything if there's not enough space.
    if (wherey() >= get_number_of_lines() - 1)
        return;

    // Altars and branch entrances are always interesting.

        return true;

        return (true);

        return true;

        return (true);

       case DNGN_ORCISH_IDOL:
       case DNGN_GRANITE_STATUE:
       case DNGN_TRAP_MAGICAL:
       case DNGN_TRAP_MECHANICAL:
       case DNGN_TRAP_NATURAL:
       case DNGN_STONE_STAIRS_DOWN_I:
       case DNGN_STONE_STAIRS_DOWN_II:
       case DNGN_STONE_STAIRS_DOWN_III:
       case DNGN_STONE_STAIRS_UP_I:
       case DNGN_STONE_STAIRS_UP_II:
       case DNGN_STONE_STAIRS_UP_III:
       case DNGN_ESCAPE_HATCH_DOWN:
       case DNGN_ESCAPE_HATCH_UP:
            return true;
       default:
            return false;

    // So are statues, traps, and stairs.
    case DNGN_ORCISH_IDOL:
    case DNGN_GRANITE_STATUE:
    case DNGN_TRAP_MAGICAL:
    case DNGN_TRAP_MECHANICAL:
    case DNGN_TRAP_NATURAL:
    case DNGN_STONE_STAIRS_DOWN_I:
    case DNGN_STONE_STAIRS_DOWN_II:
    case DNGN_STONE_STAIRS_DOWN_III:
    case DNGN_STONE_STAIRS_UP_I:
    case DNGN_STONE_STAIRS_UP_II:
    case DNGN_STONE_STAIRS_UP_III:
    case DNGN_ESCAPE_HATCH_DOWN:
    case DNGN_ESCAPE_HATCH_UP:
        return (true);
    default:
        return (false);

                    "as shafts, which lead one to three levels down.  They "

                    "as shafts, which lead one to three levels down. They "

                        "retreating or fidning a safe resting spot, since the "

                        "retreating or finding a safe resting spot, since the "

                else

                else if (you.religion == altar_god)

                    if (you.religion == altar_god)

                    if (god_likes_items(you.religion))

                    ostr << "If "
                         << god_name(you.religion)
                         << " likes to have items or corpses sacrificed on "
                            "altars, here you can do this by <w>d</w>ropping "
                            "them, then <w>p</w>raying. As a follower, "
                            "pressing <w>^</w> "
#ifdef USE_TILE
                            "(alternatively press <w>Control</w> while "
                            "<w>right-clicking</w> on your avatar) "
#endif
                            "allows you to check "
                         << god_name(you.religion)
                         << "'s likes and dislikes at any time, as well as "
                            "your current standing and divine abilities.";

                        ostr << "If "
                             << god_name(you.religion)
                             << " likes to have certain items or corpses "
                                "sacrificed on altars, any appropriate item "
                                "<w>d</w>ropped on an altar during prayer, or "
                                "already lying on an altar when you start "
                                "<w>p</w>raying will be automatically "
                                "sacrificed to "
                             << god_name(you.religion)
                             << ".";

                    else
                    {

                }
                else
                {

                   }

} // tutorial_describe_feature

}

    bool need_cloud = false;

        ostr << "dangerous, and you should stay out of it if you can. ";

        if (!is_damaging_cloud(ctype, true))
        {
            ostr << "currently harmless, but that could change at some point. "
                    "Check the overview screen (<w>%%</w>) to view your "
                    " resistances.";
            need_cloud = true;
        }
        else
        {
            ostr << "probably dangerous, and you should stay out of it if you "
                    "can. ";
        }

        ostr << "It is opaque.  If two or more opaque clouds are between "

    {
        ostr << (need_cloud? "\nThis cloud" : "It")
             << " is opaque. If two or more opaque clouds are between "

    }

            "under the surface of the shallow water.  Distance attacks "
            "which only hit a single target may not hit submereged monsters "
            "unless you use the <w>!</w> key to fire your ammo/spell/wand "
            "after selecting the sumberged target.";

            "under the surface of the shallow water. Other than non-submerged "
            "monsters, a submerged monster will not be autotargeted when doing "
            "a ranged attack while there are other, visible targets in sight. "
            "Of course you can still target it manually if you wish to.";

        return false;

        return (false);

        return true;

        return (true);

    // highlighted in some way

    // Highlighted in some way.

        return true;

        return (true);

    // monster is (seriously) out of depth

    // The monster is (seriously) out of depth.

        return true;

        return (true);

       int level_diff
           = mons_level(mons->type) - (you.your_level + 8);

       // 8 is the default value for the note-taking of OOD monsters.
       int level_diff = mons_level(mons->type) - (you.your_level + 8);

    // monster is highlighted

    // Monster is highlighted.

} // tutorial_describe_monster

}

    if (dc != dest && !is_travelsafe_square(dc.x, dc.y, ignore_hostile))

    if (dc == dest)
    {
        // Hallelujah, we're home!
        if (_is_safe_move(c.x, c.y))
            next_travel_move = c;
        return (true);
    }
    else if (!is_travelsafe_square(dc.x, dc.y, ignore_hostile))

    if (dc == dest)

    if (!point_distance[dc.x][dc.y])

        // Hallelujah, we're home!
        if (_is_safe_move(c.x, c.y))
            next_travel_move = c;
        return (true);
    }
    else if (!point_distance[dc.x][dc.y])
    {

bool god_likes_items(god_type god);

static bool _god_likes_items(god_type god)

bool god_likes_items(god_type god)

        return true;

        return (true);

        return false;

        return (false);

        return false;

        return (false);

    return false;

    return (false);

    if ( !_god_likes_items(god) )

    if (!god_likes_items(god))

    if (!_god_likes_items(you.religion) && i != NON_ITEM)

    if (!god_likes_items(you.religion) && i != NON_ITEM)

        case MISC_DECK_OF_ESCAPE: return "deck of escape";

        case MISC_DECK_OF_ESCAPE:      return "deck of escape";

        case MISC_DECK_OF_DUNGEONS: return "deck of dungeons";
        case MISC_DECK_OF_SUMMONING: return "deck of summonings";
        case MISC_DECK_OF_WONDERS: return "deck of wonders";
        case MISC_DECK_OF_PUNISHMENT: return "deck of punishment";
        case MISC_DECK_OF_WAR: return "deck of war";
        case MISC_DECK_OF_CHANGES: return "deck of changes";
        case MISC_DECK_OF_DEFENCE: return "deck of defence";

        case MISC_DECK_OF_DUNGEONS:    return "deck of dungeons";
        case MISC_DECK_OF_SUMMONING:   return "deck of summonings";
        case MISC_DECK_OF_WONDERS:     return "deck of wonders";
        case MISC_DECK_OF_PUNISHMENT:  return "deck of punishment";
        case MISC_DECK_OF_WAR:         return "deck of war";
        case MISC_DECK_OF_CHANGES:     return "deck of changes";
        case MISC_DECK_OF_DEFENCE:     return "deck of defence";

        case MISC_CRYSTAL_BALL_OF_ENERGY: return "crystal ball of energy";

        case MISC_CRYSTAL_BALL_OF_ENERGY:   return "crystal ball of energy";

        case MISC_CRYSTAL_BALL_OF_SEEING: return "crystal ball of seeing";
        case MISC_BOX_OF_BEASTS: return "box of beasts";
        case MISC_EMPTY_EBONY_CASKET: return "empty ebony casket";
        case MISC_AIR_ELEMENTAL_FAN: return "air elemental fan";
        case MISC_LAMP_OF_FIRE: return "lamp of fire";
        case MISC_LANTERN_OF_SHADOWS: return "lantern of shadows";
        case MISC_HORN_OF_GERYON: return "horn of Geryon";
        case MISC_DISC_OF_STORMS: return "disc of storms";

        case MISC_CRYSTAL_BALL_OF_SEEING:   return "crystal ball of seeing";
        case MISC_BOX_OF_BEASTS:            return "box of beasts";
        case MISC_EMPTY_EBONY_CASKET:       return "empty ebony casket";
        case MISC_AIR_ELEMENTAL_FAN:        return "air elemental fan";
        case MISC_LAMP_OF_FIRE:             return "lamp of fire";
        case MISC_LANTERN_OF_SHADOWS:       return "lantern of shadows";
        case MISC_HORN_OF_GERYON:           return "horn of Geryon";
        case MISC_DISC_OF_STORMS:           return "disc of storms";
        case MISC_BOTTLED_EFREET:           return "bottled efreet";

        case MISC_BOTTLED_EFREET: return "bottled efreet";

        case MISC_AIR_ELEMENTAL_FAN: return "gauzy fan";
        case MISC_LAMP_OF_FIRE: return "blazing lamp";
        case MISC_LANTERN_OF_SHADOWS: return "bone lantern";
        case MISC_HORN_OF_GERYON: return "silver horn";
        case MISC_DISC_OF_STORMS: return "grey disc";

        case MISC_AIR_ELEMENTAL_FAN:         return "gauzy fan";
        case MISC_LAMP_OF_FIRE:              return "blazing lamp";
        case MISC_LANTERN_OF_SHADOWS:        return "bone lantern";
        case MISC_HORN_OF_GERYON:            return "silver horn";
        case MISC_DISC_OF_STORMS:            return "grey disc";

        case MISC_BOTTLED_EFREET: return "sealed bronze flask";

        case MISC_BOTTLED_EFREET:            return "sealed bronze flask";

    const bool know_ego   = know_brand;

    const bool know_ego = know_brand;

    // So that know_cosmetic won't be affected by ignore_flags

    // So that know_cosmetic won't be affected by ignore_flags.

  coord_def     prev_grd_targ;

  coord_def      prev_grd_targ;

    // start with enough room for 100 80 character lines

    // Start with enough room for 100 80 character lines.