ipython.rst: clean the markup, warnings only exist in redundant parts

doc/source/ipython.rst

@@ -1035,7 +1035,7 b' Regular Options'
 After the above threading options have been given, regular options can
 follow in any order. All options can be abbreviated to their shortest
 non-ambiguous form and are case-sensitive. One or two dashes can be
-used. Some options have an alternate short form, indicated after a |.
+used. Some options have an alternate short form, indicated after a ``|``.
 
 Most options can also be set from your ipythonrc configuration file. See
 the provided example for more details on what the options do. Options
@@ -1373,6 +1373,7 b' typing %magic at the prompt, but that will also give you information'
 about magic commands you may have added as part of your personal
 customizations.
 
+::
 
 	%Exit: Exit IPython without confirmation.
 	
@@ -1712,8 +1713,8 b' Arguments:'
 	
 	If arguments are given, the following possibilites exist:
 	
-    - The arguments are numbers or pairs of colon-separated numbers (like 1
-    4:8 9). These are interpreted as lines of previous input to be loaded
+	    - The arguments are numbers or pairs of dash-separated numbers (like 1
+	      4-8 9). These are interpreted as lines of previous input to be loaded
 	      into the editor. The syntax is the same of the %macro command.
 	
 	    - If the argument doesn't start with a number, it is evaluated as a
@@ -1735,7 +1736,7 b' editors (like kedit and gedit up to Gnome 2.8) do not understand the'
 	'+NUMBER' parameter necessary for this feature. Good editors like
 	(X)Emacs, vi, jed, pico and joe all do.
 	
-- If the argument is not found as a variable, IPython will look for a
+	If the argument is not found as a variable, IPython will look for a
 	file with that name (adding .py if necessary) and load it into the
 	editor. It will execute its contents with execfile() when you exit,
 	loading any code in the file into your interactive namespace.
@@ -2200,9 +2201,9 b' this system, only pure python code and magic commands.'
 	This version explicitly checks that every entry in $PATH is a file with
 	execute access (os.X_OK), so it is much slower than %rehash.
 	
-Under Windows, it checks executability as a match agains a '|'-separated
+	Under Windows, it checks executability as a match agains a ``|``-separated
 	string of extensions, stored in the IPython config variable
-win_exec_ext. This defaults to 'exe|com|bat'.
+	win_exec_ext. This defaults to ``exe|com|bat``.
 	
 	This function also resets the root module cache of module completer,
 	used on slow filesystems.
@@ -2611,6 +2612,7 b' If called without arguments, acts as a toggle.'
 
 
 Access to the standard Python help
+----------------------------------
 
 As of Python 2.1, a help system is available with access to object
 docstrings and the Python manuals. Simply type 'help' (no quotes) to
@@ -2622,6 +2624,7 b' your environment variable 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
@@ -2663,6 +2666,7 b' are not really defined as separate identifiers. Try for example typing'
 
 
 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
@@ -3118,7 +3122,7 b' Each of these options may appear as many times as you need it in the file.'
     * [import_some <mod> <f1> <f2> ...:] import functions with 'from
       <mod> import <f1>,<f2>,...'
     * [import_all <mod1> <mod2> ...:] for each module listed import
-      functions with 'from <mod> import *'
+      functions with ``from <mod> import *``.
     * [execute <python code>:] give any single-line python code to be
       executed.
     * [execfile <filename>:] execute the python file given with an
@@ -3848,7 +3852,7 b' default prompts::'
     prompt_in2 '   .\D.:' 
     prompt_out 'Out[\#]:'
 
-which look like this:
+which look like this::
 
     In [1]: 1+2 
     Out[1]: 3
@@ -4304,6 +4308,7 b" Physics.PhysicalQuantities from Konrad Hinsen's ScientificPython"
 The Physics.PhysicalQuantities module defines PhysicalQuantity objects,
 but these must be declared as instances of a class. For example, to
 define v as a velocity of 3 m/s, normally you would write::
+
     In [1]: v = PhysicalQuantity(3,'m/s')
 
 Using the PhysicalQ_Input extension this can be input instead as: 
@@ -4352,19 +4357,13 b' commands instead of as Python code. The special escapes below are also'
 recognized. !cmd is valid in single or multi-line input, all others are
 only valid in single-line input::
 
-*!cmd*
+	!cmd
 	    pass 'cmd' directly to the shell 
-*!!cmd*
+	!!cmd*
 	    execute 'cmd' and return output as a list (split on '\n') 
-*var=!cmd
+	var=!cmd
 	    capture output of cmd into var, as a string list
 
-The $/$$ syntaxes make Python variables from system output, which you
-can later use for further scripting. The converse is also possible: when
-executing an alias or calling to the system via !/!!, you can expand any
-python variable or expression by prepending it with $. Full details of
-the allowed syntax can be found in Python's PEP 215.
-
 A few brief examples will illustrate these (note that the indentation
 below may be incorrectly displayed)::
 
@@ -4469,8 +4468,9 b" switching to any of them. Type 'cd?' for more details."
 
 
 Prompt customization
+--------------------
 
-The supplied ipythonrc-pysh profile comes with an example of a very
+The supplied ipy_profile_sh.py profile comes with an example of a very
 colored and detailed prompt, mainly to serve as an illustration. The
 valid escape sequences, besides color names, are:
 
@@ -4595,8 +4595,10 b' value can be read by using the sys.getcheckinterval() function, and it'
 can be reset via sys.setcheckinterval(N). This switching of threads can
 cause subtly confusing effects if one of your threads is doing file I/O.
 In text mode, most systems only flush file buffers when they encounter a
-'\n'. An instruction as simple as 
+'\n'. An instruction as simple as:: 
+
   print >> filehandle, ''hello world''
+
 actually consists of several bytecodes, so it is possible that the
 newline does not reach your file before the next thread switch.
 Similarly, if you are writing to a file in binary mode, the file won't
@@ -4608,6 +4610,7 b' example) a GUI application which will read data generated by files'
 written to from the IPython thread, the safest approach is to open all
 of your files in unbuffered mode (the third argument to the file/open
 function is the buffering value)::
+
   filehandle = open(filename,mode,0)
 
 This is obviously a brute force way of avoiding race conditions with the