Merge pull request #310 from ilam/featuredoc

Looks good, thanks @ilam

Author: IanLee1521

docs/intro.rst

@@ -111,6 +111,33 @@ Or you can display how often each error was found::
   612     W601 .has_key() is deprecated, use 'in'
   1188    W602 deprecated form of raising exception
 
+You can also make pep8.py show the error text in different formats by using --format having options default/pylint/custom::
+
+  $ pep8 testsuite/E40.py --format=default
+  testsuite/E40.py:2:10: E401 multiple imports on one line
+
+  $ pep8 testsuite/E40.py --format=pylint
+  testsuite/E40.py:2: [E401] multiple imports on one line
+
+  $ pep8 testsuite/E40.py --format='%(path)s|%(row)d|%(col)d| %(code)s %(text)s'
+  testsuite/E40.py|2|10| E401 multiple imports on one line
+
+Variables in the ``custom`` format option
+
++----------------+------------------+
+| **Variable**   | **Significance** |
++================+==================+
+| ``path``       | File name        |
++----------------+------------------+
+| ``row``        | Row number       |
++----------------+------------------+
+| ``col``        | Column number    |
++----------------+------------------+
+| ``code``       | Error code       |
++----------------+------------------+
+| ``text``       | Error text       |
++----------------+------------------+
+
 Quick help is available on the command line::
 
   $ pep8 -h