update README before release

DEVGUIDE.rst

@@ -142,4 +142,4 @@ These are note for myself (Giampaolo):
 - upload updated doc on http://pythonhosted.org/psutil with ``make upload-doc``.
 - GIT tag the new release with ``make git-tag-release`` and push it with
   ``git push --follow-tags``.
-- post on psutil and python-announce mailing lists.
+- post on psutil and python-announce mailing lists, twitter, g+, blog.

HISTORY.rst

@@ -1,6 +1,6 @@
 Bug tracker at https://github.com/giampaolo/psutil/issues
 
-3.1.0 - XXXX-XX-XX
+3.1.0 - 2015-07-15
 ==================
 
 **Enhancements**

README.rst

@@ -350,6 +350,7 @@ http://groups.google.com/group/psutil/
 Timeline
 ========
 
+- 2015-07-15: `psutil-3.1.0.tar.gz <https://pypi.python.org/packages/source/p/psutil/psutil-3.1.0.tar.gz>`_
 - 2015-06-18: `psutil-3.0.1.tar.gz <https://pypi.python.org/packages/source/p/psutil/psutil-3.0.1.tar.gz>`_
 - 2015-06-13: `psutil-3.0.0.tar.gz <https://pypi.python.org/packages/source/p/psutil/psutil-3.0.0.tar.gz>`_
 - 2015-02-02: `psutil-2.2.1.tar.gz <https://pypi.python.org/packages/source/p/psutil/psutil-2.2.1.tar.gz>`_

docs/index.rst

@@ -1073,7 +1073,11 @@ Process class
        a thread and kills it if it's not responding after 100ms.
        That implies that on Windows this method is not guaranteed to enumerate
        all regular file handles (see full discusion
-       `here <https://github.com/giampaolo/psutil/pull/597>`__).
+       `here <https://github.com/giampaolo/psutil/pull/597>`_).
+
+     .. warning::
+       on FreeBSD this method can return files with a 'null' path (see
+       `issue 595 <https://github.com/giampaolo/psutil/pull/595>`_).
 
      .. versionchanged:: 3.1.0 no longer hangs on Windows.