Update docs logo to our current one, other minor fixes.

docs/source/interactive/reference.txt

@@ -325,25 +325,23 b' All options with a [no] prepended can be specified in negated form'
 Interactive use
 ===============
 
-IPython is meant to work as a drop-in
-replacement for the standard interactive interpreter. As such, any code
-which is valid python should execute normally under IPython (cases where
-this is not true should be reported as bugs). It does, however, offer
-many features which are not available at a standard python prompt. What
-follows is a list of these.
+IPython is meant to work as a drop-in replacement for the standard interactive
+interpreter. As such, any code which is valid python should execute normally
+under IPython (cases where this is not true should be reported as bugs). It
+does, however, offer many features which are not available at a standard python
+prompt. What follows is a list of these.
 
 
 Caution for Windows users
 -------------------------
 
-Windows, unfortunately, uses the '\\' character as a path
-separator. This is a terrible choice, because '\\' also represents the
-escape character in most modern programming languages, including
-Python. For this reason, using '/' character is recommended if you
-have problems with ``\``.  However, in Windows commands '/' flags
-options, so you can not use it for the root directory. This means that
-paths beginning at the root must be typed in a contrived manner like:
-``%copy \opt/foo/bar.txt \tmp``
+Windows, unfortunately, uses the '\\' character as a path separator. This is a
+terrible choice, because '\\' also represents the escape character in most
+modern programming languages, including Python. For this reason, using '/'
+character is recommended if you have problems with ``\``.  However, in Windows
+commands '/' flags options, so you can not use it for the root directory. This
+means that paths beginning at the root must be typed in a contrived manner
+like: ``%copy \opt/foo/bar.txt \tmp``
 
 .. _magic:
 
@@ -419,11 +417,11 b' following example defines a new magic command, %impall:'
 
     ip.expose_magic('impall', doimp)
 
-Type %magic for more information, including a list of all available
-magic functions at any time and their docstrings. You can also type
-%magic_function_name? (see sec. 6.4 <#sec:dyn-object-info> for
-information on the '?' system) to get information about any particular
-magic function you are interested in.
+Type `%magic` for more information, including a list of all available magic
+functions at any time and their docstrings. You can also type
+%magic_function_name? (see :ref:`below <dynamic_object_info` for information on
+the '?' system) to get information about any particular magic function you are
+interested in.
 
 The API documentation for the :mod:`IPython.core.magic` module contains the full
 docstrings of all currently available magic commands.
@@ -444,20 +442,20 b' PYTHONDOCS for this feature to work correctly.'
 Dynamic object information
 --------------------------
 
-Typing ?word or word? prints detailed information about an object. If
-certain strings in the object are too long (docstrings, code, etc.) they
-get snipped in the center for brevity. This system gives access variable
-types and values, full source code for any object (if available),
-function prototypes and other useful information.
+Typing ``?word`` or ``word?`` prints detailed information about an object. If
+certain strings in the object are too long (docstrings, code, etc.) they get
+snipped in the center for brevity. This system gives access variable types and
+values, full source code for any object (if available), function prototypes and
+other useful information.
 
-Typing ??word or word?? gives access to the full information without
+Typing ``??word`` or ``word??`` gives access to the full information without
 snipping long strings. Long strings are sent to the screen through the
 less pager if longer than the screen and printed otherwise. On systems
 lacking the less command, IPython uses a very basic internal pager.
 
 The following magic functions are particularly useful for gathering
 information about your working environment. You can get more details by
