tox.ini: Fix tox -e man manpage regeneration

The new man pages now include the bst version in them, and
the documentation about generating man pages is also updated
to specify that one should specify `tox -e man -- <version>`.

Author: tristanvb

doc/source/hacking/writing_documentation.rst

@@ -112,9 +112,11 @@ into the ``setup.py``, as such, whenever the frontend command line
 interface changes, the static man pages should be regenerated and
 committed with that.
 
-To do this, run the following from the the toplevel directory of BuildStream::
+To do this, make sure you know the version you are generating the docs
+for, which should usually be the *next* ``major.minor`` version of BuildStream,
+and then run the following from the the toplevel directory of BuildStream::
 
-  tox -e man
+  tox -e man -- <version>
 
 And commit the result, ensuring that you have added anything in
 the ``man/`` subdirectory, which will be automatically included

tox.ini

@@ -208,16 +208,21 @@ passenv =
 allowlist_externals =
     make
 
+
 #
 # (re-)Generating man pages
 #
 [testenv:man]
 commands =
-    python3 setup.py --command-packages=click_man.commands man_pages
+    # We set the version to 0, because click-man would now
+    # otherwise want to pull a hardcoded version from pyproject.toml
+    # that somehow gets magically transported to the EntryPoint.version
+    click-man --man-version {posargs} --target man bst
 deps =
-    click-man >= 0.3.0
-    Cython
+    click-man >= 0.5.0
     -rrequirements/requirements.txt
+    -rrequirements/dev-requirements.txt
+    Cython
 
 
 #