From 68d2a8cf14b940ffac796be663baeb0782640310 Mon Sep 17 00:00:00 2001
From: Tom Lazar <tomster@pyfidelity.com>
Date: Sat, 17 Aug 2013 16:08:43 +0200
Subject: provide the tox url when mentioning it first.

---
 HACKING.txt | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/HACKING.txt b/HACKING.txt
index 563903f2f..2e444e781 100644
--- a/HACKING.txt
+++ b/HACKING.txt
@@ -23,7 +23,8 @@ checkout.
 Since pyramid is a framework and not an application, it can be
 convenient to work against a sample application, preferably in its
 own virtualenv. A quick way to achieve this is to (ab-)use ``tox``
-with a custom configuration file that's part of the checkout::
+(http://codespeak.net/~hpk/tox/) with a custom configuration file that's part of
+the checkout::
 
   tox -c hacking-tox.ini
 
-- 
cgit v1.2.3


From 98b383ef54d16c977561101dde1addd34ba34240 Mon Sep 17 00:00:00 2001
From: Tom Lazar <tomster@pyfidelity.com>
Date: Sat, 17 Aug 2013 16:09:58 +0200
Subject: adjust the checkout path to the new value set above in a previous
 commit

---
 HACKING.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/HACKING.txt b/HACKING.txt
index 2e444e781..d664d6bfc 100644
--- a/HACKING.txt
+++ b/HACKING.txt
@@ -126,7 +126,7 @@ Running Tests
   example::
 
    $ /usr/bin/easy_install tox
-   $ cd ~/hack-on-pyramid/pyramid
+   $ cd ~/hack-on-pyramid/
    $ /usr/bin/tox
 
 Test Coverage
-- 
cgit v1.2.3


From 50f23dd4fb2ea8690893ac2cf20a0f0483b32a0d Mon Sep 17 00:00:00 2001
From: Tom Lazar <tomster@pyfidelity.com>
Date: Sat, 17 Aug 2013 16:10:45 +0200
Subject: include and mention the `nose-selecttests
 <https://pypi.python.org/pypi/nose-selecttests/>`_ plugin

---
 HACKING.txt | 10 +++++++---
 setup.py    |  1 +
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/HACKING.txt b/HACKING.txt
index d664d6bfc..0d28905b6 100644
--- a/HACKING.txt
+++ b/HACKING.txt
@@ -112,9 +112,13 @@ Coding Style
 Running Tests
 --------------
 
-- To run tests for Pyramid on a single Python version, run ``python setup.py
-  test`` against the Python interpreter from virtualenv into which
-  you've ``setup.py develop``-ed Pyramid.
+- To run all tests for Pyramid on a single Python version, run ``nosetests`` from
+  your development virtualenv (See *Using a Development Checkout* above).
+
+- To run individual tests (i.e. during development) you can use a regular
+  expression with the ``-t`` parameter courtesy of the `nose-selecttests
+  <https://pypi.python.org/pypi/nose-selecttests/>`_ plugin that's been installed (along with nose itself) via ``python setup.py dev``. The easiest usage is to
+  simply provide the verbatim name of the test you're working on.
 
 - To run the full set of Pyramid tests on all platforms, install ``tox``
   (http://codespeak.net/~hpk/tox/) into a system Python.  The ``tox`` console
diff --git a/setup.py b/setup.py
index 60b20b069..64e63956e 100644
--- a/setup.py
+++ b/setup.py
@@ -65,6 +65,7 @@ docs_extras = [
 
 testing_extras = tests_require + [
     'nose',
+    'nose-selecttests',
     'coverage',
     'virtualenv', # for scaffolding tests
     ]
-- 
cgit v1.2.3