Re: [Python-Dev] [Python-checkins] r87296 - python/branches/py3k/Doc/library/test.rst
On 16 December 2010 00:23, eric.araujo
Author: eric.araujo Date: Thu Dec 16 01:23:30 2010 New Revision: 87296
Log: Advertise “python -m” instead of direct filename.
Modified: python/branches/py3k/Doc/library/test.rst
Modified: python/branches/py3k/Doc/library/test.rst
============================================================================== --- python/branches/py3k/Doc/library/test.rst (original) +++ python/branches/py3k/Doc/library/test.rst Thu Dec 16 01:23:30 2010 @@ -168,14 +168,14 @@
Running :mod:`test.regrtest` directly allows what resources are available for tests to use to be set. You do this by using the ``-u`` command-line -option. Run :program:`python regrtest.py -uall` to turn on all +option. Run :program:`python -m regrtest -uall` to turn on all
Shouldn't this be `python -m test.regrtest`, or even just `python -m test`? Michael
resources; specifying ``all`` as an option for ``-u`` enables all possible resources. If all but one resource is desired (a more common case), a comma-separated list of resources that are not desired may be listed after -``all``. The command :program:`python regrtest.py -uall,-audio,-largefile` +``all``. The command :program:`python -m regrtest -uall,-audio,-largefile` will run :mod:`test.regrtest` with all resources except the ``audio`` and ``largefile`` resources. For a list of all resources and more command-line -options, run :program:`python regrtest.py -h`. +options, run :program:`python -m regrtest -h`.
Some other ways to execute the regression tests depend on what platform the tests are being executed on. On Unix, you can run :program:`make test` at the _______________________________________________ Python-checkins mailing list Python-checkins@python.org http://mail.python.org/mailman/listinfo/python-checkins
-option. Run :program:`python regrtest.py -uall` to turn on all +option. Run :program:`python -m regrtest -uall` to turn on all
Shouldn't this be `python -m test.regrtest`, or even just `python -m test`?
It should :) I was about to fix just that but then noticed I could remove more references to regrtest (after all just an implementation detail), so I rewrote the section title and first few lines of the section. My stupid email client forces rewrapping, so I’m attaching the diff as a separate file. I can repost the patch to the tracker if it’s inconvenient to review in email, but I’d like to commit soon since I have a big doc merge to do after this :) Best regards
On 16/12/2010 01:07, Éric Araujo wrote:
-option. Run :program:`python regrtest.py -uall` to turn on all +option. Run :program:`python -m regrtest -uall` to turn on all Shouldn't this be `python -m test.regrtest`, or even just `python -m test`? It should :) I was about to fix just that but then noticed I could remove more references to regrtest (after all just an implementation detail), so I rewrote the section title and first few lines of the section.
My stupid email client forces rewrapping, so I’m attaching the diff as a separate file. I can repost the patch to the tracker if it’s inconvenient to review in email, but I’d like to commit soon since I have a big doc merge to do after this :)
The diff looks good to me. All the best, Michael
Best regards
-- http://www.voidspace.org.uk/ May you do good and not evil May you find forgiveness for yourself and forgive others May you share freely, never taking more than you give. -- the sqlite blessing http://www.sqlite.org/different.html
participants (2)
-
Michael Foord
-
Éric Araujo