Small cleanups and documentation to testing support code.

Closes  #324: I checked and by now all the tools in our testing/
directory are really used, over the last few months we cleaned up most
of what wasn't used.

IPython/testing/nosepatch.py

@@ -3,7 +3,12 b''
 By default, nose's ismethod() fails for static methods.
 Once this is fixed in upstream nose we can disable it.
 
-Note: merely importing this module causes the monkeypatch to be applied."""
+Notes: 
+
+- As of Nose 1.0.0, the problem persists so this monkeypatch is still
+needed.
+
+- Merely importing this module causes the monkeypatch to be applied."""
 
 #-----------------------------------------------------------------------------
 #  Copyright (C) 2009-2011  The IPython Development Team

IPython/testing/skipdoctest.py

@@ -1,11 +1,27 b''
-"""This decorator marks that a doctest should be skipped.
+"""Decorators marks that a doctest should be skipped, for both python 2 and 3.
 
 The IPython.testing.decorators module triggers various extra imports, including
 numpy and sympy if they're present. Since this decorator is used in core parts
 of IPython, it's in a separate module so that running IPython doesn't trigger
 those imports."""
+
+#-----------------------------------------------------------------------------
+#  Copyright (C) 2009-2011  The IPython Development Team
+#
+#  Distributed under the terms of the BSD License.  The full license is in
+#  the file COPYING, distributed as part of this software.
+#-----------------------------------------------------------------------------
+
+#-----------------------------------------------------------------------------
+# Imports
+#-----------------------------------------------------------------------------
+
 import sys
 
+#-----------------------------------------------------------------------------
+# Decorators
+#-----------------------------------------------------------------------------
+
 def skip_doctest(f):
     """Decorator - mark a function or method for skipping its doctest.
 
@@ -15,6 +31,7 b' def skip_doctest(f):'
     f.skip_doctest = True
     return f
 
+
 def skip_doctest_py3(f):
     """Decorator - skip the doctest under Python 3."""
     f.skip_doctest = (sys.version_info[0] >= 3)