blob: 938c55473781b2e6b427d14641804d254db62e50 (
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
|
// file : libbuild2/build/script/builtin.cli
// license : MIT; see accompanying LICENSE file
include <libbuild2/types.hxx>;
// Note that options in this file are undocumented because we generate neither
// the usage printing code nor man pages. Instead, they are documented in the
// manual.
//
namespace build2
{
namespace build
{
namespace script
{
// Pseudo-builtin options.
//
class depdb_dyndep_options
{
// Note that --byproduct, if any, must be the first option and is
// handled ad hoc, kind of as a sub-command.
//
// Note that in the future we may extend --cwd support to the non-
// byproduct mode where it will also have the `env --cwd` semantics
// (thus the matching name). Note that it will also be incompatible
// with support for generated files (and thus -I) at least in the make
// format where we use relative paths for non-existent files.
//
// Note on naming: whenever we (may) have two options, one for target
// and the other for prerequisite, we omit "prerequisite" as that's
// what we extract by default and most commonly. For example:
//
// --what --what-target
// --default-type --default-target-type
//
path --file; // Read from file rather than stdin.
string --format; // Dependency format: make (default).
string --what; // Dependency kind, e.g., "header".
dir_paths --include-path|-I; // Search paths for generated files.
string --default-type; // Default prerequisite type to use
// if none could be derived from ext.
dir_path --cwd; // Builtin's working directory used
// to complete relative paths (only
// in --byproduct mode).
bool --drop-cycles; // Drop prerequisites that are also
// targets. Only use if you are sure
// such cycles are harmless, that is,
// the output is not affected by such
// prerequisites' content.
};
}
}
}
|
