blob: ed0f58a9df4d6e53ac3b583518733f166196f496 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
// file : bpkg/help.cxx -*- C++ -*-
// license : MIT; see accompanying LICENSE file
#include <bpkg/help.hxx>
#include <libbutl/pager.hxx>
#include <bpkg/diagnostics.hxx>
#include <bpkg/bpkg-options.hxx>
// Help topics.
//
#include <bpkg/repository-signing.hxx>
#include <bpkg/repository-types.hxx>
#include <bpkg/argument-grouping.hxx>
#include <bpkg/default-options-files.hxx>
using namespace std;
using namespace butl;
namespace bpkg
{
int
help (const help_options& o, const string& t, usage_function* usage)
{
if (usage == nullptr) // Not a command.
{
if (t.empty ()) // General help.
usage = &print_bpkg_usage;
//
// Help topics.
//
else if (t == "common-options")
usage = &print_bpkg_common_options_long_usage;
else if (t == "repository-signing")
usage = &print_bpkg_repository_signing_usage;
else if (t == "repository-types")
usage = &print_bpkg_repository_types_usage;
else if (t == "argument-grouping")
usage = &print_bpkg_argument_grouping_usage;
else if (t == "default-options-files")
usage = &print_bpkg_default_options_files_usage;
else
fail << "unknown bpkg command/help topic '" << t << "'" <<
info << "run 'bpkg help' for more information";
}
try
{
pager p ("bpkg " + (t.empty () ? "help" : t),
verb >= 2,
o.pager_specified () ? &o.pager () : nullptr,
&o.pager_option ());
usage (p.stream (), cli::usage_para::none);
// If the pager failed, assume it has issued some diagnostics.
//
return p.wait () ? 0 : 1;
}
// Catch io_error as std::system_error together with the pager-specific
// exceptions.
//
catch (const system_error& e)
{
error << "pager failed: " << e;
// Fall through.
}
throw failed ();
}
}
|