Add sphinx.version_info for better programmatic check of the Sphinx version.

1 files changed, 16 insertions, 0 deletions

diff --git a/doc/ext/appapi.rst b/doc/ext/appapi.rst
index 1f5c063c..c194a841 100644
--- a/doc/ext/appapi.rst
+++ b/doc/ext/appapi.rst
@@ -462,6 +462,22 @@ registered event handlers.
    .. versionadded:: 0.5
 
 
+Checking the Sphinx version
+---------------------------
+
+.. currentmodule:: sphinx
+
+Use this to adapt your extension to API changes in Sphinx.
+
+.. data:: version_info
+
+   A tuple of five elements; for Sphinx version 1.2.1 beta 3 this would be
+   ``(1, 2, 1, 'beta', 3)``.
+
+   .. versionadded:: 1.2
+      Before version 1.2, check the string ``sphinx.__version__``.
+
+
 .. _template-bridge:
 
 The template bridge