-typing %magic or querying them individually (use %function_name? with or
+typing ``%magic`` or querying them individually (use %function_name? with or
 without the %), this is just a summary:
 
     * **%pdoc <object>**: Print (or run through a pager if too long) the
@@ -476,21 +474,19 b' without the %), this is just a summary:'
       identifiers and %whos prints a table with some basic details about
       each identifier.
 
-Note that the dynamic object information functions (?/??, %pdoc, %pfile,
-%pdef, %psource) give you access to documentation even on things which
-are not really defined as separate identifiers. Try for example typing
-{}.get? or after doing import os, type os.path.abspath??.
-
+Note that the dynamic object information functions (?/??, ``%pdoc``,
+``%pfile``, ``%pdef``, ``%psource``) give you access to documentation even on
+things which are not really defined as separate identifiers. Try for example
+typing {}.get? or after doing import os, type ``os.path.abspath??``.
 
 .. _readline:
 
 Readline-based features
 -----------------------
 
-These features require the GNU readline library, so they won't work if
-your Python installation lacks readline support. We will first describe
-the default behavior IPython uses, and then how to change it to suit
-your preferences.
+These features require the GNU readline library, so they won't work if your
+Python installation lacks readline support. We will first describe the default
+behavior IPython uses, and then how to change it to suit your preferences.
 
 
 Command line completion
@@ -534,10 +530,10 b' Autoindent'
 IPython can recognize lines ending in ':' and indent the next line,
 while also un-indenting automatically after 'raise' or 'return'.
 
-This feature uses the readline library, so it will honor your ~/.inputrc
-configuration (or whatever file your INPUTRC variable points to). Adding
-the following lines to your .inputrc file can make indenting/unindenting
-more convenient (M-i indents, M-u unindents)::
+This feature uses the readline library, so it will honor your
+:file:`~/.inputrc` configuration (or whatever file your INPUTRC variable points
+to). Adding the following lines to your :file:`.inputrc` file can make
+indenting/unindenting more convenient (M-i indents, M-u unindents)::
 
     $if Python 
     "\M-i": "    "  
@@ -548,17 +544,19 b' Note that there are 4 spaces between the quote marks after "M-i" above.'
 
 .. warning::
 
-    Setting the above indents will cause problems with unicode text entry in the terminal.
+    Setting the above indents will cause problems with unicode text entry in
+    the terminal.
 
 .. warning::
 
-    Autoindent is ON by default, but it can cause problems with
-    the pasting of multi-line indented code (the pasted code gets
-    re-indented on each line). A magic function %autoindent allows you to
-    toggle it on/off at runtime. You can also disable it permanently on in
-    your :file:`ipython_config.py` file (set TerminalInteractiveShell.autoindent=False).
+    Autoindent is ON by default, but it can cause problems with the pasting of
+    multi-line indented code (the pasted code gets re-indented on each line). A
+    magic function %autoindent allows you to toggle it on/off at runtime. You
+    can also disable it permanently on in your :file:`ipython_config.py` file
+    (set TerminalInteractiveShell.autoindent=False).
     
-    If you want to paste multiple lines, it is recommended that you use ``%paste``.
+    If you want to paste multiple lines, it is recommended that you use
+    ``%paste``.
 
 
 Customizing readline behavior
@@ -617,10 +615,10 b' any code you wrote while experimenting. Log files are regular text files'
 which you can later open in your favorite text editor to extract code or
 to 'clean them up' before using them to replay a session.
 
-The %logstart function for activating logging in mid-session is used as
-follows:
+The `%logstart` function for activating logging in mid-session is used as
+follows::
 
-%logstart [log_name [log_mode]]
+    %logstart [log_name [log_mode]]
 
 If no name is given, it defaults to a file named 'ipython_log.py' in your
 current working directory, in 'rotate' mode (see below).
@@ -1274,7 +1272,6 b' sections for execution as a demo:'
 .. literalinclude:: ../../examples/lib/example-demo.py
     :language: python
 
-
 In order to run a file as a demo, you must first make a Demo object out
 of it. If the file is named myscript.py, the following code will make a
 demo::

docs/source/whatsnew/version0.11.txt

@@ -63,14 +63,6 b' A quick summary of the major changes (see below for details):'
   This requires some changes if you want to execute GUI-using scripts inside
   IPython, see :ref:`the GUI support section <gui_support>` for more details.
 
-* **Integration into Microsoft Visual Studio**. Thanks to the work of the
-  Microsoft `Python Tools for Visual Studio`__ team, this version of IPython
-  has been integrated into Microsoft Visual Studio's Python tools open source
-  plug-in.  `Details below`_
-
-.. __: http://pytools.codeplex.com
-.. _details below: ms_visual_studio_011_
-
 * **A two-process architecture.** The Qt console is the first example of using
   a new model that splits IPython between a kernel process where code is
   executed and a client that handles user interaction.  We plan on also
@@ -85,6 +77,21 b' A quick summary of the major changes (see below for details):'
   hope this (ongoing) restructuring will make it easier for new developers to
   join us.
 
+* **Vim integration**. Vim can be configured to seamlessly control an IPython
+  kernel, see the files in :file:`docs/examples/vim` for the full details.
+  This work was done by Paul Ivanov, who prepared a nice `video
+  demonstration`__ of the features it provides.
+
+.. __: http://pirsquared.org/blog/2011/07/28/vim-ipython/
+  
+* **Integration into Microsoft Visual Studio**. Thanks to the work of the
+  Microsoft `Python Tools for Visual Studio`__ team, this version of IPython
+  has been integrated into Microsoft Visual Studio's Python tools open source
+  plug-in.  `Details below`_
+
+.. __: http://pytools.codeplex.com
+.. _details below: ms_visual_studio_011_
+
 * **Improved unicode support**. We closed many bugs related to unicode input.
 
 * **Python 3**. IPython now runs on Python 3.x. See :ref:`python3_011` for
@@ -103,12 +110,6 b' A quick summary of the major changes (see below for details):'
   can have its attributes set either via files that now use real Python syntax
   or from the command-line.
 
-* **Vim integration**. Vim can be configured to seamlessly control an IPython
-  kernel, see the files in :file:`docs/examples/vim` for the full details.
-  This work was done by Paul Ivanov, who prepared a nice `video
-  demonstration`__ of the features it provides.
-
-.. __: http://pirsquared.org/blog/2011/07/28/vim-ipython/
 
 Authors and support
 -------------------
@@ -191,11 +192,14 b" list). Github's pull requests are a fantastic mechanism for reviewing code and"
 building a shared ownership of the project, and we are making enthusiastic use
 of it.
 
-Note: this undercounts the number of issues closed in this development cycle,
-since we only moved to github for issue tracking in May 2010, but we have no
-way of collecting statistics on the number of issues closed in the old
-Launchpad bug tracker prior to that.
+.. Note::
 
+   This undercounts the number of issues closed in this development cycle,
+   since we only moved to github for issue tracking in May 2010, but we have no
+   way of collecting statistics on the number of issues closed in the old
+   Launchpad bug tracker prior to that.
+
+   
 .. _qtconsole_011:
 
 Qt Console
@@ -250,9 +254,9 b' reference docs.'
 Refactoring
 -----------
 
-As of the 0.11 version of IPython, a signifiant portion of the core has been
-refactored.  This refactoring is founded on a number of new abstractions.
-The main new classes that implement these abstractions are:
+As of this release, a signifiant portion of IPython has been refactored.  This
+refactoring is founded on a number of new abstractions.  The main new classes
+that implement these abstractions are:
 
 * :class:`IPython.utils.traitlets.HasTraits`.
 * :class:`IPython.config.configurable.Configurable`.
@@ -274,8 +278,8 b" a leading '-', nor a space separating key from value. Flags exist, to set"
 multiple values or boolean flags, and these are always prefixed with '--', and
 never take arguments.
 
-ZMQ architecture
-----------------
+ZeroMQ architecture
+-------------------
 
 There is a new GUI framework for IPython, based on a client-server model in
 which multiple clients can communicate with one IPython kernel, using the
@@ -331,10 +335,10 b' Microsoft Visual Studio`__, as seen here:'
 
 The Microsoft team developing this currently has a release candidate out using
 IPython 0.11. We will continue to collaborate with them to ensure that as they
-approach full release time, the integration with IPython is as smooth as
-possible.  We'd like to thank Dino Viehland and Shahrokh Mortazavi for the work
-they have done towards this feature, as well as Wenming Ye for his support of
-our WinHPC features.
+approach their final release date, the integration with IPython remains smooth.
+We'd like to thank Dino Viehland and Shahrokh Mortazavi for the work they have
+done towards this feature, as well as Wenming Ye for his support of our WinHPC
+capabilities.
 
 .. __: http://pytools.codeplex.com