format_man.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2006-2026, Knut Reinert & Freie Universität Berlin
// SPDX-FileCopyrightText: 2016-2026, Knut Reinert & MPI für molekulare Genetik
// SPDX-License-Identifier: BSD-3-Clause
 
#pragma once
 
#include <sharg/detail/format_base.hpp>
 
namespace sharg::detail
{
 
class format_man : public format_help_base<format_man>
{
    using base_type = format_help_base<format_man>;
 
    friend base_type;
 
public:
    format_man() = default;                                  
    format_man(format_man const & pf) = default;             
    format_man & operator=(format_man const & pf) = default; 
    format_man(format_man &&) = default;                     
    format_man & operator=(format_man &&) = default;         
    ~format_man() = default;                                 
 
    format_man(std::vector<std::string> const & names,
               update_notifications const version_updates,
               bool const advanced = false) :
        base_type{names, version_updates, advanced} {};
 
private:
    void print_header()
    {
        std::cout << ".TH ";
        print_as_uppercase(meta.app_name);
        std::cout << ' ' << meta.man_page_section << " \"" << meta.date << "\" \"";
        print_as_lowercase(meta.app_name);
        std::cout << ' ' << meta.version << "\" \"" << meta.man_page_title << "\"\n";
 
        std::cout << ".SH NAME\n";
        print_as_lowercase(meta.app_name);
        std::cout << " \\- " << meta.short_description << '\n';
    }
 
    void print_section(std::string const & title)
    {
        std::cout << ".SH ";
        print_as_uppercase(title);
        std::cout << '\n';
        is_first_in_section = true;
    }
 
    void print_subsection(std::string const & title)
    {
        std::cout << ".SS " << title << '\n';
        is_first_in_section = true;
    }
 
    void print_line(std::string const & text, bool const line_is_paragraph)
    {
        if (!is_first_in_section && line_is_paragraph)
            std::cout << ".sp\n";
        else if (!is_first_in_section && !line_is_paragraph)
            std::cout << ".br\n";
 
        std::cout << text << '\n';
        is_first_in_section = false;
    }
 
    void print_list_item(std::string const & term, std::string const & desc)
    {
        std::cout << ".TP\n" << term << '\n' << desc << '\n';
        is_first_in_section = false;
    }
 
    void print_footer()
    {
        // no footer
    }
 
    std::string in_bold(std::string const & str)
    {
        return "\\fB" + str + "\\fR";
    }
 
    bool is_first_in_section{true};
};
 
} // namespace sharg::detail