clean up of documentation files

[ivanov]

This is mostly a decluttering PR to make way for future changes coming to the
way we organize and build our documentation.

Our README was out of date and hadn't been updated in ages. The attic
documents, likewise, have not been touched for a long time.

make help has been updated to list the very useful html_noapi target

Finally, I've removed the do_sphinx.py file, mostly because it does not
work, though I can be easily convinced to exclude that commit from this if
there's anyone who feels strong that it should stay in.

[ivanov]

pinging @ellisonbg @jstenar and @efiring who have made commits to do_sphinx.py and might have insight as to whether or not it should stay.

[ivanov]

pinging @fperez @ellisonbg and @paykroyd about the removal of docs/emacs/ipython.el which hasn't been updated since IPython 0.11 (Again, I can easily be convinced to revert this, but it seems as thought he file's been stale for a while now).

[efiring]

I don't have any real insight into do_sphinx.py, and personally I don't care whether it stays or goes. It looks like I ran into a problem with it back in 2011 after a Sphinx update, and my few changes were to fix that problem. It also looks like its only real function is to tweak the design of the LaTeX output, and thereby the pdf output. I gather from a commit comment by @fperez that pdf is no longer routinely produced; everyone uses html in practice.

[ivanov]

it's been a week, so I'll go ahead an merge this tomorrow if I don't hear back otherwise

[takluyver]

I thought someone was doing something with ipython.el last year, but perhaps it went into a separate repo?

[ivanov]

according to @tkf in the discussion over on #1015, the standard python.el mode already supports IPython.

one last ping to @andreas-roehler @paykroyd and @deftpunk who were active in #1015:

I'm proposing the removal of docs/emacs/ipython.el which ships with IPython but has not seen an update in 2 years. Please voice your objection or approval

[damianavila]

+1 for the removal...

[ivanov]

ok, no objections, merging now