Author georg.brandl
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:57:15
SpamBayes Score 0.00647528
Marked as misclassified No
Message-id <1283554637.01.0.167836774867.issue9730@psf.upfronthosting.co.za>
In-reply-to
Content
>> Generally: +1 on making sure examples in the docs are up to date.  If
>> someone wants to do the tedious work of making sure that a "make
>> doctest" succeeds, I'm all for it, it may involve adding a few (in
>> HTML output invisible) testsetup blocks.
> 
> I'm not sure that's a good idea. It may add a lot of spurious imports
> which only make the examples longer and less readable.

That's why I said to use "testsetup" directives -- they are not visible in the HTML/PDF/... output, but used when running the tests.
History
Date User Action Args
2010-09-03 22:57:17georg.brandlsetrecipients: + georg.brandl, terry.reedy, orsenthil, pitrou, stutzbach, ezio.melotti, eric.araujo, r.david.murray, Dmitry.Jemerov, docs@python, JingCheng.LIU
2010-09-03 22:57:17georg.brandlsetmessageid: <1283554637.01.0.167836774867.issue9730@psf.upfronthosting.co.za>
2010-09-03 22:57:15georg.brandllinkissue9730 messages
2010-09-03 22:57:15georg.brandlcreate