Commits

offbyone committed ca644af

Documented the posargs syntax

  • Participants
  • Parent commits 3f471b7

Comments (0)

Files changed (1)

doc/example/general.txt

+.. be in -*- rst -*- mode!
+
 General tips and tricks
 ================================
 
     tox -- -x tests/test_something.py
 
 the arguments after the ``--`` will be substituted
-everywhere where you specify ``[...]`` in your
+everywhere where you specify ``{posargs}`` in your
 test commands, for example using ``py.test``::
 
     # in the testenv or testenv:NAME section of your tox.ini
     commands =
-        py.test []
+        py.test {posargs}
 
 or using ``nosetests``::
 
     commands =
-        nosetests []
+        nosetests {posargs}
 
 the above ``tox`` invocation will trigger the test runners to
 stop after the first failure and to only run a particular test file.
 
+You can specify defaults for the positional arguments using this
+syntax::
+
+    commands =
+        nosetests {posargs:--with-coverage}
 
 .. _`sphinx checks`:
 
     basepython=/my/path/to/python2.7
 
 .. include:: ../links.txt
-