Merge pull request #4209 from davclark/magic-doc-fixes

Magic doc fixes

IPython/extensions/cythonmagic.py

@@ -4,9 +4,18 b''
 Cython related magics
 =====================
 
+Magic command interface for interactive work with Cython
+
+.. note::
+
+  The ``Cython`` package needs to be installed separately. It
+  can be obtained using ``easy_install`` or ``pip``.
+
 Usage
 =====
 
+To enable the magics below, execute ``%load_ext cythonmagic``.
+
 ``%%cython``
 
 {CYTHON_DOC}

IPython/extensions/octavemagic.py

@@ -11,9 +11,13 b' Magics for interacting with Octave via oct2py.'
   The ``oct2py`` module needs to be installed separately and
   can be obtained using ``easy_install`` or ``pip``.
 
+  You will also need a working copy of GNU Octave.
+
 Usage
 =====
 
+To enable the magics below, execute ``%load_ext octavemagic``.
+
 ``%octave``
 
 {OCTAVE_DOC}

IPython/extensions/rmagic.py

@@ -6,9 +6,18 b' Rmagic'
 
 Magic command interface for interactive work with R via rpy2
 
+.. note::
+
+  The ``rpy2`` package needs to be installed separately. It
+  can be obtained using ``easy_install`` or ``pip``.
+
+  You will also need a working copy of R.
+
 Usage
 =====
 
+To enable the magics below, execute ``%load_ext rmagic``.
+
 ``%R``
 
 {R_DOC}
@@ -425,7 +434,7 b' class RMagics(Magics):'
         is printed if it would printed be when evaluating the same code 
         within a standard R REPL.
         
-        Nothing is returned to python by default in cell mode.
+        Nothing is returned to python by default in cell mode::
 
             In [10]: %%R
                ....: Y = c(2,4,3,9)
@@ -447,7 +456,7 b' class RMagics(Magics):'
             Multiple R-squared: 0.6993,Adjusted R-squared: 0.549
             F-statistic: 4.651 on 1 and 2 DF,  p-value: 0.1638
 
-        In the notebook, plots are published as the output of the cell.
+        In the notebook, plots are published as the output of the cell::
 
         %R plot(X, Y)