commit b16d5c0113c7bfe299336ddc2515e5f1c5ff8247 Author: juga0 juga@riseup.net Date: Tue Aug 28 15:11:56 2018 +0000

Explain how to build docs. Remove obsolete --- INSTALL.rst | 31 +++++++++---------------------- 1 file changed, 9 insertions(+), 22 deletions(-)

diff --git a/INSTALL.rst b/INSTALL.rst index f83489d..b774ae2 100644 --- a/INSTALL.rst +++ b/INSTALL.rst @@ -80,35 +80,22 @@ To install them from ``sbws``::

pip install .[doc]

-:: - - git clone https://github.com/pastly/simple-bw-scanner.git - cd simple-bw-scanner - git checkout v1.5.3 - virtualenv -p python3 venv-editable - source venv-editable/bin/activate - pip install --process-dependency-links --editable . - sbws init +To build the documentation as HTML::

-.. note:: + cd docs/ && make html

- Because we relay on a ``-dev`` version of stem, we need to fetch it from - git.torproject.org. Thus ``--process-dependency-links`` is necessary. +The generated HTML will be in `docs/build/`.

-.. warning:: +To build the manual (``man``) pages::

- Run these commands one at a time and check for errors before continuing. + cd docs/ && make man

-Updating -~~~~~~~~ +The generated man pages will be in `docs/man/`.

-:: +To build the documentation diagrams::

- cd simple-bw-scanner - git pull - # Determine the newest released version. Assuming it is v1.5.3 ... - git checkout v1.5.3 + cd docs/ && make umlsvg

-.. todo:: +The generated diagrams will be in `docs/build/images/`.

This doesn't update dependencies and needs to be fixed.