[Python-Dev] [Python-checkins] cpython (3.2): #14957: clarify splitlines docs. (original) (raw)

Tres Seaver tseaver at palladion.com
Fri Jun 8 13:20:55 CEST 2012


-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1

On 06/07/2012 08:55 AM, R. David Murray wrote:

On Thu, 07 Jun 2012 11:08:09 +0100, Sam Partington <sam.partington at gmail.com> wrote:

Wouldn't that be better written as a doctest and so avoid any other typos? Possibly, except (1) I don't think we currently actually test the doctests in the python docs and

FWIW, I've had a lot of success lately with automating testing of doctest snippets in Sphinx docs via::

$ /path/to/sphinx-build -b doctest
-d docs/_build/doctrees docs docs/_build/doctest

(That was from non-Python-core packages where the convention is that the Sphink docs are managed and built in the 'docs' subdirectory).

Tres. - --

Tres Seaver +1 540-429-0999 tseaver at palladion.com Palladion Software "Excellence by Design" http://palladion.com

-----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk/R4BAACgkQ+gerLs4ltQ426ACgzzr3WHWe8q/4QCdFJgOhYirU 9rAAoMcMZJ3ycPa6B0C4jqCihVdVY9f0 =rYxl -----END PGP SIGNATURE-----



More information about the Python-Dev mailing list