diff options
author | Chandan Singh <csingh43@bloomberg.net> | 2019-10-29 13:03:13 +0000 |
---|---|---|
committer | Chandan Singh <csingh43@bloomberg.net> | 2019-10-31 19:03:31 +0000 |
commit | e8868b0c80c253162ae35b121b9ac6fa5e29bf18 (patch) | |
tree | 2d5e316a82129f293d1bb40c1e2552dae884e267 /man/bst-artifact.1 | |
parent | 3353b6e8c8a571ee1b03176861fc2998dd775116 (diff) | |
download | buildstream-chandan/remove-build-track.tar.gz |
Regenerate man pages after removal of `--track*` from `bst build`chandan/remove-build-track
Diffstat (limited to 'man/bst-artifact.1')
-rw-r--r-- | man/bst-artifact.1 | 32 |
1 files changed, 30 insertions, 2 deletions
diff --git a/man/bst-artifact.1 b/man/bst-artifact.1 index d5b0a4797..d2ac2dc02 100644 --- a/man/bst-artifact.1 +++ b/man/bst-artifact.1 @@ -1,13 +1,37 @@ -.TH "BST ARTIFACT" "1" "14-Jul-2019" "" "bst artifact Manual" +.TH "BST ARTIFACT" "1" "31-Oct-2019" "" "bst artifact Manual" .SH NAME -bst\-artifact \- Manipulate cached artifacts +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 paths +.PP +When elements are given, the artifact corresponding to the element is used. +.PP +The commands also support shell-style wildcard expansion: `?` matches a +single character, and `*` matches zero or more. The patterns are matched +against artifact refs by default. If the pattern ends with `.bst` then +it matches element paths instead. Some example arguments are: +.PP + +- `myproject/hello/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f` +- `myproject/he*/827637*` +- `*.bst` (all elements) +- `myproject/*` (all artifacts from myproject) .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. @@ -24,6 +48,10 @@ Manipulate cached artifacts 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. |