1bdep-clean(1) General Commands Manual bdep-clean(1)
2
6 bdep-clean - clean project in build configurations
7
9 bdep clean [options] [pkg-spec] [cfg-spec] [cfg-var...]
10 cfg-spec = (@cfg-name | --config|-c cfg-dir)... | --all|-a
12 pkg-spec = (--directory|-d pkg-dir)... | prj-spec
13 prj-spec = --directory|-d prj-dir
14
16 The clean command cleans the project packages in one or more build con‐
17 figurations. Additionally, immediate or all dependencies of the project
18 packages can be cleaned by specifying the --immediate|-i or --recur‐
19 sive|-r options, respectively.
20 Underneath clean executes the bpkg-pkg-clean(1) command which itself is
22 not much more than the build system clean operation (see b(1) for de‐
23 tails). As a result, the main utility of this command is the ability to
24 refer to build configurations by names and to project packages implic‐
25 itly via the current working directory as well as to clean dependen‐
26 cies.
27 If no project or package directory is specified, then the current work‐
29 ing directory is assumed. If no configuration is specified, then the
30 default configurations are assumed. See bdep-projects-configs(1) for
31 details on specifying projects and configurations. Optional cfg-var...
32 are the additional configuration variables to pass to the build system.
33
35 --immediate|-i
36 Also clean immediate dependencies.
37 --recursive|-r
39 Also clean all dependencies, recursively.
40 --all|-a
42 Use all build configurations.
43 --config|-c dir
45 Specify the build configuration as a directory.
46 --directory|-d dir
48 Assume project/package is in the specified directory rather than
49 in the current working directory.
50 --config-name|-n name
52 Specify the build configuration as a name.
53 --config-id num
55 Specify the build configuration as an id.
56
58 The common options are summarized below with a more detailed descrip‐
59 tion available in bdep-common-options(1).
60 -v Print essential underlying commands being executed.
62 -V Print all underlying commands being executed.
64 --quiet|-q
66 Run quietly, only printing error messages.
67 --verbose level
69 Set the diagnostics verbosity to level between 0 and 6.
70 --jobs|-j num
72 Number of jobs to perform in parallel.
73 --no-progress
75 Suppress progress indicators for long-lasting operations, such
76 as network transfers, building, etc.
77 --bpkg path
79 The package manager program to be used for build configuration
80 management.
81 --bpkg-option opt
83 Additional option to be passed to the package manager program.
84 --build path
86 The build program to be used to build packages.
87 --build-option opt
89 Additional option to be passed to the build program.
90 --curl path
92 The curl program to be used for network operations.
93 --curl-option opt
95 Additional option to be passed to the curl program.
96 --pager path
98 The pager program to be used to show long text.
99 --pager-option opt
101 Additional option to be passed to the pager program.
102 --options-file file
104 Read additional options from file.
105 --default-options dir
107 The directory to load additional default options files from.
108 --no-default-options
110 Don't load default options files.
111
113 See bdep-default-options-files(1) for an overview of the default op‐
114 tions files. For the clean command the search start directory is the
115 project directory. The following options files are searched for in each
116 directory and, if found, loaded in the order listed:
117 bdep.options
119 bdep-clean.options
120 The following clean command options cannot be specified in the default
122 options files:
123 --directory|-d
125
127 Send bug reports to the users@build2.org mailing list.
128
130 Copyright (c) 2014-2021 the build2 authors.
131 Permission is granted to copy, distribute and/or modify this document
133 under the terms of the MIT License.
134bdep 0.14.0 October 2021 bdep-clean(1)