diff options
| author | Chris McDonough <chrism@plope.com> | 2012-07-05 10:47:29 -0400 |
|---|---|---|
| committer | Chris McDonough <chrism@plope.com> | 2012-07-05 10:47:29 -0400 |
| commit | be12b7487148150a13eaa1bb3b3d35b96954aefa (patch) | |
| tree | 0cb4701170c2d68126ad98f7fa15e8c2be4b8742 | |
| parent | 19fc6c0f9766a4337a2adf2dba66aeb812afb580 (diff) | |
| parent | e4918905845870bde25c07625b895074f66de790 (diff) | |
| download | pyramid-be12b7487148150a13eaa1bb3b3d35b96954aefa.tar.gz pyramid-be12b7487148150a13eaa1bb3b3d35b96954aefa.tar.bz2 pyramid-be12b7487148150a13eaa1bb3b3d35b96954aefa.zip | |
Merge branch 'master' of github.com:Pylons/pyramid
| -rw-r--r-- | HACKING.txt | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/HACKING.txt b/HACKING.txt index dd735bf22..38c263ed7 100644 --- a/HACKING.txt +++ b/HACKING.txt @@ -127,13 +127,19 @@ using to develop Pyramid): 1. Run ``$yourvenv/bin/python setup.py dev docs``. This will cause Sphinx and all development requirements to be installed in your virtualenv. -2. cd to the ``docs`` directory within your Pyramid checkout and execute +2. Update all git submodules from the top-level of your Pyramid checkout, like + so: + git submodule update --init --recursive + This will checkout theme subrepositories and prevent error conditions when + HTML docs are generated. + +3. cd to the ``docs`` directory within your Pyramid checkout and execute ``make clean html SPHINXBUILD=$yourvenv/bin/sphinx-build``. The ``SPHINXBUILD=...`` hair is there in order to tell it to use the virtualenv Python, which will have both Sphinx and Pyramid (for API documentation generation) installed. -3. Open the ``docs/_build/html/index.html`` file to see the resulting HTML +4. Open the ``docs/_build/html/index.html`` file to see the resulting HTML rendering. Change Log |