Function get_ability_desc

crawl-ref/source/ability.cc:1560–1625

XXX: should this be in describe.cc?

// XXX: should this be in describe.cc?
string get_ability_desc(const ability_type ability, bool need_title)
{
    const string& name = ability_name(ability, true);

    string lookup;

    if (testbits(get_ability_def(ability).flags, abflag::card))
        lookup = _nemelex_desc(ability);
    else
        lookup = getLongDescription(name + " ability");

    if (lookup.empty()) // Nothing found?
        lookup = "No description found.\n";

    switch (ability)
    {
        case ABIL_ASHENZARI_CURSE:
            lookup += _curse_desc();
            break;

        case ABIL_BEOGH_DISMISS_APOSTLE_1:
        case ABIL_BEOGH_DISMISS_APOSTLE_2:
        case ABIL_BEOGH_DISMISS_APOSTLE_3:
        {
            const int index = ability - ABIL_BEOGH_DISMISS_APOSTLE_1 + 1;
            lookup += "\n" + apostle_short_description(index) + "\n";
        }
        break;

        case ABIL_MAKHLEB_BRAND_SELF_1:
        case ABIL_MAKHLEB_BRAND_SELF_2:
        case ABIL_MAKHLEB_BRAND_SELF_3:
        {
            const mutation_type mut = makhleb_ability_to_mutation(ability);
            lookup += "\n" + get_mutation_desc(mut);
        }
        break;

        default:
        break;
    }

    if (testbits(get_ability_def(ability).flags, abflag::sacrifice))
        lookup += _sacrifice_desc(ability);

    const string damage_str = _ability_damage_string(ability);

    const string range_str = range_string(ability_range(ability));

    lookup += "\n";

    if (damage_str != "")
        lookup += make_stringf("Damage: %s\n ", damage_str.c_str());
    lookup += make_stringf("Range: %s\n", range_str.c_str());

    ostringstream res;
    if (need_title)
        res << name << "\n\n";