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. Underneath it executes the bpkg-pkg-clean(1) command which
18 itself is not much more than the build system clean operation (see b(1)
19 for details). As a result, the main utility of this command is the
20 ability to refer to build configurations by names and to project pack‐
21 ages implicitly via the current working directory.
22 If no project or package directory is specified, then the current work‐
24 ing directory is assumed. If no configuration is specified, then the
25 default configuration is assumed. See bdep-projects-configs(1) for
26 details on specifying projects and configurations. Optional cfg-var...
27 are the additional configuration variables to pass to the build system.
28
30 --all|-a
31 Use all build configurations.
32 --config|-c dir
34 Specify the build configuration as a directory.
35 --directory|-d dir
37 Assume project/package is in the specified directory rather than
38 in the current working directory.
39 --config-name|-n name
41 Specify the build configuration as a name.
42 --config-id num
44 Specify the build configuration as an id.
45
47 The common options are summarized below with a more detailed descrip‐
48 tion available in bdep-common-options(1).
49 -v Print essential underlying commands being executed.
51 -V Print all underlying commands being executed.
53 --quiet|-q
55 Run quietly, only printing error messages.
56 --verbose level
58 Set the diagnostics verbosity to level between 0 and 6.
59 --jobs|-j num
61 Number of jobs to perform in parallel.
62 --no-progress
64 Suppress progress indicators for long-lasting operations, such
65 as network transfers, building, etc.
66 --bpkg path
68 The package manager program to be used for build configuration
69 management.
70 --bpkg-option opt
72 Additional option to be passed to the package manager program.
73 --build path
75 The build program to be used to build packages.
76 --build-option opt
78 Additional option to be passed to the build program.
79 --curl path
81 The curl program to be used for network operations.
82 --curl-option opt
84 Additional option to be passed to the curl program.
85 --pager path
87 The pager program to be used to show long text.
88 --pager-option opt
90 Additional option to be passed to the pager program.
91 --options-file file
93 Read additional options from file.
94 --default-options dir
96 The directory to load additional default options files from.
97 --no-default-options
99 Don't load default options files.
100
102 See bdep-default-options-files(1) for an overview of the default
103 options files. For the clean command the search start directory is the
104 project directory. The following options files are searched for in each
105 directory and, if found, loaded in the order listed:
106 bdep.options
108 bdep-clean.options
109 The following clean command options cannot be specified in the default
111 options files:
112 --directory|-d
114
116 Send bug reports to the users@build2.org mailing list.
117
119 Copyright (c) 2014-2020 the build2 authors.
120 Permission is granted to copy, distribute and/or modify this document
122 under the terms of the MIT License.
123bdep 0.13.0 July 2020 bdep-clean(1)