diff options
author | Eli Collins <elic@assurancetechnologies.com> | 2011-08-17 11:53:43 -0400 |
---|---|---|
committer | Eli Collins <elic@assurancetechnologies.com> | 2011-08-17 11:53:43 -0400 |
commit | 34baa52786c19344c29d3a9e20d2348bf280c729 (patch) | |
tree | 109709ab5fc8c1393dee02b7bb5797a12f40497a /docs | |
parent | f3a121563512d51133cbacf50c96b1a3dccde31d (diff) | |
download | passlib-34baa52786c19344c29d3a9e20d2348bf280c729.tar.gz |
documentation building should now be done through 'setup.py build_sphinx';
changed instructions accordingly;
also added 'docdist' setup command to build doc zip files
Diffstat (limited to 'docs')
-rw-r--r-- | docs/install.rst | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/docs/install.rst b/docs/install.rst index 4bb4558..4d13b9d 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -66,14 +66,14 @@ and are designed to be run using the Once PassLib and Nose have been installed, the tests may be run from the source directory:: # to run the platform-relevant tests... - nosetests -v passlib/tests + nosetests -v --tests passlib/tests # to run all tests... - PASSLIB_TESTS="all" nosetests -v passlib/tests + PASSLIB_TESTS="all" nosetests -v --tests passlib/tests # to run nose with the optional coverage plugin... # (results will be in build/coverage) - PASSLIB_TESTS="all" nosetests -v passlib/tests --with-coverage \ + PASSLIB_TESTS="all" nosetests -v --tests passlib/tests --with-coverage \ --cover-package=passlib --cover-html --cover-html-dir build/coverage (There will be a large proportion of skipped tests, this is normal). @@ -86,9 +86,11 @@ online at `<http://packages.python.org/passlib>`_. If you wish to generate your own copy of the documentation, you will need to: -1. install `Sphinx <http://sphinx.pocoo.org/>`_ (1.0 or better) -2. install the `Cloud Sphinx Theme <http://packages.python.org/cloud_sptheme>`_. -3. download the PassLib source -4. from the PassLib source directory, run :samp:`python docs/make.py clean html`. -5. Once Sphinx completes it's run, point a web browser to the file at :samp:`{$SOURCE}/docs/_build/html/index.html` +1. Install `Sphinx <http://sphinx.pocoo.org/>`_ (1.0 or better) +2. Install the `Cloud Sphinx Theme <http://packages.python.org/cloud_sptheme>`_. +3. Download the PassLib source +4. From the PassLib source directory, run :samp:`python setup.py build_sphinx`. +5. Once Sphinx completes it's run, point a web browser to the file at :samp:`{$SOURCE}/build/sphinx/html/index.html` to access the PassLib documentation in html format. +6. Alternately, steps 4 & 5 can be replaced by running :samp:`python setup.py docdist`, + which will build a zip file of the documentation in :samp:`{$SOURCE}/dist`.
\ No newline at end of file |