From 4edbbd27c295e3f5498d3e721941cb8a91da4fd3 Mon Sep 17 00:00:00 2001 From: Chandan Singh Date: Thu, 24 Jan 2019 21:20:21 +0000 Subject: setup.py, CONTRIBUTING.rst: Recommend using tox to generate man pages Simplify our docs, by requesting users to run `tox -e man` to update man pages, instead of manually installing `click-man` and running the command manually. --- CONTRIBUTING.rst | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) (limited to 'CONTRIBUTING.rst') diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index c8c1f29e5..815acfca6 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -1259,14 +1259,9 @@ 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, first ensure you have ``click_man`` installed, possibly -with:: +To do this, run the following from the the toplevel directory of BuildStream:: - pip3 install --user click_man - -Then, in the toplevel directory of buildstream, run the following:: - - python3 setup.py --command-packages=click_man.commands man_pages + tox -e man And commit the result, ensuring that you have added anything in the ``man/`` subdirectory, which will be automatically included -- cgit v1.2.1