Regenerate man pages after removal of `--track*` from `bst build`

24 files changed, 128 insertions, 97 deletions

diff --git a/man/bst-artifact-checkout.1 b/man/bst-artifact-checkout.1
index 138b7ab54..8b0a6e14f 100644
--- a/man/bst-artifact-checkout.1
+++ b/man/bst-artifact-checkout.1
@@ -1,9 +1,9 @@
-.TH "BST ARTIFACT CHECKOUT" "1" "14-Jul-2019" "" "bst artifact checkout Manual"
+.TH "BST ARTIFACT CHECKOUT" "1" "31-Oct-2019" "" "bst artifact checkout Manual"
 .SH NAME
 bst\-artifact\-checkout \- Checkout contents of an artifact
 .SH SYNOPSIS
 .B bst artifact checkout
-[OPTIONS] [ELEMENT]
+[OPTIONS] [TARGET]
 .SH DESCRIPTION
 Checkout contents of an artifact
 .PP
@@ -14,8 +14,8 @@ is to checkout the artifact of the workspace element.
 \fB\-f,\fP \-\-force
 Allow files to be overwritten
 .TP
-\fB\-d,\fP \-\-deps [run|build|none]
-The dependencies to checkout (default: run)
+\fB\-d,\fP \-\-deps [run|build|none|all]
+The dependencies to checkout  [default: run]
 .TP
 \fB\-\-integrate\fP / \-\-no\-integrate
 Whether to run integration commands
@@ -26,8 +26,11 @@ Checkout hardlinks instead of copying if possible
 \fB\-\-tar\fP LOCATION
 Create a tarball from the artifact contents instead of a file tree. If LOCATION is '-', the tarball will be dumped to the standard output.
 .TP
+\fB\-\-compression\fP [gz|xz|bz2]
+The compression option of the tarball created.
+.TP
 \fB\-\-pull\fP
-Whether to pull the artifact if it's missing or incomplete.
+Pull the artifact if it's missing or incomplete.
 .TP
 \fB\-\-directory\fP DIRECTORY
 The directory to checkout the artifact to
diff --git a/man/bst-artifact-delete.1 b/man/bst-artifact-delete.1
index aa1bb34e4..d3d8394b7 100644
--- a/man/bst-artifact-delete.1
+++ b/man/bst-artifact-delete.1
@@ -1,4 +1,4 @@
-.TH "BST ARTIFACT DELETE" "1" "14-Jul-2019" "" "bst artifact delete Manual"
+.TH "BST ARTIFACT DELETE" "1" "31-Oct-2019" "" "bst artifact delete Manual"
 .SH NAME
 bst\-artifact\-delete \- Remove artifacts from the local cache
 .SH SYNOPSIS
@@ -8,5 +8,5 @@ bst\-artifact\-delete \- Remove artifacts from the local cache
 Remove artifacts from the local cache
 .SH OPTIONS
 .TP
