sphinxext: Sphinx 0.6 compatibility and deprecation warnings

1 files changed, 10 insertions, 1 deletions

diff --git a/doc/sphinxext/only_directives.py b/doc/sphinxext/only_directives.py
index e4dfd5cc7..c25760ad0 100644
--- a/doc/sphinxext/only_directives.py
+++ b/doc/sphinxext/only_directives.py
@@ -5,7 +5,16 @@
 
 from docutils.nodes import Body, Element
 from docutils.writers.html4css1 import HTMLTranslator
-from sphinx.latexwriter import LaTeXTranslator
+try:
+    from sphinx.latexwriter import LaTeXTranslator
+except ImportError:
+    from sphinx.writers.latex import LaTeXTranslator
+
+    import warnings
+    warnings.warn("The only_directives module is deprecated; please use "
+                  "the only:: directive available in Sphinx >= 0.6",
+                  DeprecationWarning, stacklevel=2)
+
 from docutils.parsers.rst import directives
 
 class html_only(Body, Element):