gistfile1.txt

$ git clone https://github.com/stackforge/doc8
$ cd doc8
$ virtualenv test
$ source test/bin/activate
$ pip install -r requirements.txt
$ python
Python 2.7.6 (default, Mar 22 2014, 22:59:56) 
[GCC 4.8.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import restructuredtext_lint as rl
>>> path = './doc/source/index.rst'
>>> print([e.message for e in rl.lint_file(path)])
[u'No directive entry for "toctree" in module "docutils.parsers.rst.languages.en".\nTrying "toctree" as canonical directive name.', u'Unknown directive type "toctree".', u'No role entry for "ref" in module "docutils.parsers.rst.languages.en".\nTrying "ref" as canonical role name.', u'Unknown interpreted text role "ref".', u'No role entry for "ref" in module "docutils.parsers.rst.languages.en".\nTrying "ref" as canonical role name.', u'Unknown interpreted text role "ref".', u'No role entry for "ref" in module "docutils.parsers.rst.languages.en".\nTrying "ref" as canonical role name.', u'Unknown interpreted text role "ref".']