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

NAME

6       bdep-update - update project in build configurations
7

SYNOPSIS

9       bdep update [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  update  command  updates the project packages in one or more build
17       configurations. Additionally, immediate  or  all  dependencies  of  the
18       project  packages  can  be  updated by specifying the --immediate|-i or
19       --recursive|-r options, respectively.
20
21       Underneath update executes the bpkg-pkg-update(1) command which  itself
22       is  not  much more than the build system update operation (see b(1) for
23       details). As a result, the main utility of this command is the  ability
24       to  refer  to build configurations by names and to project packages im‐
25       plicitly via the current working directory as well as to update  depen‐
26       dencies.
27
28       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

UPDATE OPTIONS

35       --immediate|-i
36              Also update immediate dependencies.
37
38       --recursive|-r
39              Also update all dependencies, recursively.
40
41       --all|-a
42              Use all build configurations.
43
44       --config|-c dir
45              Specify the build configuration as a directory.
46
47       --directory|-d dir
48              Assume project/package is in the specified directory rather than
49              in the current working directory.
50
51       --config-name|-n name
52              Specify the build configuration as a name.
53
54       --config-id num
55              Specify the build configuration as an id.
56

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

120       See bdep-default-options-files(1) for an overview of  the  default  op‐
121       tions  files.  For the update command the search start directory is the
122       project directory. The following options files are searched for in each
123       directory and, if found, loaded in the order listed:
124
125       bdep.options
126       bdep-update.options
127
128       The following update command options cannot be specified in the default
129       options files:
130
131       --directory|-d
132

BUGS

134       Send bug reports to the users@build2.org mailing list.
135

137       Copyright (c) 2014-2022 the build2 authors.
138
139       Permission is granted to copy, distribute and/or modify  this  document
140       under the terms of the MIT License.
141
142
143
144bdep 0.15.0                        July 2022                    bdep-update(1)
Impressum