man/bst-track.1

-.TH "BST TRACK" "1" "22-Jan-2019" "" "bst track Manual"
-.SH NAME
-bst\-track \- Track new source references
-.SH SYNOPSIS
-.B bst track
-[OPTIONS] [ELEMENTS]...
-.SH OPTIONS
-.TP
-\fB\-\-except\fP PATH
-Except certain dependencies from tracking
-.TP
-\fB\-d,\fP \-\-deps [none|all]
-The dependencies to track (default: none)
-.TP
-\fB\-J,\fP \-\-cross\-junctions
-Allow crossing junction boundaries
\ No newline at end of file

man/bst-workspace-close.1

-.TH "BST WORKSPACE CLOSE" "1" "22-Jan-2019" "" "bst workspace close Manual"
+.TH "BST WORKSPACE CLOSE" "1" "24-Jan-2019" "" "bst workspace close Manual"
 .SH NAME
 bst\-workspace\-close \- Close workspaces
 .SH SYNOPSIS
@@ -12,4 +12,4 @@ Close a workspace
 Remove the path that contains the closed workspace
 .TP
 \fB\-a,\fP \-\-all
-Close all open workspaces
\ No newline at end of file
+Close all open workspaces

man/bst-workspace-list.1

-.TH "BST WORKSPACE LIST" "1" "22-Jan-2019" "" "bst workspace list Manual"
+.TH "BST WORKSPACE LIST" "1" "24-Jan-2019" "" "bst workspace list Manual"
 .SH NAME
 bst\-workspace\-list \- List open workspaces
 .SH SYNOPSIS
 .B bst workspace list
 [OPTIONS]
 .SH DESCRIPTION
-List open workspaces
\ No newline at end of file
+List open workspaces

man/bst-workspace-open.1

-.TH "BST WORKSPACE OPEN" "1" "22-Jan-2019" "" "bst workspace open Manual"
+.TH "BST WORKSPACE OPEN" "1" "24-Jan-2019" "" "bst workspace open Manual"
 .SH NAME
 bst\-workspace\-open \- Open a new workspace
 .SH SYNOPSIS
@@ -18,4 +18,4 @@ The workspace will be created even if the directory in which it will be created
 Track and fetch new source references before checking out the workspace
 .TP
 \fB\-\-directory\fP DIRECTORY
-Only for use when a single Element is given: Set the directory to use to create the workspace
\ No newline at end of file
+Only for use when a single Element is given: Set the directory to use to create the workspace

man/bst-workspace-reset.1

-.TH "BST WORKSPACE RESET" "1" "22-Jan-2019" "" "bst workspace reset Manual"
+.TH "BST WORKSPACE RESET" "1" "24-Jan-2019" "" "bst workspace reset Manual"
 .SH NAME
 bst\-workspace\-reset \- Reset a workspace to its original state
 .SH SYNOPSIS
@@ -15,4 +15,4 @@ Reset workspace state without affecting its contents
 Track and fetch the latest source before resetting
 .TP
 \fB\-a,\fP \-\-all
-Reset all open workspaces
\ No newline at end of file
+Reset all open workspaces

man/bst-workspace.1

-.TH "BST WORKSPACE" "1" "22-Jan-2019" "" "bst workspace Manual"
+.TH "BST WORKSPACE" "1" "24-Jan-2019" "" "bst workspace Manual"
 .SH NAME
 bst\-workspace \- Manipulate developer workspaces
 .SH SYNOPSIS
@@ -22,4 +22,4 @@ Manipulate developer workspaces
 .PP
 \fBlist\fP
   List open workspaces
-  See \fBbst workspace-list(1)\fP for full documentation on the \fBlist\fP command.
\ No newline at end of file
+  See \fBbst workspace-list(1)\fP for full documentation on the \fBlist\fP command.

man/bst.1

-.TH "BST" "1" "22-Jan-2019" "" "bst Manual"
+.TH "BST" "1" "24-Jan-2019" "" "bst Manual"
 .SH NAME
-bst \- None
+bst \- Build and manipulate BuildStream projects...
 .SH SYNOPSIS
 .B bst
 [OPTIONS] COMMAND [ARGS]...
@@ -102,21 +102,21 @@ Include an element's build tree when pulling remote element artifacts
   See \fBbst-artifact(1)\fP for full documentation on the \fBartifact\fP command.
 .PP
 \fBfetch\fP
-  Fetch sources in a pipeline
+  COMMAND OBSOLETE - Fetch sources in a pipeline
   See \fBbst-fetch(1)\fP for full documentation on the \fBfetch\fP command.
 .PP
 \fBtrack\fP
-  Track new source references
+  COMMAND OBSOLETE - Track new source references
   See \fBbst-track(1)\fP for full documentation on the \fBtrack\fP command.
 .PP
 \fBcheckout\fP
-  Checkout a built artifact
+  COMMAND OBSOLETE - Checkout a built artifact
   See \fBbst-checkout(1)\fP for full documentation on the \fBcheckout\fP command.
 .PP
 \fBpull\fP
-  Pull a built artifact
+  COMMAND OBSOLETE - Pull a built artifact
   See \fBbst-pull(1)\fP for full documentation on the \fBpull\fP command.
 .PP
 \fBpush\fP
-  Push a built artifact
-  See \fBbst-push(1)\fP for full documentation on the \fBpush\fP command.
\ No newline at end of file
+  COMMAND OBSOLETE - Push a built artifact
+  See \fBbst-push(1)\fP for full documentation on the \fBpush\fP command.

setup.py

@@ -100,18 +100,21 @@ def check_for_bwrap():
 # Man pages are automatically generated however it was too difficult
 # to integrate with setuptools as a step of the build (FIXME !).
 #
-# To update the man pages in tree before a release, you need to
-# ensure you have the 'click_man' package installed, and run:
+# To update the man pages in tree before a release, run:
 #
-# python3 setup.py --command-packages=click_man.commands man_pages
+#     tox -e man
 #
 # Then commit the result.
 #
 def list_man_pages():
     bst_dir = os.path.dirname(os.path.abspath(__file__))
     man_dir = os.path.join(bst_dir, 'man')
-    man_pages = os.listdir(man_dir)
-    return [os.path.join('man', page) for page in man_pages]
+    try:
+        man_pages = os.listdir(man_dir)
+        return [os.path.join('man', page) for page in man_pages]
+    except FileNotFoundError:
+        # Do not error out when 'man' directory does not exist
+        return []
 
 
 #####################################################

tox.ini

@@ -80,3 +80,13 @@ passenv =
     LC_ALL
 whitelist_externals =
     make
+
+#
+# (re-)Generating man pages
+#
+[testenv:man]
+commands =
+    python3 setup.py --command-packages=click_man.commands man_pages
+deps =
+    click-man
+    -rrequirements/requirements.txt