1bdep-clean(1)               General Commands Manual              bdep-clean(1)
2
3
4

NAME

6       bdep-clean - clean project in build configurations
7

SYNOPSIS

9       bdep clean [options] [pkg-spec] [cfg-spec] [cfg-var...]
10
11       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

DESCRIPTION

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
23       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

CLEAN OPTIONS

30       --all|-a
31              Use all build configurations.
32
33       --config|-c dir
34              Specify the build configuration as a directory.
35
36       --directory|-d dir
37              Assume project/package is in the specified directory rather than
38              in the current working directory.
39
40       --config-name|-n name
41              Specify the build configuration as a name.
42
43       --config-id num
44              Specify the build configuration as an id.
45

COMMON OPTIONS

47       The  common  options are summarized below with a more detailed descrip‐
48       tion available in bdep-common-options(1).
49
50       -v     Print essential underlying commands being executed.
51
52       -V     Print all underlying commands being executed.
53
54       --quiet|-q
55              Run quietly, only printing error messages.
56
57       --verbose level
58              Set the diagnostics verbosity to level between 0 and 6.
59
60       --jobs|-j num
61              Number of jobs to perform in parallel.
62
63       --no-progress
64              Suppress progress indicators for long-lasting  operations,  such
65              as network transfers, building, etc.
66
67       --bpkg path
68              The  package  manager program to be used for build configuration
69              management.
70
71       --bpkg-option opt
72              Additional option to be passed to the package manager program.
73
74       --build path
75              The build program to be used to build packages.
76
77       --build-option opt
78              Additional option to be passed to the build program.
79
80       --curl path
81              The curl program to be used for network operations.
82
83       --curl-option opt
84              Additional option to be passed to the curl program.
85
86       --pager path
87              The pager program to be used to show long text.
88
89       --pager-option opt
90              Additional option to be passed to the pager program.
91
92       --options-file file
93              Read additional options from file.
94
95       --default-options dir
96              The directory to load additional default options files from.
97
98       --no-default-options
99              Don't load default options files.
100

DEFAULT OPTIONS FILES

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
107       bdep.options
108       bdep-clean.options
109
110       The  following clean command options cannot be specified in the default
111       options files:
112
113       --directory|-d
114

BUGS

116       Send bug reports to the users@build2.org mailing list.
117
119       Copyright (c) 2014-2020 the build2 authors.
120
121       Permission is granted to copy, distribute and/or modify  this  document
122       under the terms of the MIT License.
123
124
125
126bdep 0.13.0                        July 2020                     bdep-clean(1)
Impressum