diff --git a/doc/misc.rst b/doc/misc.rst
index afc41a74fb5faa11f4ffd8502ebc856d077003c9..8444b3bfe5ea8dc097f252d363bb9204c8bba2f2 100644
--- a/doc/misc.rst
+++ b/doc/misc.rst
@@ -209,9 +209,17 @@ and then use the ``%%cl_kernel`` 'cell-magic' command. See `this notebook
 <http://nbviewer.ipython.org/urls/raw.githubusercontent.com/inducer/pyopencl/master/examples/ipython-demo.ipynb>`_
 (which ships with PyOpenCL) for a demonstration.
 
-You can pass build options to be used for building the program executable by using the ``-o`` flag on the first line of the cell (next to the ``%%cl_kernel`` directive). For example: `%%cl_kernel -o "-cl-fast-relaxed-math"``.
+You can pass build options to be used for building the program executable by
+using the ``-o`` flag on the first line of the cell (next to the ``%%cl_kernel``
+directive). For example::
 
-There are also line magics: ``cl_load_edit_kernel`` which will load a file into the next cell (adding ``cl_kernel`` to the first line) and ``cl_kernel_from_file`` which will compile kernels from a file (as if you copy-and-pasted the contents of the file to a cell with ``cl_kernel``). Both of these magics take options ``-f`` to specify the file and optionally ``-o`` for build options.
+    %%cl_kernel -o "-cl-fast-relaxed-math"
+
+There are also line magics: ``cl_load_edit_kernel`` which will load a file into
+the next cell (adding ``cl_kernel`` to the first line) and ``cl_kernel_from_file``
+which will compile kernels from a file (as if you copy-and-pasted the contents of
+the file to a cell with ``cl_kernel``). Both of these magics take options ``-f``
+to specify the file and optionally ``-o`` for build options.
 
 .. versionadded:: 2014.1