blob: 6a2e1400f8f2bf6f4d38e4cfa71c7db99a2b7c03 (
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
74
75
76
77
78
79
80
81
82
83
84
85
|
// file : bdep/clean.cli
// license : MIT; see accompanying LICENSE file
include <bdep/project.cli>;
"\section=1"
"\name=bdep-clean"
"\summary=clean project in build configurations"
namespace bdep
{
{
"<options>
<prj-spec> <prj-dir>
<pkg-spec> <pkg-dir>
<cfg-spec> <cfg-name> <cfg-dir>
<cfg-var>",
"\h|SYNOPSIS|
\c{\b{bdep clean} [<options>] [<pkg-spec>] [<cfg-spec>] [<cfg-var>...]}
\c{<cfg-spec> = (\b{@}<cfg-name> | \b{--config}|\b{-c} <cfg-dir>)... | \b{--all}|\b{-a}\n
<pkg-spec> = (\b{--directory}|\b{-d} <pkg-dir>)... | <prj-spec>\n
<prj-spec> = \b{--directory}|\b{-d} <prj-dir>}
\h|DESCRIPTION|
The \cb{clean} command cleans the project packages in one or more build
configurations. Additionally, immediate or all dependencies of the
project packages can be cleaned by specifying the
\c{\b{--immediate}|\b{-i}} or \c{\b{--recursive}|\b{-r}} options,
respectively.
Underneath \cb{clean} executes the \l{bpkg-pkg-clean(1)} command which
itself is not much more than the build system \cb{clean} operation (see
\l{b(1)} for details). As a result, the main utility of this command is
the ability to refer to build configurations by names and to project
packages implicitly via the current working directory as well as to
clean dependencies.
If no project or package directory is specified, then the current working
directory is assumed. If no configuration is specified, then the default
configurations are assumed. See \l{bdep-projects-configs(1)} for details
on specifying projects and configurations. Optional \c{\i{cfg-var}...}
are the additional configuration variables to pass to the build system.
"
}
class cmd_clean_options: project_options
{
"\h|CLEAN OPTIONS|"
bool --immediate|-i
{
"Also clean immediate dependencies."
}
bool --recursive|-r
{
"Also clean all dependencies, recursively."
}
};
"
\h|DEFAULT OPTIONS FILES|
See \l{bdep-default-options-files(1)} for an overview of the default
options files. For the \cb{clean} command the search start directory is
the project directory. The following options files are searched for in
each directory and, if found, loaded in the order listed:
\
bdep.options
bdep-clean.options
\
The following \cb{clean} command options cannot be specified in the
default options files:
\
--directory|-d
\
"
}
|
