void print_description( const std::string &d );

void print_description(const std::string &d, const std::string title = "",
                       const std::string suffix = "",
                       const std::string prefix = "",
                       const std::string footer = "");

static int _count_desc_lines(const std::string _desc, const int width)
{
   std::string desc = get_linebreak_string(_desc, width);

   int count = 0;
   for (int i = 0, size = desc.size(); i < size; i++)
   {
       const char ch = desc[i];
       if (ch == '\n' || ch == '$')
           count++;
   }
  return count;
}

void print_description( const std::string &d )

void print_description(const std::string &d, const std::string title,
                       const std::string suffix, const std::string prefix,
                       const std::string footer)

    const unsigned int lineWidth = get_number_of_cols()  - 1;
    const          int height    = get_number_of_lines();
    std::string desc;
    if (title.empty())
       desc = d;
    else
    {
        desc = title + "$$";
        desc += d;
    }
    int num_lines = _count_desc_lines(desc, lineWidth) + 1;
    const int suffix_lines = _count_desc_lines(suffix, lineWidth);
    const int prefix_lines = _count_desc_lines(prefix, lineWidth);
    const int footer_lines = _count_desc_lines(footer, lineWidth)
                             + (footer.empty() ? 0 : 1);
    // Prefer the footer over the suffix
    if (num_lines + suffix_lines + footer_lines <= height)
    {
        desc = desc + suffix;
        num_lines += suffix_lines;
    }
    // Prefer the footer over the prefix
    if (num_lines + prefix_lines + footer_lines <= height)
    {
        desc = prefix + desc;
        num_lines += prefix_lines;
    }
    if (!footer.empty() && num_lines + footer_lines <= height)
    {
        const int bottom_line = std::min(std::max(24, num_lines + 2),
                                         height - footer_lines + 1);
        const int newlines = bottom_line - num_lines;
        if (newlines >= 0)
        {
            desc.append(newlines, '\n');
            desc = desc + footer;
        }
    }

    const unsigned int lineWidth = get_number_of_cols() - 1;

    clrscr();

    while (currentPos < d.length())

    while (currentPos < desc.length())

        nextLine = d.find('$', currentPos);

        nextLine = desc.find('$', currentPos);

            cprintf("%s", (d.substr(currentPos, nextLine-currentPos)).c_str());

            cprintf("%s",
                    (desc.substr(currentPos, nextLine-currentPos)).c_str());

        nextLine = d.find('\n', currentPos);

        nextLine = desc.find('\n', currentPos);

            cprintf("%s", (d.substr(currentPos, nextLine-currentPos)).c_str());

            cprintf("%s",
                    (desc.substr(currentPos, nextLine-currentPos)).c_str());

        if (currentPos + lineWidth >= d.length())

        if (currentPos + lineWidth >= desc.length())

            cprintf((d.substr(currentPos)).c_str());

            cprintf((desc.substr(currentPos)).c_str());

        nextLine = d.rfind(' ', currentPos + lineWidth);

        nextLine = desc.rfind(' ', currentPos + lineWidth);

            cprintf((d.substr(currentPos, nextLine - currentPos)).c_str());

            cprintf((desc.substr(currentPos, nextLine - currentPos)).c_str());

        cprintf((d.substr(currentPos, nextLine - currentPos)).c_str());

        cprintf((desc.substr(currentPos, nextLine - currentPos)).c_str());

    clrscr();

    clrscr();

    clrscr();

    clrscr();

    clrscr();

    std::string prefix, suffix;

            desc = getLongDescription(symbol_prefix) + desc;

            prefix = getLongDescription(symbol_prefix);

            desc += getLongDescription(symbol_suffix);
            desc += getLongDescription(symbol_suffix + "_lookup");

            suffix += getLongDescription(symbol_suffix);
            suffix += getLongDescription(symbol_suffix + "_lookup");

    key += "$$";

    linebreak_string2(footer, width - 1);
    print_description(desc, key, suffix, prefix, footer);

    clrscr();
    print_description(key + desc);
    if (!footer.empty())
    {
        int num_lines = linebreak_string2(footer, width);
        num_lines++;
        // So the footer doesn't get lonely on large displays. :)
        const int bottom_line = std::min(30, get_number_of_lines());
        cgotoxy(1, bottom_line - num_lines);
        cprintf(footer.c_str());
    }