Message115520
It seems there are three ways of testing the docs:
1) ./python -m doctest Doc/library/json.rst
2) make doctest (a.k.a. sphinx-build -b doctest)
3) http://sphinx.pocoo.org/ext/doctest.html
Manually running 1) or 2) and fixing things seems okay for a first step, and when everything is fixed, we could add automation to prevent regressions. Georg is in the best place to say how to do it (through a thin test_docs.py integration layer between doctest and regrtest, with sphinx.ext.doctest, or by editing the test target of the makefile to run make doctest -C Doc). |
|
Date |
User |
Action |
Args |
2010-09-03 22:29:14 | eric.araujo | set | recipients:
+ eric.araujo, georg.brandl, terry.reedy, orsenthil, pitrou, stutzbach, ezio.melotti, r.david.murray, Dmitry.Jemerov, docs@python, JingCheng.LIU |
2010-09-03 22:29:14 | eric.araujo | set | messageid: <1283552954.47.0.946257612507.issue9730@psf.upfronthosting.co.za> |
2010-09-03 22:29:12 | eric.araujo | link | issue9730 messages |
2010-09-03 22:29:12 | eric.araujo | create | |
|