James Ennis pushed to branch jennis/migrate_pull_push_commands at BuildStream / buildstream
Commits:
-
ea2fbe4d
by James Ennis at 2019-01-22T13:02:14Z
28 changed files:
- + man/bst-artifact-checkout.1
- + man/bst-artifact-log.1
- + man/bst-artifact-pull.1
- + man/bst-artifact-push.1
- − man/bst-artifact-receive.1
- man/bst-artifact-server.1
- + man/bst-artifact.1
- man/bst-build.1
- man/bst-checkout.1
- man/bst-fetch.1
- man/bst-help.1
- man/bst-init.1
- man/bst-pull.1
- man/bst-push.1
- man/bst-shell.1
- man/bst-show.1
- − man/bst-source-bundle.1
- man/bst-source-checkout.1
- + man/bst-source-fetch.1
- + man/bst-source-track.1
- + man/bst-source.1
- man/bst-track.1
- man/bst-workspace-close.1
- man/bst-workspace-list.1
- man/bst-workspace-open.1
- man/bst-workspace-reset.1
- man/bst-workspace.1
- man/bst.1
Changes:
1 |
+.TH "BST ARTIFACT CHECKOUT" "1" "22-Jan-2019" "" "bst artifact checkout Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-artifact\-checkout \- Checkout contents of an artifact
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst artifact checkout
|
|
6 |
+[OPTIONS] [ELEMENT]
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Checkout contents of an artifact
|
|
9 |
+.SH OPTIONS
|
|
10 |
+.TP
|
|
11 |
+\fB\-f,\fP \-\-force
|
|
12 |
+Allow files to be overwritten
|
|
13 |
+.TP
|
|
14 |
+\fB\-d,\fP \-\-deps [run|build|none]
|
|
15 |
+The dependencies to checkout (default: run)
|
|
16 |
+.TP
|
|
17 |
+\fB\-\-integrate\fP / \-\-no\-integrate
|
|
18 |
+Whether to run integration commands
|
|
19 |
+.TP
|
|
20 |
+\fB\-\-hardlinks\fP
|
|
21 |
+Checkout hardlinks instead of copying if possible
|
|
22 |
+.TP
|
|
23 |
+\fB\-\-tar\fP LOCATION
|
|
24 |
+Create a tarball from the artifact contents instead of a file tree. If LOCATION is '-', the tarball will be dumped to the standard output.
|
|
25 |
+.TP
|
|
26 |
+\fB\-\-directory\fP DIRECTORY
|
|
27 |
+The directory to checkout the artifact to
|
|
\ No newline at end of file |
1 |
+.TH "BST ARTIFACT LOG" "1" "22-Jan-2019" "" "bst artifact log Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-artifact\-log \- Show logs of an artifact
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst artifact log
|
|
6 |
+[OPTIONS] [ARTIFACTS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Show logs of all artifacts
|
|
\ No newline at end of file |
1 |
+.TH "BST ARTIFACT PULL" "1" "22-Jan-2019" "" "bst artifact pull Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-artifact\-pull \- Pull a built artifact
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst artifact pull
|
|
6 |
+[OPTIONS] [ELEMENTS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Pull a built artifact from the configured remote artifact cache.
|
|
9 |
+.PP
|
|
10 |
+By default the artifact will be pulled one of the configured caches
|
|
11 |
+if possible, following the usual priority order. If the `--remote` flag
|
|
12 |
+is given, only the specified cache will be queried.
|
|
13 |
+.PP
|
|
14 |
+Specify `--deps` to control which artifacts to pull:
|
|
15 |
+.PP
|
|
16 |
+ |
|
17 |
+ none: No dependencies, just the element itself
|
|
18 |
+ all: All dependencies
|
|
19 |
+.SH OPTIONS
|
|
20 |
+.TP
|
|
21 |
+\fB\-d,\fP \-\-deps [none|all]
|
|
22 |
+The dependency artifacts to pull (default: none)
|
|
23 |
+.TP
|
|
24 |
+\fB\-r,\fP \-\-remote TEXT
|
|
25 |
+The URL of the remote cache (defaults to the first configured cache)
|
|
\ No newline at end of file |
1 |
+.TH "BST ARTIFACT PUSH" "1" "22-Jan-2019" "" "bst artifact push Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-artifact\-push \- Push a built artifact
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst artifact push
|
|
6 |
+[OPTIONS] [ELEMENTS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Push a built artifact to a remote artifact cache.
|
|
9 |
+.PP
|
|
10 |
+The default destination is the highest priority configured cache. You can
|
|
11 |
+override this by passing a different cache URL with the `--remote` flag.
|
|
12 |
+.PP
|
|
13 |
+If bst has been configured to include build trees on artifact pulls,
|
|
14 |
+an attempt will be made to pull any required build trees to avoid the
|
|
15 |
+skipping of partial artifacts being pushed.
|
|
16 |
+.PP
|
|
17 |
+Specify `--deps` to control which artifacts to push:
|
|
18 |
+.PP
|
|
19 |
+ |
|
20 |
+ none: No dependencies, just the element itself
|
|
21 |
+ all: All dependencies
|
|
22 |
+.SH OPTIONS
|
|
23 |
+.TP
|
|
24 |
+\fB\-d,\fP \-\-deps [none|all]
|
|
25 |
+The dependencies to push (default: none)
|
|
26 |
+.TP
|
|
27 |
+\fB\-r,\fP \-\-remote TEXT
|
|
28 |
+The URL of the remote cache (defaults to the first configured cache)
|
|
\ No newline at end of file |
1 |
-.TH "BST-ARTIFACT-RECEIVE" "1" "26-Apr-2018" "" "bst-artifact-receive Manual"
|
|
2 |
-.SH NAME
|
|
3 |
-bst-artifact-receive \- Receive pushed artifacts over ssh
|
|
4 |
-.SH SYNOPSIS
|
|
5 |
-.B bst-artifact-receive
|
|
6 |
-[OPTIONS] REPO
|
|
7 |
-.SH DESCRIPTION
|
|
8 |
-A BuildStream sister program for receiving artifacts send to a shared artifact cache
|
|
9 |
-
|
|
10 |
-.SH OPTIONS
|
|
11 |
-.TP
|
|
12 |
-\fB\-v,\fP \-\-verbose
|
|
13 |
-Verbose mode
|
|
14 |
-.TP
|
|
15 |
-\fB\-d,\fP \-\-debug
|
|
16 |
-Debug mode
|
|
17 |
-.TP
|
|
18 |
-\fB\-\-pull\-url\fP TEXT
|
|
19 |
-Clients who try to pull over SSH will be redirected here [required]
|
|
\ No newline at end of file |
1 |
-.TH "BST-ARTIFACT-SERVER" "1" "29-Nov-2018" "" "bst-artifact-server Manual"
|
|
1 |
+.TH "BST-ARTIFACT-SERVER" "1" "22-Jan-2019" "" "bst-artifact-server Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst-artifact-server \- CAS Artifact Server
|
4 | 4 |
.SH SYNOPSIS
|
... | ... | @@ -19,4 +19,10 @@ Public server certificate for TLS (PEM-encoded) |
19 | 19 |
Public client certificates for TLS (PEM-encoded)
|
20 | 20 |
.TP
|
21 | 21 |
\fB\-\-enable\-push\fP
|
22 |
-Allow clients to upload blobs and update artifact cache
|
|
\ No newline at end of file | ||
22 |
+Allow clients to upload blobs and update artifact cache
|
|
23 |
+.TP
|
|
24 |
+\fB\-\-head\-room\-min\fP INTEGER
|
|
25 |
+Disk head room minimum in bytes
|
|
26 |
+.TP
|
|
27 |
+\fB\-\-head\-room\-max\fP INTEGER
|
|
28 |
+Disk head room maximum in bytes
|
|
\ No newline at end of file |
1 |
+.TH "BST ARTIFACT" "1" "22-Jan-2019" "" "bst artifact Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-artifact \- Manipulate cached artifacts
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst artifact
|
|
6 |
+[OPTIONS] COMMAND [ARGS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Manipulate cached artifacts
|
|
9 |
+.SH COMMANDS
|
|
10 |
+.PP
|
|
11 |
+\fBcheckout\fP
|
|
12 |
+ Checkout contents of an artifact
|
|
13 |
+ See \fBbst artifact-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
|
|
14 |
+.PP
|
|
15 |
+\fBpull\fP
|
|
16 |
+ Pull a built artifact
|
|
17 |
+ See \fBbst artifact-pull(1)\fP for full documentation on the \fBpull\fP command.
|
|
18 |
+.PP
|
|
19 |
+\fBpush\fP
|
|
20 |
+ Push a built artifact
|
|
21 |
+ See \fBbst artifact-push(1)\fP for full documentation on the \fBpush\fP command.
|
|
22 |
+.PP
|
|
23 |
+\fBlog\fP
|
|
24 |
+ Show logs of an artifact
|
|
25 |
+ See \fBbst artifact-log(1)\fP for full documentation on the \fBlog\fP command.
|
|
\ No newline at end of file |
1 |
-.TH "BST BUILD" "1" "29-Nov-2018" "" "bst build Manual"
|
|
1 |
+.TH "BST BUILD" "1" "22-Jan-2019" "" "bst build Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-build \- Build elements in a pipeline
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST CHECKOUT" "1" "29-Nov-2018" "" "bst checkout Manual"
|
|
1 |
+.TH "BST CHECKOUT" "1" "22-Jan-2019" "" "bst checkout Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-checkout \- Checkout a built artifact
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst checkout
|
6 |
-[OPTIONS] ELEMENT LOCATION
|
|
7 |
-.SH DESCRIPTION
|
|
8 |
-Checkout a built artifact to the specified location
|
|
9 |
-
|
|
6 |
+[OPTIONS] [ELEMENT] [LOCATION]
|
|
10 | 7 |
.SH OPTIONS
|
11 | 8 |
.TP
|
12 | 9 |
\fB\-f,\fP \-\-force
|
13 | 10 |
Allow files to be overwritten
|
14 | 11 |
.TP
|
15 |
-\fB\-d,\fP \-\-deps [run|none]
|
|
12 |
+\fB\-d,\fP \-\-deps [run|build|none]
|
|
16 | 13 |
The dependencies to checkout (default: run)
|
17 | 14 |
.TP
|
18 | 15 |
\fB\-\-integrate\fP / \-\-no\-integrate
|
1 |
-.TH "BST FETCH" "1" "29-Nov-2018" "" "bst fetch Manual"
|
|
1 |
+.TH "BST FETCH" "1" "22-Jan-2019" "" "bst fetch Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-fetch \- Fetch sources in a pipeline
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst fetch
|
6 | 6 |
[OPTIONS] [ELEMENTS]...
|
7 |
-.SH DESCRIPTION
|
|
8 |
-Fetch sources required to build the pipeline
|
|
9 |
-.PP
|
|
10 |
-By default this will only try to fetch sources which are
|
|
11 |
-required for the build plan of the specified target element,
|
|
12 |
-omitting sources for any elements which are already built
|
|
13 |
-and available in the artifact cache.
|
|
14 |
-.PP
|
|
15 |
-Specify `--deps` to control which sources to fetch:
|
|
16 |
-.PP
|
|
17 |
- |
|
18 |
- none: No dependencies, just the element itself
|
|
19 |
- plan: Only dependencies required for the build plan
|
|
20 |
- all: All dependencies
|
|
21 | 7 |
.SH OPTIONS
|
22 | 8 |
.TP
|
23 | 9 |
\fB\-\-except\fP PATH
|
1 |
-.TH "BST HELP" "1" "29-Nov-2018" "" "bst help Manual"
|
|
1 |
+.TH "BST HELP" "1" "22-Jan-2019" "" "bst help Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-help \- Print usage information
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST INIT" "1" "29-Nov-2018" "" "bst init Manual"
|
|
1 |
+.TH "BST INIT" "1" "22-Jan-2019" "" "bst init Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-init \- Initialize a new BuildStream project
|
4 | 4 |
.SH SYNOPSIS
|
... | ... | @@ -18,7 +18,7 @@ interactive session. |
18 | 18 |
The project name to use
|
19 | 19 |
.TP
|
20 | 20 |
\fB\-\-format\-version\fP INTEGER
|
21 |
-The required format version (default: 18)
|
|
21 |
+The required format version (default: 20)
|
|
22 | 22 |
.TP
|
23 | 23 |
\fB\-\-element\-path\fP PATH
|
24 | 24 |
The subdirectory to store elements in (default: elements)
|
1 |
-.TH "BST PULL" "1" "29-Nov-2018" "" "bst pull Manual"
|
|
1 |
+.TH "BST PULL" "1" "22-Jan-2019" "" "bst pull Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-pull \- Pull a built artifact
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst pull
|
6 | 6 |
[OPTIONS] [ELEMENTS]...
|
7 |
-.SH DESCRIPTION
|
|
8 |
-Pull a built artifact from the configured remote artifact cache.
|
|
9 |
-.PP
|
|
10 |
-By default the artifact will be pulled one of the configured caches
|
|
11 |
-if possible, following the usual priority order. If the `--remote` flag
|
|
12 |
-is given, only the specified cache will be queried.
|
|
13 |
-.PP
|
|
14 |
-Specify `--deps` to control which artifacts to pull:
|
|
15 |
-.PP
|
|
16 |
- |
|
17 |
- none: No dependencies, just the element itself
|
|
18 |
- all: All dependencies
|
|
19 | 7 |
.SH OPTIONS
|
20 | 8 |
.TP
|
21 | 9 |
\fB\-d,\fP \-\-deps [none|all]
|
1 |
-.TH "BST PUSH" "1" "29-Nov-2018" "" "bst push Manual"
|
|
1 |
+.TH "BST PUSH" "1" "22-Jan-2019" "" "bst push Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-push \- Push a built artifact
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst push
|
6 | 6 |
[OPTIONS] [ELEMENTS]...
|
7 |
-.SH DESCRIPTION
|
|
8 |
-Push a built artifact to a remote artifact cache.
|
|
9 |
-.PP
|
|
10 |
-The default destination is the highest priority configured cache. You can
|
|
11 |
-override this by passing a different cache URL with the `--remote` flag.
|
|
12 |
-.PP
|
|
13 |
-Specify `--deps` to control which artifacts to push:
|
|
14 |
-.PP
|
|
15 |
- |
|
16 |
- none: No dependencies, just the element itself
|
|
17 |
- all: All dependencies
|
|
18 | 7 |
.SH OPTIONS
|
19 | 8 |
.TP
|
20 | 9 |
\fB\-d,\fP \-\-deps [none|all]
|
1 |
-.TH "BST SHELL" "1" "29-Nov-2018" "" "bst shell Manual"
|
|
1 |
+.TH "BST SHELL" "1" "22-Jan-2019" "" "bst shell Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-shell \- Shell into an element's sandbox environment
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst shell
|
6 |
-[OPTIONS] ELEMENT [COMMAND]...
|
|
6 |
+[OPTIONS] [ELEMENT] [COMMAND]...
|
|
7 | 7 |
.SH DESCRIPTION
|
8 | 8 |
Run a command in the target element's sandbox environment
|
9 | 9 |
.PP
|
... | ... | @@ -11,6 +11,12 @@ This will stage a temporary sysroot for running the target |
11 | 11 |
element, assuming it has already been built and all required
|
12 | 12 |
artifacts are in the local cache.
|
13 | 13 |
.PP
|
14 |
+Use '--' to separate a command from the options to bst,
|
|
15 |
+otherwise bst may respond to them instead. e.g.
|
|
16 |
+.PP
|
|
17 |
+ |
|
18 |
+ bst shell example.bst -- df -h
|
|
19 |
+.PP
|
|
14 | 20 |
Use the --build option to create a temporary sysroot for
|
15 | 21 |
building the element instead.
|
16 | 22 |
.PP
|
... | ... | @@ -32,4 +38,7 @@ An existing sysroot |
32 | 38 |
Mount a file or directory into the sandbox
|
33 | 39 |
.TP
|
34 | 40 |
\fB\-\-isolate\fP
|
35 |
-Create an isolated build sandbox
|
|
\ No newline at end of file | ||
41 |
+Create an isolated build sandbox
|
|
42 |
+.TP
|
|
43 |
+\fB\-t,\fP \-\-use\-buildtree [ask|try|always|never]
|
|
44 |
+Defaults to ask but if set to always the function will fail if a build tree is not available
|
|
\ No newline at end of file |
1 |
-.TH "BST SHOW" "1" "29-Nov-2018" "" "bst show Manual"
|
|
1 |
+.TH "BST SHOW" "1" "22-Jan-2019" "" "bst show Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-show \- Show elements in the pipeline
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST SOURCE-BUNDLE" "1" "29-Nov-2018" "" "bst source-bundle Manual"
|
|
2 |
-.SH NAME
|
|
3 |
-bst\-source-bundle \- Produce a build bundle to be manually executed
|
|
4 |
-.SH SYNOPSIS
|
|
5 |
-.B bst source-bundle
|
|
6 |
-[OPTIONS] ELEMENT
|
|
7 |
-.SH DESCRIPTION
|
|
8 |
-Produce a source bundle to be manually executed
|
|
9 |
-
|
|
10 |
-.SH OPTIONS
|
|
11 |
-.TP
|
|
12 |
-\fB\-\-except\fP PATH
|
|
13 |
-Elements to except from the tarball
|
|
14 |
-.TP
|
|
15 |
-\fB\-\-compression\fP [none|gz|bz2|xz]
|
|
16 |
-Compress the tar file using the given algorithm.
|
|
17 |
-.TP
|
|
18 |
-\fB\-\-track\fP
|
|
19 |
-Track new source references before bundling
|
|
20 |
-.TP
|
|
21 |
-\fB\-f,\fP \-\-force
|
|
22 |
-Overwrite an existing tarball
|
|
23 |
-.TP
|
|
24 |
-\fB\-\-directory\fP TEXT
|
|
25 |
-The directory to write the tarball to
|
|
\ No newline at end of file |
1 |
-.TH "BST SOURCE-CHECKOUT" "1" "29-Nov-2018" "" "bst source-checkout Manual"
|
|
1 |
+.TH "BST SOURCE CHECKOUT" "1" "22-Jan-2019" "" "bst source checkout Manual"
|
|
2 | 2 |
.SH NAME
|
3 |
-bst\-source-checkout \- Checkout sources for an element
|
|
3 |
+bst\-source\-checkout \- Checkout sources for an element
|
|
4 | 4 |
.SH SYNOPSIS
|
5 |
-.B bst source-checkout
|
|
6 |
-[OPTIONS] ELEMENT LOCATION
|
|
5 |
+.B bst source checkout
|
|
6 |
+[OPTIONS] [ELEMENT] [LOCATION]
|
|
7 | 7 |
.SH DESCRIPTION
|
8 | 8 |
Checkout sources of an element to the specified location
|
9 | 9 |
|
10 | 10 |
.SH OPTIONS
|
11 | 11 |
.TP
|
12 |
+\fB\-f,\fP \-\-force
|
|
13 |
+Allow files to be overwritten
|
|
14 |
+.TP
|
|
12 | 15 |
\fB\-\-except\fP PATH
|
13 | 16 |
Except certain dependencies
|
14 | 17 |
.TP
|
... | ... | @@ -16,4 +19,10 @@ Except certain dependencies |
16 | 19 |
The dependencies whose sources to checkout (default: none)
|
17 | 20 |
.TP
|
18 | 21 |
\fB\-\-fetch\fP
|
19 |
-Fetch elements if they are not fetched
|
|
\ No newline at end of file | ||
22 |
+Fetch elements if they are not fetched
|
|
23 |
+.TP
|
|
24 |
+\fB\-\-tar\fP
|
|
25 |
+Create a tarball from the element's sources instead of a file tree.
|
|
26 |
+.TP
|
|
27 |
+\fB\-\-include\-build\-scripts\fP
|
|
28 |
+.PP
|
|
\ No newline at end of file |
1 |
+.TH "BST SOURCE FETCH" "1" "22-Jan-2019" "" "bst source fetch Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-source\-fetch \- Fetch sources in a pipeline
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst source fetch
|
|
6 |
+[OPTIONS] [ELEMENTS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Fetch sources required to build the pipeline
|
|
9 |
+.PP
|
|
10 |
+By default this will only try to fetch sources which are
|
|
11 |
+required for the build plan of the specified target element,
|
|
12 |
+omitting sources for any elements which are already built
|
|
13 |
+and available in the artifact cache.
|
|
14 |
+.PP
|
|
15 |
+Specify `--deps` to control which sources to fetch:
|
|
16 |
+.PP
|
|
17 |
+ |
|
18 |
+ none: No dependencies, just the element itself
|
|
19 |
+ plan: Only dependencies required for the build plan
|
|
20 |
+ all: All dependencies
|
|
21 |
+.SH OPTIONS
|
|
22 |
+.TP
|
|
23 |
+\fB\-\-except\fP PATH
|
|
24 |
+Except certain dependencies from fetching
|
|
25 |
+.TP
|
|
26 |
+\fB\-d,\fP \-\-deps [none|plan|all]
|
|
27 |
+The dependencies to fetch (default: plan)
|
|
28 |
+.TP
|
|
29 |
+\fB\-\-track\fP
|
|
30 |
+Track new source references before fetching
|
|
31 |
+.TP
|
|
32 |
+\fB\-J,\fP \-\-track\-cross\-junctions
|
|
33 |
+Allow tracking to cross junction boundaries
|
|
\ No newline at end of file |
1 |
+.TH "BST SOURCE TRACK" "1" "22-Jan-2019" "" "bst source track Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-source\-track \- Track new source references
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst source track
|
|
6 |
+[OPTIONS] [ELEMENTS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Consults the specified tracking branches for new versions available
|
|
9 |
+to build and updates the project with any newly available references.
|
|
10 |
+.PP
|
|
11 |
+By default this will track just the specified element, but you can also
|
|
12 |
+update a whole tree of dependencies in one go.
|
|
13 |
+.PP
|
|
14 |
+Specify `--deps` to control which sources to track:
|
|
15 |
+.PP
|
|
16 |
+ |
|
17 |
+ none: No dependencies, just the specified elements
|
|
18 |
+ all: All dependencies of all specified elements
|
|
19 |
+.SH OPTIONS
|
|
20 |
+.TP
|
|
21 |
+\fB\-\-except\fP PATH
|
|
22 |
+Except certain dependencies from tracking
|
|
23 |
+.TP
|
|
24 |
+\fB\-d,\fP \-\-deps [none|all]
|
|
25 |
+The dependencies to track (default: none)
|
|
26 |
+.TP
|
|
27 |
+\fB\-J,\fP \-\-cross\-junctions
|
|
28 |
+Allow crossing junction boundaries
|
|
\ No newline at end of file |
1 |
+.TH "BST SOURCE" "1" "22-Jan-2019" "" "bst source Manual"
|
|
2 |
+.SH NAME
|
|
3 |
+bst\-source \- Manipulate sources for an element
|
|
4 |
+.SH SYNOPSIS
|
|
5 |
+.B bst source
|
|
6 |
+[OPTIONS] COMMAND [ARGS]...
|
|
7 |
+.SH DESCRIPTION
|
|
8 |
+Manipulate sources for an element
|
|
9 |
+.SH COMMANDS
|
|
10 |
+.PP
|
|
11 |
+\fBfetch\fP
|
|
12 |
+ Fetch sources in a pipeline
|
|
13 |
+ See \fBbst source-fetch(1)\fP for full documentation on the \fBfetch\fP command.
|
|
14 |
+.PP
|
|
15 |
+\fBtrack\fP
|
|
16 |
+ Track new source references
|
|
17 |
+ See \fBbst source-track(1)\fP for full documentation on the \fBtrack\fP command.
|
|
18 |
+.PP
|
|
19 |
+\fBcheckout\fP
|
|
20 |
+ Checkout sources for an element
|
|
21 |
+ See \fBbst source-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
|
|
\ No newline at end of file |
1 |
-.TH "BST TRACK" "1" "29-Nov-2018" "" "bst track Manual"
|
|
1 |
+.TH "BST TRACK" "1" "22-Jan-2019" "" "bst track Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-track \- Track new source references
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst track
|
6 | 6 |
[OPTIONS] [ELEMENTS]...
|
7 |
-.SH DESCRIPTION
|
|
8 |
-Consults the specified tracking branches for new versions available
|
|
9 |
-to build and updates the project with any newly available references.
|
|
10 |
-.PP
|
|
11 |
-By default this will track just the specified element, but you can also
|
|
12 |
-update a whole tree of dependencies in one go.
|
|
13 |
-.PP
|
|
14 |
-Specify `--deps` to control which sources to track:
|
|
15 |
-.PP
|
|
16 |
- |
|
17 |
- none: No dependencies, just the specified elements
|
|
18 |
- all: All dependencies of all specified elements
|
|
19 | 7 |
.SH OPTIONS
|
20 | 8 |
.TP
|
21 | 9 |
\fB\-\-except\fP PATH
|
1 |
-.TH "BST WORKSPACE CLOSE" "1" "29-Nov-2018" "" "bst workspace close Manual"
|
|
1 |
+.TH "BST WORKSPACE CLOSE" "1" "22-Jan-2019" "" "bst workspace close Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-workspace\-close \- Close workspaces
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST WORKSPACE LIST" "1" "29-Nov-2018" "" "bst workspace list Manual"
|
|
1 |
+.TH "BST WORKSPACE LIST" "1" "22-Jan-2019" "" "bst workspace list Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-workspace\-list \- List open workspaces
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst workspace list
|
6 | 6 |
[OPTIONS]
|
7 | 7 |
.SH DESCRIPTION
|
8 |
-List open workspaces
|
|
8 |
+List open workspaces
|
|
\ No newline at end of file |
1 |
-.TH "BST WORKSPACE OPEN" "1" "29-Nov-2018" "" "bst workspace open Manual"
|
|
1 |
+.TH "BST WORKSPACE OPEN" "1" "22-Jan-2019" "" "bst workspace open Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-workspace\-open \- Open a new workspace
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST WORKSPACE RESET" "1" "29-Nov-2018" "" "bst workspace reset Manual"
|
|
1 |
+.TH "BST WORKSPACE RESET" "1" "22-Jan-2019" "" "bst workspace reset Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-workspace\-reset \- Reset a workspace to its original state
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST WORKSPACE" "1" "29-Nov-2018" "" "bst workspace Manual"
|
|
1 |
+.TH "BST WORKSPACE" "1" "22-Jan-2019" "" "bst workspace Manual"
|
|
2 | 2 |
.SH NAME
|
3 | 3 |
bst\-workspace \- Manipulate developer workspaces
|
4 | 4 |
.SH SYNOPSIS
|
1 |
-.TH "BST" "1" "29-Nov-2018" "" "bst Manual"
|
|
1 |
+.TH "BST" "1" "22-Jan-2019" "" "bst Manual"
|
|
2 | 2 |
.SH NAME
|
3 |
-bst \- Build and manipulate BuildStream projects...
|
|
3 |
+bst \- None
|
|
4 | 4 |
.SH SYNOPSIS
|
5 | 5 |
.B bst
|
6 | 6 |
[OPTIONS] COMMAND [ARGS]...
|
... | ... | @@ -81,6 +81,26 @@ Include an element's build tree when pulling remote element artifacts |
81 | 81 |
Build elements in a pipeline
|
82 | 82 |
See \fBbst-build(1)\fP for full documentation on the \fBbuild\fP command.
|
83 | 83 |
.PP
|
84 |
+\fBshow\fP
|
|
85 |
+ Show elements in the pipeline
|
|
86 |
+ See \fBbst-show(1)\fP for full documentation on the \fBshow\fP command.
|
|
87 |
+.PP
|
|
88 |
+\fBshell\fP
|
|
89 |
+ Shell into an element's sandbox environment
|
|
90 |
+ See \fBbst-shell(1)\fP for full documentation on the \fBshell\fP command.
|
|
91 |
+.PP
|
|
92 |
+\fBsource\fP
|
|
93 |
+ Manipulate sources for an element
|
|
94 |
+ See \fBbst-source(1)\fP for full documentation on the \fBsource\fP command.
|
|
95 |
+.PP
|
|
96 |
+\fBworkspace\fP
|
|
97 |
+ Manipulate developer workspaces
|
|
98 |
+ See \fBbst-workspace(1)\fP for full documentation on the \fBworkspace\fP command.
|
|
99 |
+.PP
|
|
100 |
+\fBartifact\fP
|
|
101 |
+ Manipulate cached artifacts
|
|
102 |
+ See \fBbst-artifact(1)\fP for full documentation on the \fBartifact\fP command.
|
|
103 |
+.PP
|
|
84 | 104 |
\fBfetch\fP
|
85 | 105 |
Fetch sources in a pipeline
|
86 | 106 |
See \fBbst-fetch(1)\fP for full documentation on the \fBfetch\fP command.
|
... | ... | @@ -89,34 +109,14 @@ Include an element's build tree when pulling remote element artifacts |
89 | 109 |
Track new source references
|
90 | 110 |
See \fBbst-track(1)\fP for full documentation on the \fBtrack\fP command.
|
91 | 111 |
.PP
|
112 |
+\fBcheckout\fP
|
|
113 |
+ Checkout a built artifact
|
|
114 |
+ See \fBbst-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
|
|
115 |
+.PP
|
|
92 | 116 |
\fBpull\fP
|
93 | 117 |
Pull a built artifact
|
94 | 118 |
See \fBbst-pull(1)\fP for full documentation on the \fBpull\fP command.
|
95 | 119 |
.PP
|
96 | 120 |
\fBpush\fP
|
97 | 121 |
Push a built artifact
|
98 |
- See \fBbst-push(1)\fP for full documentation on the \fBpush\fP command.
|
|
99 |
-.PP
|
|
100 |
-\fBshow\fP
|
|
101 |
- Show elements in the pipeline
|
|
102 |
- See \fBbst-show(1)\fP for full documentation on the \fBshow\fP command.
|
|
103 |
-.PP
|
|
104 |
-\fBshell\fP
|
|
105 |
- Shell into an element's sandbox environment
|
|
106 |
- See \fBbst-shell(1)\fP for full documentation on the \fBshell\fP command.
|
|
107 |
-.PP
|
|
108 |
-\fBcheckout\fP
|
|
109 |
- Checkout a built artifact
|
|
110 |
- See \fBbst-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
|
|
111 |
-.PP
|
|
112 |
-\fBsource-checkout\fP
|
|
113 |
- Checkout sources for an element
|
|
114 |
- See \fBbst-source-checkout(1)\fP for full documentation on the \fBsource-checkout\fP command.
|
|
115 |
-.PP
|
|
116 |
-\fBworkspace\fP
|
|
117 |
- Manipulate developer workspaces
|
|
118 |
- See \fBbst-workspace(1)\fP for full documentation on the \fBworkspace\fP command.
|
|
119 |
-.PP
|
|
120 |
-\fBsource-bundle\fP
|
|
121 |
- Produce a build bundle to be manually executed
|
|
122 |
- See \fBbst-source-bundle(1)\fP for full documentation on the \fBsource-bundle\fP command.
|
|
\ No newline at end of file | ||
122 |
+ See \fBbst-push(1)\fP for full documentation on the \fBpush\fP command.
|
|
\ No newline at end of file |