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

[Tres Seaver]

-----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-----