Document constraints.txt usage.

CHANGELOG

@@ -11,6 +11,7 @@
 	where they are not used.
 - #326: Fix OSError 'Not a directory' when creating env on Jython 2.7.0.
         Thanks Nick Douma (@LordGaav).
+- #585: Add documentation for constraints.txt
 
 2.7.0
 -----

CONTRIBUTORS

@@ -49,3 +49,4 @@ Nick Douma
 Cyril Roelandt
 Bartolome Sanchez Salado
 Laszlo Vasko
+Alexander Loechel

doc/example/basic.txt

@@ -82,20 +82,38 @@ configuration::
 
 .. _multiindex:
 
-depending on requirements.txt
+depending on requirements.txt or defining constraints
 -----------------------------------------------
 
 .. versionadded:: 1.6.1
 
-(experimental) If you have a ``requirements.txt`` file
-you can add it to your ``deps`` variable like this::
+(experimental) If you have a ``requirements.txt`` file or a ``constraints.txt`` file you can add it to your ``deps`` variable like this:
+
+.. code-block:: ini
 
     deps = -rrequirements.txt
 
-All installation commands are executed using ``{toxinidir}``
-(the directory where ``tox.ini`` resides) as the current
-working directory.  Therefore, the underlying ``pip`` installation
-will assume ``requirements.txt`` to exist at ``{toxinidir}/requirements.txt``.
+or
+
+.. code-block:: ini
+
+    deps = -cconstraints.txt
+
+or
+
+.. code-block:: ini
+
+    deps = -rrequirements.txt -cconstraints.txt
+
+All installation commands are executed using ``{toxinidir}`` (the directory where ``tox.ini`` resides) as the current working directory.
+Therefore, the underlying ``pip`` installation will assume ``requirements.txt`` or ``constraints.txt`` to exist at ``{toxinidir}/requirements.txt`` or ``{toxinidir}/contrains.txt``.
+
+This is actually a side effect that all elements of the dependency list is directly passed to ``pip``.
+
+For more details on ``requirements.txt`` files or ``constraints.txt`` files please see:
+
+* https://pip.pypa.io/en/stable/user_guide/#requirements-files
+* https://pip.pypa.io/en/stable/user_guide/#constraints-files
 
 using a different default PyPI url
 -----------------------------------------------