do not use deprecated compiler module

At least in Python versions >= 2.6, fixes #115
make nose.util.isgenerator() work on Python 3

- True if either a generator expr or a generator function
- isgenerator() to use existing UnboundMethod workaround
Fix spelling option names in docstring

The cover-package option and environment variable name in the docstring
are spelled with a plural, whereas the actual names are not. Trying to
use the plural version results in a `nose.config.ConfigError`.
replace 'pep08' with 'PEP 8'
Use sphinx PEP reference
Make test_multiprocessing.test_keyboardinterrupt much more reliable.

It turns out that even under Linux, start up times for subprocesses can
vary considerably.  As with most threading/multiprocess-based solutions,
sleep() proves to be an inadequate solution to knowing when to send a
signal to interrupt a waiting process.  We may end up sending the kill
signal before the child process is on the right statement, causing some
assertions to fail in our tests.

Instead, let's introduce the concept of a kill file in these tests.  The
kill file will be generated by the unit-under-test, and we'll wait for
them to show up.  This works much better since the kill file is created
just before the sleep() in the unit-under-test.  Once we detect the kill
file, then we can remove it, and fire off the signal.  Where I was
seeing random failures before, I no longer see them now.
Merge pull request #659 from jszakmeister/use-killfile-for-keyboardinterrupt-test

Make test_multiprocessing.test_keyboardinterrupt much more reliable.
Merge pull request #651 from zr40/patch-1

replace 'pep08' with 'PEP 8'
Merge pull request #650 from bwbaugh/cover-docstring

Fix spelling option names in docstring
Fix include directive in autoplugin_directive.

It appears that the include directive does not like absolute paths, and
ends up stripping the leading '/'.  This means that it fails to find the
python module, and warns in the Sphinx build.

Instead of using an absolute path, let's formulate a relative path using
docutils.utils.relative_path().  Since the path needs to be relative to
the document, let's pull that from state_machine.document['source'].
Merge pull request #648 from kimscheibel/master

Do not use deprecated compiler module.
Fix docs describing the arguments of formatFailure and formatError

- emphasize that the error tuple has to be returned even if it is not
  modified.
- remove highly misleading note about returning the test arg.
Merge pull request #492 from abeld/formatFailure-doc-fixes

Fix docs describing the arguments of formatFailure and formatError
Fix line in nosetests.1 being treated as man directive

This is actually a bug in Docutils, but here we work it around
until it is properly fixed.
Use Sphinx manpage writer instead of Docutils one

And update Makefile accordingly.
Remove docinfo from man.rst, not needed with Sphinx builder
Regenerate the man page
Merge pull request #642 from mitya57/manpage-formatting

Add manpage building support to conf.py, and fix formatting errors
Remove manpage and manbuilder in favor of Sphinx's man page builder.
Grab the version number from nose itself for use in the documentation.

This makes it one less place you have to remember to tweak the version.
The man page was regenerated to reflect the new version number.