diff options
| author |   Rich Bennett <rb2745@att.com> | 2017-11-13 11:55:10 +0000 |
|---|---|---|
| committer |   Gerrit Code Review <gerrit@onap.org> | 2017-11-13 11:55:10 +0000 |
| commit | 2c3fb536d9b52dae5466f64aeeb7cb903f608328 (patch) | |
| tree | b3c7fb843631a96adfb71ad79418d99ea0d3bb58 | |
| parent | 41205207a6366966bce000a91fc2f2115545485e (diff) | |
| parent | 268209ca8ec9d70f2e403da00663b50342902a71 (diff) | |
Merge "Pull submodules when running tox"
| -rw-r--r-- | docs/guides/onap-developer/how-to-use-docs/include-documentation.rst | 12 | ||||
| -rw-r--r-- | tox.ini | 10 |
2 files changed, 12 insertions, 10 deletions
diff --git a/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst b/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst index 4a7300d16..15d71d453 100644 --- a/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst +++ b/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst @@ -390,23 +390,15 @@ Download the DOC repository. git clone http://gerrit.onap.org/r/doc -Change directory to docs & install requirements. - -.. code-block:: bash - - cd doc - sudo pip install -r etc/requirements.txt - Update submodules, build documentation using tox & then open using any browser. .. code-block:: bash cd doc - git submodule update --depth 1 --init - tox -edocs + tox -elocal firefox docs/_build/html/index.html -.. note:: Make sure to run `tox -edocs` and not just `tox`. +.. note:: Make sure to run `tox -elocal` and not just `tox`. @@ -10,6 +10,16 @@ commands = echo "Generated docs available in {toxinidir}/docs/_build/html" whitelist_externals = echo +[testenv:local] +deps = -r{toxinidir}/etc/requirements.txt +commands = + git submodule update --depth 1 --init + sphinx-build -j 4 -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html + echo "Generated docs available in {toxinidir}/docs/_build/html" +whitelist_externals = + echo + git + [testenv:docs-linkcheck] deps = -r{toxinidir}/etc/requirements.txt commands = sphinx-build -j 4 -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck |