From 813e4744038ec3a1ca8095111074c1cb2a824d83 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Thu, 19 Nov 2015 14:53:52 +0200 Subject: Implement entire page usage generation --- cli/options.cli | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'cli/options.cli') diff --git a/cli/options.cli b/cli/options.cli index 4972ba9..437f848 100644 --- a/cli/options.cli +++ b/cli/options.cli @@ -131,6 +131,30 @@ class options even if the short version is provided." }; + std::string --page-usage + { + "", + "Generate the combined usage printing code for the entire page. + Specifically, this will include all the namespace-level documentation as + well as usage for all the options classes printed in the order they are + defined in the main translation unit (documentation/classes from included + units are ignored except for base classes). + + The argument is used as a prefix to form the name of the usage + printing function. It can include the namespace qualification as well + as documentation variable expansion, for example: + + \ + --page-usage print_ # print_usage() in global namespace + --page-usage app::print_ # print_usage() in app namespace + --page-usage print_$name$_ # print_foo_usage() if name is foo + \ + + If both \cb{--long-usage} and \cb{--short-usage} options are specified, + then two functions are generated with the \cb{*short_usage()} and + \cb{*long_usage()} suffixes." + }; + std::size_t --option-length = 0 { "", -- cgit v1.1