sharg 1.0.0
THE argument parser for bio-c++ tools.
auxiliary.hpp
Go to the documentation of this file.
1// --------------------------------------------------------------------------------------------------------
2// Copyright (c) 2006-2022, Knut Reinert & Freie Universität Berlin
3// Copyright (c) 2016-2022, Knut Reinert & MPI für molekulare Genetik
4// This file may be used, modified and/or redistributed under the terms of the 3-clause BSD-License
5// shipped with this file and also available at: https://github.com/seqan/sharg-parser/blob/main/LICENSE.md
6// --------------------------------------------------------------------------------------------------------
7
13#pragma once
14
15#include <string>
16#include <vector>
17
18#include <sharg/platform.hpp>
19
20namespace sharg
21{
22
29{
30 on,
31 off
32};
33
47struct parser_meta_data // holds all meta information
48{
55
58
61
64
67
72
75
78
83
86
91
93 unsigned man_page_section{1};
94
101
106
112};
113
114} // namespace sharg
update_notifications
Indicates whether application allows automatic update notifications by the sharg::parser.
Definition: auxiliary.hpp:29
@ off
Automatic update notifications should be disabled.
@ on
Automatic update notifications should be enabled.
Provides platform and dependency checks.
Stores all parser related meta information of the sharg::parser.
Definition: auxiliary.hpp:48
std::string email
The author's e-mail address for correspondence.
Definition: auxiliary.hpp:66
std::vector< std::string > description
A more detailed description that is displayed on the help page in the section "DESCRIPTION"....
Definition: auxiliary.hpp:100
std::vector< std::string > examples
Provide some examples on how to use your tool and what standard parameters might be appropriate in di...
Definition: auxiliary.hpp:111
std::string short_description
A short description of the application (e.g. "A tool for mapping reads to the genome").
Definition: auxiliary.hpp:60
std::string app_name
The application name that will be displayed on the help page.
Definition: auxiliary.hpp:54
std::string version
The version information MAJOR.MINOR.PATH (e.g. 3.1.3)
Definition: auxiliary.hpp:57
std::vector< std::string > synopsis
Add lines of usage to the synopsis section of the help page (e.g. "./my_read_mapper [OPTIONS] FILE1 F...
Definition: auxiliary.hpp:105
std::string man_page_title
The title of your man page when exported by specifying "--export-help man" on the common line.
Definition: auxiliary.hpp:90
std::string long_copyright
Detailed copyright information that will be displayed when the user specifies "--copyright" on the co...
Definition: auxiliary.hpp:82
std::string url
A link to your github/gitlab project with the newest release.
Definition: auxiliary.hpp:74
std::string short_copyright
Brief copyright (and/or license) information.
Definition: auxiliary.hpp:77
std::string date
The date that the application was last updated. Keep this updated, ! since it will tell your users th...
Definition: auxiliary.hpp:71
std::string author
Your name ;-)
Definition: auxiliary.hpp:63
unsigned man_page_section
The man page section info (type man man on the command line for more information).
Definition: auxiliary.hpp:93
std::string citation
How users shall cite your application.
Definition: auxiliary.hpp:85