ipython/ipython — pull request #1385 by ivanov (2012-02-07 07:31:33+00:00)
Title: updated and prettified magic doc strings

after #1309, the docs stopped building (sorry about this I didn't know that the See Also was so strictly parsed), but the solution in #1338 made it so that the See Also linked to the relevant magic functions by their python name (see image below). I've added a comment to the See Also strings to make it explicit how such magics are called.

![Imgur](http://i.imgur.com/DVF2d.png)

Along the way (since I was now building the docs) I prettified a lot of the ipython code examples with `.. sourcecode :: ipython` and corrected many other places where the ReST was off

![Pretty](http://i.imgur.com/Rf649.png)

There are probably many-many instances of such doc-only improvements which can be made all throughout IPython. It would be a good opportunity for someone with time on their hands to go through, spot places where small ReST changes would improve readability, and spend the time to iteratively improving and rebuilding the docs to verify this. Just putting it out there for the benefit of lurkers, or in case someone wants to refer to this PR to point out the kind of work that's a bit time consuming, but not impossibly hard. I just kep having to run `make html` in my `ipython/docs` directory - which luckily only takes a long time to build the docs the first time - after that, each run essentially only rebuilds the portions which were changed from the previous