Merge branch 'issue-315'

1 files changed, 11 insertions, 2 deletions

diff --git a/docs/intro.rst b/docs/intro.rst
index b5e3971..a5da86a 100644
--- a/docs/intro.rst
+++ b/docs/intro.rst
@@ -185,8 +185,17 @@ Configuration
 
 The behaviour may be configured at two levels.
 
-The user settings are read from the ``~/.config/pep8`` file and
-for Windows from the ``~\.pep8`` file.
+The user settings are read from the following locations:
+
+If on Windows:
+    ``~\.pep8``
+
+Otherwise, if the :envvar:`XDG_CONFIG_HOME` environment variable is defined:
+    ``XDG_CONFIG_HOME/pep8``
+
+Else if :envvar:`XDG_CONFIG_HOME` is not defined:
+    ``~/.config/pep8``
+
 Example::
 
   [pep8]