-\fB\-\-no\-prune\fP
-Do not prune the local cache of unreachable refs
+\fB\-d,\fP \-\-deps [none|run|build|all]
+The dependencies to delete  [default: none]
diff --git a/man/bst-artifact-list-contents.1 b/man/bst-artifact-list-contents.1
new file mode 100644
index 000000000..90949af6a
--- /dev/null
+++ b/man/bst-artifact-list-contents.1
@@ -0,0 +1,15 @@
+.TH "BST ARTIFACT LIST-CONTENTS" "1" "31-Oct-2019" "" "bst artifact list-contents Manual"
+.SH NAME
+bst\-artifact\-list-contents \- List the contents of an artifact
+.SH SYNOPSIS
+.B bst artifact list-contents
+[OPTIONS] [ARTIFACTS]...
+.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>`.
+.SH OPTIONS
+.TP
+\fB\-l,\fP \-\-long
+Provide more information about the contents of the artifact.
diff --git a/man/bst-artifact-log.1 b/man/bst-artifact-log.1
index 34205e3f8..e7d646602 100644
--- a/man/bst-artifact-log.1
+++ b/man/bst-artifact-log.1
@@ -1,36 +1,12 @@
-.TH "BST ARTIFACT LOG" "1" "14-Jul-2019" "" "bst artifact log Manual"
+.TH "BST ARTIFACT LOG" "1" "31-Oct-2019" "" "bst artifact log Manual"
 .SH NAME
 bst\-artifact\-log \- Show logs of artifacts
 .SH SYNOPSIS
 .B bst artifact log
 [OPTIONS] [ARTIFACTS]...
 .SH DESCRIPTION
-Show logs of artifacts.
-.PP
-Note that 'artifacts' can be element references like "hello.bst", and they
-can also be artifact references. You may use shell-style wildcards for
-either.
-.PP
-Here are some examples of element references:
-.PP
-
-- `hello.bst`
-- `*.bst`
-.PP
-Note that element references must end with '.bst' to distinguish them from
-artifact references. Anything that does not end in '.bst' is an artifact
-ref.
-.PP
-Artifact references follow the format `<project_name>/<element>/<key>`.
-Note that 'element' is without the `.bst` extension.
-.PP
-Here are some examples of artifact references:
-.PP
-
-- `myproject/hello/*`
-- `myproject/*`
-- `*`
-- `myproject/hello/827637*`
-- `myproject/he*/827637*`
-- `myproject/he??o/827637*`
-- `m*/h*/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f`
+Show build logs of artifacts
+.SH OPTIONS
+.TP
+\fB\-\-out\fP PATH
+Output logs to individual files in the specified path. If absent, logs are written to stdout.
diff --git a/man/bst-artifact-pull.1 b/man/bst-artifact-pull.1
index 6b9262570..f768ca0d7 100644
--- a/man/bst-artifact-pull.1
+++ b/man/bst-artifact-pull.1
@@ -1,9 +1,9 @@
-.TH "BST ARTIFACT PULL" "1" "14-Jul-2019" "" "bst artifact pull Manual"
+.TH "BST ARTIFACT PULL" "1" "31-Oct-2019" "" "bst artifact pull Manual"
 .SH NAME
 bst\-artifact\-pull \- Pull a built artifact
 .SH SYNOPSIS
 .B bst artifact pull
-[OPTIONS] [ELEMENTS]...
+[OPTIONS] [ARTIFACTS]...
 .SH DESCRIPTION
 Pull a built artifact from the configured remote artifact cache.
 .PP
@@ -26,7 +26,7 @@ Specify `--deps` to control which artifacts to pull:
 .SH OPTIONS
 .TP
 \fB\-d,\fP \-\-deps [none|all]
-The dependency artifacts to pull (default: none)
+The dependency artifacts to pull  [default: none]
 .TP
 \fB\-r,\fP \-\-remote TEXT
 The URL of the remote cache (defaults to the first configured cache)
diff --git a/man/bst-artifact-push.1 b/man/bst-artifact-push.1
index 6894a5be2..69280ff26 100644
--- a/man/bst-artifact-push.1
+++ b/man/bst-artifact-push.1
@@ -1,9 +1,9 @@
-.TH "BST ARTIFACT PUSH" "1" "14-Jul-2019" "" "bst artifact push Manual"
+.TH "BST ARTIFACT PUSH" "1" "31-Oct-2019" "" "bst artifact push Manual"
 .SH NAME
 bst\-artifact\-push \- Push a built artifact
 .SH SYNOPSIS
 .B bst artifact push
-[OPTIONS] [ELEMENTS]...
+[OPTIONS] [ARTIFACTS]...
 .SH DESCRIPTION
 Push a built artifact to a remote artifact cache.
 .PP
@@ -29,7 +29,7 @@ Specify `--deps` to control which artifacts to push:
 .SH OPTIONS
 .TP
 \fB\-d,\fP \-\-deps [none|all]
-The dependencies to push (default: none)
+The dependencies to push  [default: none]
 .TP
 \fB\-r,\fP \-\-remote TEXT
 The URL of the remote cache (defaults to the first configured cache)
diff --git a/man/bst-artifact-server.1 b/man/bst-artifact-server.1
index ed5c0c096..1f84a4924 100644
--- a/man/bst-artifact-server.1
+++ b/man/bst-artifact-server.1
@@ -1,4 +1,4 @@
-.TH "BST-ARTIFACT-SERVER" "1" "14-Jul-2019" "" "bst-artifact-server Manual"
+.TH "BST-ARTIFACT-SERVER" "1" "31-Oct-2019" "" "bst-artifact-server Manual"
 .SH NAME
 bst-artifact-server \- CAS Artifact Server
 .SH SYNOPSIS
@@ -21,8 +21,8 @@ Public client certificates for TLS (PEM-encoded)
 \fB\-\-enable\-push\fP
 Allow clients to upload blobs and update artifact cache
 .TP
-\fB\-\-head\-room\-min\fP INTEGER
-Disk head room minimum in bytes
+\fB\-\-quota\fP INTEGER
+Maximum disk usage in bytes  [default: 10000000000.0]
 .TP
-\fB\-\-head\-room\-max\fP INTEGER
-Disk head room maximum in bytes
+\fB\-\-index\-only\fP
+Only provide the BuildStream artifact and source services ("index"), not the CAS ("storage")
diff --git a/man/bst-artifact-show.1 b/man/bst-artifact-show.1
new file mode 100644
index 000000000..358367b33
--- /dev/null
+++ b/man/bst-artifact-show.1
@@ -0,0 +1,12 @@
+.TH "BST ARTIFACT SHOW" "1" "31-Oct-2019" "" "bst artifact show Manual"
+.SH NAME
+bst\-artifact\-show \- Show the cached state of artifacts
+.SH SYNOPSIS
+.B bst artifact show
+[OPTIONS] [ARTIFACTS]...
+.SH DESCRIPTION
+show the cached state of artifacts
+.SH OPTIONS
+.TP
+\fB\-d,\fP \-\-deps [build|run|all|none]
+The dependencies we also want to show  [default: none]
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.
diff --git a/man/bst-build.1 b/man/bst-build.1
index 1eab130a4..ebd6eaf3e 100644
--- a/man/bst-build.1
+++ b/man/bst-build.1
@@ -1,4 +1,4 @@
-.TH "BST BUILD" "1" "14-Jul-2019" "" "bst build Manual"
+.TH "BST BUILD" "1" "31-Oct-2019" "" "bst build Manual"
 .SH NAME
 bst\-build \- Build elements in a pipeline
 .SH SYNOPSIS
@@ -13,25 +13,16 @@ elements will be built.
 .PP
 When this command is executed from a workspace directory, the default
 is to build the workspace element.
+.PP
+Specify `--deps` to control which dependencies to build:
+.PP
+
+    plan:  Only dependencies required for the build plan
+    all:   All dependencies
 .SH OPTIONS
 .TP
-\fB\-\-all\fP
-Build elements that would not be needed for the current build plan
-.TP
-\fB\-\-track\fP PATH
-Specify elements to track during the build. Can be used repeatedly to specify multiple elements
-.TP
-\fB\-\-track\-all\fP
-Track all elements in the pipeline
-.TP
-\fB\-\-track\-except\fP PATH
-Except certain dependencies from tracking
-.TP
-\fB\-J,\fP \-\-track\-cross\-junctions
-Allow tracking to cross junction boundaries
-.TP
-\fB\-\-track\-save\fP
-Deprecated: This is ignored
+\fB\-d,\fP \-\-deps [plan|all]
+The dependencies to build
 .TP
 \fB\-r,\fP \-\-remote TEXT
 The URL of the remote cache (defaults to the first configured cache)
diff --git a/man/bst-help.1 b/man/bst-help.1
index df6caf815..92928e519 100644
--- a/man/bst-help.1
+++ b/man/bst-help.1
@@ -1,4 +1,4 @@
-.TH "BST HELP" "1" "14-Jul-2019" "" "bst help Manual"
+.TH "BST HELP" "1" "31-Oct-2019" "" "bst help Manual"
 .SH NAME
 bst\-help \- Print usage information
 .SH SYNOPSIS
diff --git a/man/bst-init.1 b/man/bst-init.1
index 58c4e1311..a9e9d24ea 100644
--- a/man/bst-init.1
+++ b/man/bst-init.1
@@ -1,4 +1,4 @@
-.TH "BST INIT" "1" "14-Jul-2019" "" "bst init Manual"
+.TH "BST INIT" "1" "31-Oct-2019" "" "bst init Manual"
 .SH NAME
 bst\-init \- Initialize a new BuildStream project
 .SH SYNOPSIS
@@ -18,10 +18,10 @@ interactive session.
 The project name to use
 .TP
 \fB\-\-format\-version\fP INTEGER
-The required format version (default: 24)
+The required format version  [default: 25]
 .TP
 \fB\-\-element\-path\fP PATH
-The subdirectory to store elements in (default: elements)
+The subdirectory to store elements in  [default: elements]
 .TP
 \fB\-f,\fP \-\-force
 Allow overwriting an existing project.conf
diff --git a/man/bst-shell.1 b/man/bst-shell.1
index a6e8956da..d32eb613c 100644
--- a/man/bst-shell.1
+++ b/man/bst-shell.1
@@ -1,4 +1,4 @@
-.TH "BST SHELL" "1" "14-Jul-2019" "" "bst shell Manual"
+.TH "BST SHELL" "1" "31-Oct-2019" "" "bst shell Manual"
 .SH NAME
 bst\-shell \- Shell into an element's sandbox environment
 .SH SYNOPSIS
@@ -44,7 +44,7 @@ Mount a file or directory into the sandbox
 Create an isolated build sandbox
 .TP
 \fB\-t,\fP \-\-use\-buildtree [ask|try|always|never]
-Defaults to ask but if set to always the function will fail if a build tree is not available
+Use a buildtree. If `always` is set, will always fail to build if a buildtree is not available.  [default: ask]
 .TP
 \fB\-\-pull\fP
 Attempt to pull missing or incomplete artifacts
diff --git a/man/bst-show.1 b/man/bst-show.1
index ce74604a5..0d66f73c1 100644
--- a/man/bst-show.1
+++ b/man/bst-show.1
@@ -1,4 +1,4 @@
-.TH "BST SHOW" "1" "14-Jul-2019" "" "bst show Manual"
+.TH "BST SHOW" "1" "31-Oct-2019" "" "bst show Manual"
 .SH NAME
 bst\-show \- Show elements in the pipeline
 .SH SYNOPSIS
@@ -66,10 +66,10 @@ If you want to use a newline in a format string in bash, use the '$' modifier:
 Except certain dependencies
 .TP
 \fB\-d,\fP \-\-deps [none|plan|run|build|all]
-The dependencies to show (default: all)
+The dependencies to show  [default: all]
 .TP
 \fB\-\-order\fP [stage|alpha]
-Staging or alphabetic ordering of dependencies
+Staging or alphabetic ordering of dependencies  [default: stage]
 .TP
 \fB\-f,\fP \-\-format FORMAT
 Format string for each element
diff --git a/man/bst-source-checkout.1 b/man/bst-source-checkout.1
index 4a3e1edd9..6af45c720 100644
--- a/man/bst-source-checkout.1
+++ b/man/bst-source-checkout.1
@@ -1,9 +1,9 @@
-.TH "BST SOURCE CHECKOUT" "1" "14-Jul-2019" "" "bst source checkout Manual"
+.TH "BST SOURCE CHECKOUT" "1" "31-Oct-2019" "" "bst source checkout Manual"
 .SH NAME
-bst\-source\-checkout \- Checkout sources for an element
+bst\-source\-checkout \- Checkout sources of an element
 .SH SYNOPSIS
 .B bst source checkout
-[OPTIONS] [ELEMENT] [LOCATION]
+[OPTIONS] [ELEMENT]
 .SH DESCRIPTION
 Checkout sources of an element to the specified location
 .PP
@@ -18,10 +18,16 @@ Allow files to be overwritten
 Except certain dependencies
 .TP
 \fB\-d,\fP \-\-deps [build|none|run|all]
-The dependencies whose sources to checkout (default: none)
+The dependencies whose sources to checkout  [default: none]
 .TP
-\fB\-\-tar\fP
-Create a tarball from the element's sources instead of a file tree.
+\fB\-\-tar\fP LOCATION
+Create a tarball containing the sources instead of a file tree.
+.TP
+\fB\-\-compression\fP [gz|xz|bz2]
+The compression option of the tarball created.
 .TP
 \fB\-\-include\-build\-scripts\fP
 .PP
+.TP
+\fB\-\-directory\fP DIRECTORY
+The directory to checkout the sources to
diff --git a/man/bst-source-fetch.1 b/man/bst-source-fetch.1
index e25ec9175..e53e2be53 100644
--- a/man/bst-source-fetch.1
+++ b/man/bst-source-fetch.1
@@ -1,4 +1,4 @@
-.TH "BST SOURCE FETCH" "1" "14-Jul-2019" "" "bst source fetch Manual"
+.TH "BST SOURCE FETCH" "1" "31-Oct-2019" "" "bst source fetch Manual"
 .SH NAME
 bst\-source\-fetch \- Fetch sources in a pipeline
 .SH SYNOPSIS
@@ -31,7 +31,7 @@ Specify `--deps` to control which sources to fetch:
 Except certain dependencies from fetching
 .TP
 \fB\-d,\fP \-\-deps [none|plan|all]
-The dependencies to fetch (default: plan)
+The dependencies to fetch  [default: plan]
 .TP
 \fB\-\-track\fP
 Track new source references before fetching
diff --git a/man/bst-source-track.1 b/man/bst-source-track.1
index 6ce8e7a1d..12171553b 100644
--- a/man/bst-source-track.1
+++ b/man/bst-source-track.1
@@ -1,4 +1,4 @@
-.TH "BST SOURCE TRACK" "1" "14-Jul-2019" "" "bst source track Manual"
+.TH "BST SOURCE TRACK" "1" "31-Oct-2019" "" "bst source track Manual"
 .SH NAME
 bst\-source\-track \- Track new source references
 .SH SYNOPSIS
@@ -31,7 +31,7 @@ Specify `--deps` to control which sources to track:
 Except certain dependencies from tracking
 .TP
 \fB\-d,\fP \-\-deps [none|all]
-The dependencies to track (default: none)
+The dependencies to track  [default: none]
 .TP
 \fB\-J,\fP \-\-cross\-junctions
 Allow crossing junction boundaries
diff --git a/man/bst-source.1 b/man/bst-source.1
index 2598d4d1d..447fb7f06 100644
--- a/man/bst-source.1
+++ b/man/bst-source.1
@@ -1,4 +1,4 @@
-.TH "BST SOURCE" "1" "14-Jul-2019" "" "bst source Manual"
+.TH "BST SOURCE" "1" "31-Oct-2019" "" "bst source Manual"
 .SH NAME
 bst\-source \- Manipulate sources for an element
 .SH SYNOPSIS
@@ -17,5 +17,5 @@ Manipulate sources for an element
   See \fBbst source-track(1)\fP for full documentation on the \fBtrack\fP command.
 .PP
 \fBcheckout\fP
-  Checkout sources for an element
+  Checkout sources of an element
   See \fBbst source-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
diff --git a/man/bst-workspace-close.1 b/man/bst-workspace-close.1
index 0bcf74bf7..1abbe1a5a 100644
--- a/man/bst-workspace-close.1
+++ b/man/bst-workspace-close.1
@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE CLOSE" "1" "14-Jul-2019" "" "bst workspace close Manual"
+.TH "BST WORKSPACE CLOSE" "1" "31-Oct-2019" "" "bst workspace close Manual"
 .SH NAME
 bst\-workspace\-close \- Close workspaces
 .SH SYNOPSIS
diff --git a/man/bst-workspace-list.1 b/man/bst-workspace-list.1
index 199ff3461..630efebc4 100644
--- a/man/bst-workspace-list.1
+++ b/man/bst-workspace-list.1
@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE LIST" "1" "14-Jul-2019" "" "bst workspace list Manual"
+.TH "BST WORKSPACE LIST" "1" "31-Oct-2019" "" "bst workspace list Manual"
 .SH NAME
 bst\-workspace\-list \- List open workspaces
 .SH SYNOPSIS
diff --git a/man/bst-workspace-open.1 b/man/bst-workspace-open.1
index cb59cbfb6..4ccf010af 100644
--- a/man/bst-workspace-open.1
+++ b/man/bst-workspace-open.1
@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE OPEN" "1" "14-Jul-2019" "" "bst workspace open Manual"
+.TH "BST WORKSPACE OPEN" "1" "31-Oct-2019" "" "bst workspace open Manual"
 .SH NAME
 bst\-workspace\-open \- Open a new workspace
 .SH SYNOPSIS
diff --git a/man/bst-workspace-reset.1 b/man/bst-workspace-reset.1
index 255840434..a9c0d2ce6 100644
--- a/man/bst-workspace-reset.1
+++ b/man/bst-workspace-reset.1
@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE RESET" "1" "14-Jul-2019" "" "bst workspace reset Manual"
+.TH "BST WORKSPACE RESET" "1" "31-Oct-2019" "" "bst workspace reset Manual"
 .SH NAME
 bst\-workspace\-reset \- Reset a workspace to its original state
 .SH SYNOPSIS
diff --git a/man/bst-workspace.1 b/man/bst-workspace.1
index aab453ccc..ce5842a87 100644
--- a/man/bst-workspace.1
+++ b/man/bst-workspace.1
@@ -1,4 +1,4 @@
-.TH "BST WORKSPACE" "1" "14-Jul-2019" "" "bst workspace Manual"
+.TH "BST WORKSPACE" "1" "31-Oct-2019" "" "bst workspace Manual"
 .SH NAME
 bst\-workspace \- Manipulate developer workspaces
 .SH SYNOPSIS
diff --git a/man/bst.1 b/man/bst.1
index 16ed29260..a14cac70c 100644
--- a/man/bst.1
+++ b/man/bst.1
@@ -1,4 +1,4 @@
-.TH "BST" "1" "14-Jul-2019" "" "bst Manual"
+.TH "BST" "1" "31-Oct-2019" "" "bst Manual"
 .SH NAME
 bst \- Build and manipulate BuildStream projects...
 .SH SYNOPSIS
@@ -104,7 +104,7 @@ Cache artifact build tree content on creation
   See \fBbst-workspace(1)\fP for full documentation on the \fBworkspace\fP command.
 .PP
 \fBartifact\fP
-  Manipulate cached artifacts
+  Manipulate cached artifacts.
   See \fBbst-artifact(1)\fP for full documentation on the \fBartifact\fP command.
 .PP
 \fBfetch\fP