Author eric.araujo
Recipients Dmitry.Jemerov, JingCheng.LIU, docs@python, eric.araujo, ezio.melotti, georg.brandl, orsenthil, pitrou, r.david.murray, stutzbach, terry.reedy
Date 2010-09-03.22:29:12
SpamBayes Score 0.000797581
Marked as misclassified No
Message-id <1283552954.47.0.946257612507.issue9730@psf.upfronthosting.co.za>
In-reply-to
Content
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).
History
Date User Action Args
2010-09-03 22:29:14eric.araujosetrecipients: + 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:14eric.araujosetmessageid: <1283552954.47.0.946257612507.issue9730@psf.upfronthosting.co.za>
2010-09-03 22:29:12eric.araujolinkissue9730 messages
2010-09-03 22:29:12eric.araujocreate