BuildStream 2.2.0.dev3__tar.gz → 2.2.1.dev0__tar.gz

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/NEWS

@@ -1,3 +1,36 @@
+=================
+buildstream 2.2.1
+=================
+
+  o Fix parsing of keepalive time (#1916)
+
+  o Fix alias mapping when using source mirror plugins (#1918)
+
+  o Fix typing of SourceFetcher.fetch() and Source.translate_url():
+    the `alias_override` parameter should be considered opaque.
+
+  o Update documentation regarding the buildbox merge (#1919)
+
+=================
+buildstream 2.2.0
+=================
+
+  o Support Python 3.12 (#1881, #1884)
+
+  o Add suffix parameter to `Source.translate_url()` (#1899)
+
+  o Error out if a YAML mapping has duplicate keys (#1877)
+
+  o New configuration option to set the grpc keepalive time (#1879)
+
+  o Add SourceMirror plugins to allow more flexibility when defining mirrors (#1903)
+
+  o Use system-installed buildbox components over bundled ones if available (#1902)
+
+  o Support bearer authentication in DownloadableFileSource (#1911)
+
+  o Support mapping aliases from subprojects to parent project to ease mirroring (#1910)
+
 =================
 buildstream 2.1.0
 =================

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: BuildStream
-Version: 2.2.0.dev3
+Version: 2.2.1.dev0
 Summary: A framework for modelling build pipelines in YAML
 Home-page: https://buildstream.build
 Author: The Apache Software Foundation

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/doc/examples/first-project/project.conf

@@ -2,7 +2,7 @@
 name: first-project
 
 # Required BuildStream version
-min-version: 2.0
+min-version: 2.2
 
 # Subdirectory where elements are stored
 element-path: elements

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/doc/source/main_install.rst

@@ -117,26 +117,14 @@ e.g., ``~/.local/bin``.
 Build from source
 ~~~~~~~~~~~~~~~~~
 
-Each of the 4 buildbox components can be installed separately from their
-respective git repositiories, and each respository has individual install
-instructions. We recommend installing the latest release tag of each
-component.
-
-| **Buildbox-common:** See the installation section in:
-| https://gitlab.com/BuildGrid/buildbox/buildbox-common/-/blob/master/README.rst
-| (Be sure to install from the latest stable release tag.)
-
-| **Buildbox-casd:** See the installation section in:
-| https://gitlab.com/BuildGrid/buildbox/buildbox-casd/-/blob/master/README.rst \
-| (Be sure to install from the latest stable release tag.)
-
-| **Buildbox-fuse:** See
-| https://gitlab.com/BuildGrid/buildbox/buildbox-fuse/-/blob/master/INSTALL.rst
-| (Be sure to install from the latest stable release tag.)
-
-| **Buildbox-run-bublewrap:** See the installation section in:
-| https://gitlab.com/BuildGrid/buildbox/buildbox-run-bubblewrap/-/blob/master/README.rst
-| (Be sure to install from the latest stable release tag.)
+Buildbox components can be installed from their git repository.
+We recommend installing from the latest release tag.
+
+See the <"Installation" section here <https://gitlab.com/BuildGrid/buildbox/buildbox/-/blob/master/README.rst#installation>`_.
+
+Buildbox contains many components, BuildStream needs only ``buildbox-casd``,
+``buildbox-fuse`` and ``buildbox-run-bubblewrap``, which can be selected by
+passing options ``-DTOOLS=OFF -DCASD=ON -DFUSE=ON -DRUN_BUBBLEWRAP=ON`` to CMake.
 
 Finally, configure buildbox-run-bubblewrap as the default buildbox-run
 implementation::

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-artifact-checkout.1

@@ -1,4 +1,4 @@
-.TH "BST ARTIFACT CHECKOUT" "1" "2023-07-11" "" "bst artifact checkout Manual"
+.TH "BST ARTIFACT CHECKOUT" "1" "2024-04-17" "" "bst artifact checkout Manual"
 .SH NAME
 bst\-artifact\-checkout \- Checkout contents of an artifact
 .SH SYNOPSIS
@@ -7,8 +7,9 @@ bst\-artifact\-checkout \- Checkout contents of an artifact
 .SH DESCRIPTION
 Checkout contents of an artifact
 .PP
-When this command is executed from a workspace directory, the default
-is to checkout the artifact of the workspace element.
+    When this command is executed from a workspace directory, the default
+    is to checkout the artifact of the workspace element.
+    
 .SH OPTIONS
 .TP
 \fB\-f,\fP \-\-force

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-artifact-delete.1

@@ -1,4 +1,4 @@
-.TH "BST ARTIFACT DELETE" "1" "2023-07-11" "" "bst artifact delete Manual"
+.TH "BST ARTIFACT DELETE" "1" "2024-04-17" "" "bst artifact delete Manual"
 .SH NAME
 bst\-artifact\-delete \- Remove artifacts from the local cache
 .SH SYNOPSIS

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-artifact-list-contents.1

@@ -1,4 +1,4 @@
-.TH "BST ARTIFACT LIST-CONTENTS" "1" "2023-07-11" "" "bst artifact list-contents Manual"
+.TH "BST ARTIFACT LIST-CONTENTS" "1" "2024-04-17" "" "bst artifact list-contents Manual"
 .SH NAME
 bst\-artifact\-list-contents \- List the contents of an artifact
 .SH SYNOPSIS
@@ -7,8 +7,9 @@ bst\-artifact\-list-contents \- List the contents of an artifact
 .SH DESCRIPTION
 List the contents of an artifact.
 .PP
-Note that 'artifacts' can be element names, which must end in '.bst',
-or artifact references, which must be in the format `<project_name>/<element>/<key>`.
+    Note that 'artifacts' can be element names, which must end in '.bst',
+    or artifact references, which must be in the format `<project_name>/<element>/<key>`.
+    
 .SH OPTIONS
 .TP
 \fB\-l,\fP \-\-long

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-artifact-log.1

@@ -1,4 +1,4 @@
-.TH "BST ARTIFACT LOG" "1" "2023-07-11" "" "bst artifact log Manual"
+.TH "BST ARTIFACT LOG" "1" "2024-04-17" "" "bst artifact log Manual"
 .SH NAME
 bst\-artifact\-log \- Show logs of artifacts
 .SH SYNOPSIS

buildstream-2.2.1.dev0/man/bst-artifact-pull.1

@@ -0,0 +1,38 @@
+.TH "BST ARTIFACT PULL" "1" "2024-04-17" "" "bst artifact pull Manual"
+.SH NAME
+bst\-artifact\-pull \- Pull a built artifact
+.SH SYNOPSIS
+.B bst artifact pull
+[OPTIONS] [ARTIFACTS]...
+.SH DESCRIPTION
+Pull a built artifact from the configured remote artifact cache.
+.PP
+    Specifying no elements will result in pulling the default targets
+    of the project. If no default targets are configured, all project
+    elements will be pulled.
+.PP
+    When this command is executed from a workspace directory, the default
+    is to pull the workspace element.
+.PP
+    By default the artifact will be pulled one of the configured caches
+    if possible, following the usual priority order. If the `--artifact-remote`
+    flag is given, only the specified cache will be queried.
+.PP
+    Specify `--deps` to control which artifacts to pull:
+.PP
+    
+        none:  No dependencies, just the element itself
+        run:   Runtime dependencies, including the element itself
+        build: Build time dependencies, excluding the element itself
+        all:   All dependencies
+    
+.SH OPTIONS
+.TP
+\fB\-d,\fP \-\-deps [build|none|run|all]
+The dependency artifacts to pull  [default: none]
+.TP
+\fB\-\-artifact\-remote\fP REMOTE
+A remote for downloading artifacts
+.TP
+\fB\-\-ignore\-project\-artifact\-remotes\fP
+Ignore remote artifact cache servers recommended by projects

buildstream-2.2.1.dev0/man/bst-artifact-push.1

@@ -0,0 +1,38 @@
+.TH "BST ARTIFACT PUSH" "1" "2024-04-17" "" "bst artifact push Manual"
+.SH NAME
+bst\-artifact\-push \- Push a built artifact
+.SH SYNOPSIS
+.B bst artifact push
+[OPTIONS] [ARTIFACTS]...
+.SH DESCRIPTION
+Push built artifacts to a remote artifact cache, possibly pulling them first.
+.PP
+    Specifying no elements will result in pushing the default targets
+    of the project. If no default targets are configured, all project
+    elements will be pushed.
+.PP
+    When this command is executed from a workspace directory, the default
+    is to push the workspace element.
+.PP
+    If bst has been configured to include build trees on artifact pulls,
+    an attempt will be made to pull any required build trees to avoid the
+    skipping of partial artifacts being pushed.
+.PP
+    Specify `--deps` to control which artifacts to push:
+.PP
+    
+        none:  No dependencies, just the element itself
+        run:   Runtime dependencies, including the element itself
+        build: Build time dependencies, excluding the element itself
+        all:   All dependencies
+    
+.SH OPTIONS
+.TP
+\fB\-d,\fP \-\-deps [build|none|run|all]
+The dependencies to push  [default: none]
+.TP
+\fB\-\-artifact\-remote\fP REMOTE
+A remote for uploading artifacts
+.TP
+\fB\-\-ignore\-project\-artifact\-remotes\fP
+Ignore remote artifact cache servers recommended by projects

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-artifact-show.1

@@ -1,4 +1,4 @@
-.TH "BST ARTIFACT SHOW" "1" "2023-07-11" "" "bst artifact show Manual"
+.TH "BST ARTIFACT SHOW" "1" "2024-04-17" "" "bst artifact show Manual"
 .SH NAME
 bst\-artifact\-show \- Show the cached state of artifacts
 .SH SYNOPSIS

buildstream-2.2.1.dev0/man/bst-artifact.1

@@ -0,0 +1,66 @@
+.TH "BST ARTIFACT" "1" "2024-04-17" "" "bst artifact Manual"
+.SH NAME
+bst\-artifact \- Manipulate cached artifacts.
+.SH SYNOPSIS
+.B bst artifact
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+Manipulate cached artifacts
+.PP
+    Some subcommands take artifact references as arguments. Artifacts
+    can be specified in two ways:
+.PP
+    
+    - artifact refs: triples of the form <project name>/<element name>/<cache key>
+    - element names
+.PP
+    When elements are given, the artifact is looked up by observing the element
+    and it's current cache key.
+.PP
+    The commands also support shell-style wildcard expansion: `?` matches a
+    single character, `*` matches zero or more characters but does not match the `/`
+    path separator, and `**` matches zero or more characters including `/` path separators.
+.PP
+    If the wildcard expression ends with `.bst`, then it will be used to search
+    element names found in the project, otherwise, it will be used to search artifacts
+    that are present in the local artifact cache.
+.PP
+    Some example arguments are:
+.PP
+    
+    - `myproject/hello/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f`
+    - `myproject/he*/827637*`
+    - `core/*.bst` (all elements in the core directory)
+    - `**.bst` (all elements)
+    - `myproject/**` (all artifacts from myproject)
+    - `myproject/myelement/*` (all cached artifacts for a specific element)
+    
+.SH COMMANDS
+.PP
+\fBshow\fP
+  Show the cached state of artifacts
+  See \fBbst artifact-show(1)\fP for full documentation on the \fBshow\fP command.
+.PP
+\fBcheckout\fP
+  Checkout contents of an artifact
+  See \fBbst artifact-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
+.PP
+\fBpull\fP
+  Pull a built artifact
+  See \fBbst artifact-pull(1)\fP for full documentation on the \fBpull\fP command.
+.PP
+\fBpush\fP
+  Push a built artifact
+  See \fBbst artifact-push(1)\fP for full documentation on the \fBpush\fP command.
+.PP
+\fBlog\fP
+  Show logs of artifacts
+  See \fBbst artifact-log(1)\fP for full documentation on the \fBlog\fP command.
+.PP
+\fBlist-contents\fP
+  List the contents of an artifact
+  See \fBbst artifact-list-contents(1)\fP for full documentation on the \fBlist-contents\fP command.
+.PP
+\fBdelete\fP
+  Remove artifacts from the local cache
+  See \fBbst artifact-delete(1)\fP for full documentation on the \fBdelete\fP command.

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-build.1

@@ -1,4 +1,4 @@
-.TH "BST BUILD" "1" "2023-07-11" "" "bst build Manual"
+.TH "BST BUILD" "1" "2024-04-17" "" "bst build Manual"
 .SH NAME
 bst\-build \- Build elements in a pipeline
 .SH SYNOPSIS
@@ -7,22 +7,23 @@ bst\-build \- Build elements in a pipeline
 .SH DESCRIPTION
 Build elements in a pipeline
 .PP
-Specifying no elements will result in building the default targets
-of the project. If no default targets are configured, all project
-elements will be built.
+    Specifying no elements will result in building the default targets
+    of the project. If no default targets are configured, all project
+    elements will be built.
 .PP
-When this command is executed from a workspace directory, the default
-is to build the workspace element.
+    When this command is executed from a workspace directory, the default
+    is to build the workspace element.
 .PP
-Specify `--deps` to control which dependencies must be built:
+    Specify `--deps` to control which dependencies must be built:
 .PP
-
-    none:  No dependencies, just the element itself
-    build: Build time dependencies, excluding the element itself
-    all:   All dependencies
+    
+        none:  No dependencies, just the element itself
+        build: Build time dependencies, excluding the element itself
+        all:   All dependencies
 .PP
-Dependencies that are consequently required to build the requested
-elements will be built on demand.
+    Dependencies that are consequently required to build the requested
+    elements will be built on demand.
+    
 .SH OPTIONS
 .TP
 \fB\-d,\fP \-\-deps [none|build|all]

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-help.1

@@ -1,4 +1,4 @@
-.TH "BST HELP" "1" "2023-07-11" "" "bst help Manual"
+.TH "BST HELP" "1" "2024-04-17" "" "bst help Manual"
 .SH NAME
 bst\-help \- Print usage information
 .SH SYNOPSIS

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-init.1

@@ -1,4 +1,4 @@
-.TH "BST INIT" "1" "2023-07-11" "" "bst init Manual"
+.TH "BST INIT" "1" "2024-04-17" "" "bst init Manual"
 .SH NAME
 bst\-init \- Initialize a new BuildStream project
 .SH SYNOPSIS
@@ -7,18 +7,19 @@ bst\-init \- Initialize a new BuildStream project
 .SH DESCRIPTION
 Initialize a new BuildStream project
 .PP
-Creates a new BuildStream project.conf in the project
-directory.
+    Creates a new BuildStream project.conf in the project
+    directory.
 .PP
-Unless `--project-name` is specified, this will be an
-interactive session.
+    Unless `--project-name` is specified, this will be an
+    interactive session.
+    
 .SH OPTIONS
 .TP
 \fB\-\-project\-name\fP TEXT
 The project name to use
 .TP
 \fB\-\-min\-version\fP TEXT
-The required format version  [default: 2.0]
+The required format version  [default: 2.2]
 .TP
 \fB\-\-element\-path\fP PATH
 The subdirectory to store elements in  [default: elements]

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-shell.1

@@ -1,4 +1,4 @@
-.TH "BST SHELL" "1" "2023-07-11" "" "bst shell Manual"
+.TH "BST SHELL" "1" "2024-04-17" "" "bst shell Manual"
 .SH NAME
 bst\-shell \- Shell into an element's sandbox environment
 .SH SYNOPSIS
@@ -7,24 +7,25 @@ bst\-shell \- Shell into an element's sandbox environment
 .SH DESCRIPTION
 Run a command in the target element's sandbox environment
 .PP
-When this command is executed from a workspace directory, the default
-is to shell into the workspace element.
+    When this command is executed from a workspace directory, the default
+    is to shell into the workspace element.
 .PP
-This will stage a temporary sysroot for running the target
-element, assuming it has already been built and all required
-artifacts are in the local cache.
+    This will stage a temporary sysroot for running the target
+    element, assuming it has already been built and all required
+    artifacts are in the local cache.
 .PP
-Use '--' to separate a command from the options to bst,
-otherwise bst may respond to them instead. e.g.
+    Use '--' to separate a command from the options to bst,
+    otherwise bst may respond to them instead. e.g.
 .PP
-
-    bst shell example.bst -- df -h
+    
+        bst shell example.bst -- df -h
 .PP
-Use the --build option to create a temporary sysroot for
-building the element instead.
+    Use the --build option to create a temporary sysroot for
+    building the element instead.
 .PP
-If no COMMAND is specified, the default is to attempt
-to run an interactive shell.
+    If no COMMAND is specified, the default is to attempt
+    to run an interactive shell.
+    
 .SH OPTIONS
 .TP
 \fB\-b,\fP \-\-build

buildstream-2.2.1.dev0/man/bst-show.1

@@ -0,0 +1,74 @@
+.TH "BST SHOW" "1" "2024-04-17" "" "bst show Manual"
+.SH NAME
+bst\-show \- Show elements in the pipeline
+.SH SYNOPSIS
+.B bst show
+[OPTIONS] [ELEMENTS]...
+.SH DESCRIPTION
+Show elements in the pipeline
+.PP
+    Specifying no elements will result in showing the default targets
+    of the project. If no default targets are configured, all project
+    elements will be shown.
+.PP
+    When this command is executed from a workspace directory, the default
+    is to show the workspace element.
+.PP
+    By default this will show all of the dependencies of the
+    specified target element.
+.PP
+    Specify ``--deps`` to control which elements to show:
+.PP
+    
+        none:  No dependencies, just the element itself
+        run:   Runtime dependencies, including the element itself
+        build: Build time dependencies, excluding the element itself
+        all:   All dependencies
+.PP
+    **FORMAT**
+.PP
+    The ``--format`` option controls what should be printed for each element,
+    the following symbols can be used in the format string:
+.PP
+    
+        %{name}           The element name
+        %{key}            The abbreviated cache key (if all sources are consistent)
+        %{full-key}       The full cache key (if all sources are consistent)
+        %{state}          cached, buildable, waiting, inconsistent or junction
+        %{config}         The element configuration
+        %{vars}           Variable configuration
+        %{env}            Environment settings
+        %{public}         Public domain data
+        %{workspaced}     If the element is workspaced
+        %{workspace-dirs} A list of workspace directories
+        %{deps}           A list of all dependencies
+        %{build-deps}     A list of build dependencies
+        %{runtime-deps}   A list of runtime dependencies
+.PP
+    The value of the %{symbol} without the leading '%' character is understood
+    as a pythonic formatting string, so python formatting features apply,
+    example:
+.PP
+    
+        bst show target.bst --format \
+            'Name: %{name: ^20} Key: %{key: ^8} State: %{state}'
+.PP
+    If you want to use a newline in a format string in bash, use the '$' modifier:
+.PP
+    
+        bst show target.bst --format \
+            $'---------- %{name} ----------\n%{vars}'
+    
+.SH OPTIONS
+.TP
+\fB\-\-except\fP PATH
+Except certain dependencies
+.TP
+\fB\-d,\fP \-\-deps [none|run|build|all]
+The dependencies to show  [default: all]
+.TP
+\fB\-\-order\fP [stage|alpha]
+Staging or alphabetic ordering of dependencies  [default: stage]
+.TP
+\fB\-f,\fP \-\-format FORMAT
+Format string for each element

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-source-checkout.1

@@ -1,4 +1,4 @@
-.TH "BST SOURCE CHECKOUT" "1" "2023-07-11" "" "bst source checkout Manual"
+.TH "BST SOURCE CHECKOUT" "1" "2024-04-17" "" "bst source checkout Manual"
 .SH NAME
 bst\-source\-checkout \- Checkout sources of an element
 .SH SYNOPSIS
@@ -7,8 +7,9 @@ bst\-source\-checkout \- Checkout sources of an element
 .SH DESCRIPTION
 Checkout sources of an element to the specified location
 .PP
-When this command is executed from a workspace directory, the default
-is to checkout the sources of the workspace element.
+    When this command is executed from a workspace directory, the default
+    is to checkout the sources of the workspace element.
+    
 .SH OPTIONS
 .TP
 \fB\-f,\fP \-\-force

buildstream-2.2.1.dev0/man/bst-source-fetch.1

@@ -0,0 +1,40 @@
+.TH "BST SOURCE FETCH" "1" "2024-04-17" "" "bst source fetch Manual"
+.SH NAME
+bst\-source\-fetch \- Fetch sources in a pipeline
+.SH SYNOPSIS
+.B bst source fetch
+[OPTIONS] [ELEMENTS]...
+.SH DESCRIPTION
+Fetch sources required to build the pipeline
+.PP
+    Specifying no elements will result in fetching the default targets
+    of the project. If no default targets are configured, all project
+    elements will be fetched.
+.PP
+    When this command is executed from a workspace directory, the default
+    is to fetch the workspace element.
+.PP
+    By default this will only try to fetch sources for the specified
+    elements.
+.PP
+    Specify `--deps` to control which sources to fetch:
+.PP
+    
+        none:  No dependencies, just the element itself
+        run:   Runtime dependencies, including the element itself
+        build: Build time dependencies, excluding the element itself
+        all:   All dependencies
+    
+.SH OPTIONS
+.TP
+\fB\-\-except\fP PATH
+Except certain dependencies from fetching
+.TP
+\fB\-d,\fP \-\-deps [none|build|run|all]
+The dependencies to fetch  [default: none]
+.TP
+\fB\-\-source\-remote\fP REMOTE
+A remote for downloading sources
+.TP
+\fB\-\-ignore\-project\-source\-remotes\fP
+Ignore remote source cache servers recommended by projects

buildstream-2.2.1.dev0/man/bst-source-push.1

@@ -0,0 +1,40 @@
+.TH "BST SOURCE PUSH" "1" "2024-04-17" "" "bst source push Manual"
+.SH NAME
+bst\-source\-push \- Push sources in a pipeline
+.SH SYNOPSIS
+.B bst source push
+[OPTIONS] [ELEMENTS]...
+.SH DESCRIPTION
+Push sources required to build the pipeline
+.PP
+    Specifying no elements will result in pushing the sources of the default
+    targets of the project. If no default targets are configured, sources of
+    all project elements will be pushed.
+.PP
+    When this command is executed from a workspace directory, the default
+    is to push the sources of the workspace element.
+.PP
+    By default this will only try to push sources for the specified
+    elements.
+.PP
+    Specify `--deps` to control which sources to fetch:
+.PP
+    
+        none:  No dependencies, just the element itself
+        run:   Runtime dependencies, including the element itself
+        build: Build time dependencies, excluding the element itself
+        all:   All dependencies
+    
+.SH OPTIONS
+.TP
+\fB\-\-except\fP PATH
+Except certain dependencies from pushing
+.TP
+\fB\-d,\fP \-\-deps [none|build|run|all]
+The dependencies to push  [default: none]
+.TP
+\fB\-\-source\-remote\fP REMOTE
+A remote for uploading sources
+.TP
+\fB\-\-ignore\-project\-source\-remotes\fP
+Ignore remote source cache servers recommended by projects

buildstream-2.2.1.dev0/man/bst-source-track.1

@@ -0,0 +1,38 @@
+.TH "BST SOURCE TRACK" "1" "2024-04-17" "" "bst source track Manual"
+.SH NAME
+bst\-source\-track \- Track new source references
+.SH SYNOPSIS
+.B bst source track
+[OPTIONS] [ELEMENTS]...
+.SH DESCRIPTION
+Consults the specified tracking branches for new versions available
+    to build and updates the project with any newly available references.
+.PP
+    Specifying no elements will result in tracking the default targets
+    of the project. If no default targets are configured, all project
+    elements will be tracked.
+.PP
+    When this command is executed from a workspace directory, the default
+    is to track the workspace element.
+.PP
+    If no default is declared, all elements in the project will be tracked
+.PP
+    By default this will track just the specified element, but you can also
+    update a whole tree of dependencies in one go.
+.PP
+    Specify `--deps` to control which sources to track:
+.PP
+    
+        none:  No dependencies, just the specified elements
+        all:   All dependencies of all specified elements
+    
+.SH OPTIONS
+.TP
+\fB\-\-except\fP PATH
+Except certain dependencies from tracking
+.TP
+\fB\-d,\fP \-\-deps [build|run|all|none]
+The dependencies to track  [default: none]
+.TP
+\fB\-J,\fP \-\-cross\-junctions
+Allow crossing junction boundaries

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-source.1

@@ -1,4 +1,4 @@
-.TH "BST SOURCE" "1" "2023-07-11" "" "bst source Manual"
+.TH "BST SOURCE" "1" "2024-04-17" "" "bst source Manual"
 .SH NAME
 bst\-source \- Manipulate sources for an element
 .SH SYNOPSIS

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-workspace-close.1

@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE CLOSE" "1" "2023-07-11" "" "bst workspace close Manual"
+.TH "BST WORKSPACE CLOSE" "1" "2024-04-17" "" "bst workspace close Manual"
 .SH NAME
 bst\-workspace\-close \- Close workspaces
 .SH SYNOPSIS

{buildstream-2.2.0.dev3 → buildstream-2.2.1.dev0}/man/bst-workspace-list.1

@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE LIST" "1" "2023-07-11" "" "bst workspace list Manual"
+.TH "BST WORKSPACE LIST" "1" "2024-04-17" "" "bst workspace list Manual"
 .SH NAME
 bst\-workspace\-list \- List open workspaces
 .SH SYNOPSIS