Minor doc updates, ensure README is in final tarball.

MANIFEST.in

@@ -1,36 +1,37 b''
+include README.rst
 include ipython.py
 include setup2.py
 include setup3.py
 include setupbase.py
 include setupegg.py
 
 graft setupext
 
 graft scripts
 
 # Load main dir but exclude things we don't want in the distro
 graft IPython
 prune IPython/deathrow
 prune IPython/frontend/html/notebook/static/mathjax
 
 # Include some specific files and data resources we need
 include IPython/.git_commit_info.ini
 include IPython/frontend/qt/console/resources/icon/IPythonConsole.svg
 
 # Documentation
 graft docs
 exclude docs/\#*
 exclude docs/man/*.1
 
 # docs subdirs we want to skip
 prune docs/attic
 prune docs/build
 prune docs/gh-pages
 prune docs/dist
 
 # Patterns to exclude from any directory
 global-exclude *~
 global-exclude *.flc
 global-exclude *.pyc
 global-exclude *.pyo
 global-exclude .dircopy.log

README.rst

@@ -1,31 +1,31 b''
 ===========================================
  IPython: Productive Interactive Computing
 ===========================================
 
 Overview
 ========
 
-Welcome to IPython. Our full documentation, including PDF versions of our
-manual, is available on `our website <http://ipython.org/documentation.html>`_;
-if you downloaded a built source distribution the ``docs/html`` directory
-contains an HTML version of the manual.  The ``docs/source`` directory contains
-the plaintext version of these manuals.
+Welcome to IPython.  Our full documentation is available on `our website
+<http://ipython.org/documentation.html>`_; if you downloaded a built source
+distribution the ``docs/source`` directory contains the plaintext version of
+these manuals.  If you have Sphinx installed, you can build them by typing
+``make html`` for local browsing.
 
 
 Dependencies and supported Python versions
 ==========================================
 
 For full details, see the installation section of the manual.  The basic parts
 of IPython only need the Python standard library, but much of its more advanced
 functionality requires extra packages.
 
 Officially, IPython requires Python version 2.6, 2.7, or 3.1 and above.
 
     
 Instant running
 ===============
 
 You can run IPython from this directory without even installing it system-wide
 by typing at the terminal::
 
    $ python ipython.py