I upgraded to sphinx-0.6.1 this morning and ran into some trouble. I've been trying to track down the cause, attempting to build the docs for my own projects (segfaults), numpy (issues, expecting segfaults), h5py (segfaults), and now ipython (issues). As of version 0.6, a tag can be provided to sphinx-build (perhaps in a
make file or python equivalent) and then we can do, for example:<br>
<br>
.. only:: html<br><br>But until IPython is ready to require &gt;sphinx-0.6, perhaps someone could patch only_directives.py so it is compatible with version 0.6 and later:<br><br>=== modified file &#39;docs/sphinxext/only_directives.py&#39;<br>
--- docs/sphinxext/only_directives.py   2008-09-13 22:39:09 +0000<br>+++ docs/sphinxext/only_directives.py   2009-04-01 14:44:05 +0000<br>@@ -5,7 +5,10 @@<br><br> from docutils.nodes import Body, Element<br> from docutils.writers.html4css1 import HTMLTranslator<br>
-from sphinx.latexwriter import LaTeXTranslator<br>+try:<br>+    from sphinx.latexwriter import LaTeXTranslator<br>+except ImportError:<br>+    from sphinx.writers.latex import LaTeXTranslator<br> from docutils.parsers.rst import directives<br>
<br> class html_only(Body, Element):<br><br><br><br>Has anyone tried building the ipython docs lately? After applying that patch, I try to build ipython&#39;s docs and I get an error when sphinx gets to IPython/frontend/frontendbase:<br>
<br>-------<br>/usr/local/src/ipython/docs/sphinxext/docscrape.py:117: UserWarning: Unknown section Result<br>  warn(&quot;Unknown section %s&quot; % key)<br>/usr/local/src/ipython/docs/sphinxext/docscrape.py:117: UserWarning: Unknown section Parameters:<br>
  warn(&quot;Unknown section %s&quot; % key)<br>-------<br><br>Followed by another error, which is probably not a concern since I don&#39;t have wxpython, but I thought I would report it anyway:<br><br>-------<br>Exception occurred:[ 22%] api/generated/IPython.frontend.wx.console_widget<br>
  File &quot;/usr/local/src/ipython/docs/sphinxext/inheritance_diagram.py&quot;, line 107, in _import_class_or_module<br>    &quot;Could not import class or module &#39;%s&#39; specified for inheritance diagram&quot; % name)<br>
ValueError: Could not import class or module &#39;IPython.frontend.wx.console_widget&#39; specified for inheritance diagram<br>The full traceback has been saved in /tmp/sphinx-err-axFWA0.log, if you want to report the issue to the author.<br>
Please also report this if it was a user error, so that a better error message can be provided next time.<br>Send reports to <a href="mailto:sphinx-dev@googlegroups.com">sphinx-dev@googlegroups.com</a>. Thanks!<br>make: *** [html] Error 1<br>
------<br><br>Cheers,<br>Darren<br><br>