doc: add sphinx numref compatibility fallback
authorJohn McNamara <john.mcnamara@intel.com>
Mon, 18 May 2015 11:34:08 +0000 (12:34 +0100)
committerThomas Monjalon <thomas.monjalon@6wind.com>
Mon, 25 May 2015 13:40:37 +0000 (15:40 +0200)
commit536884d6963164ebba88f3633d2e22e5bbcc069c
tree63751b56ceca68ff99e487f9364e4cc35506d8b8
parent6d71d3b6ee0b6668e991c0296e55f3f41f8b88f2
doc: add sphinx numref compatibility fallback

This change adds some simple handling for the :numref: directive
for Sphinx versions prior to 1.3.1. This allows the Guides
documentation to be built with older versions of Sphinx and still
produce reasonable results.

The patch replaces the :numref: reference with a link to the
target (for all Sphinx doc types). It doesn't try to label
figures/tables.

Full numref support with automatic figure/table numbering and
links can be obtained by upgrading to Sphinx 1.3.1 or later.

Signed-off-by: John McNamara <john.mcnamara@intel.com>
Acked-by: Thomas Monjalon <thomas.monjalon@6wind.com>
doc/guides/conf.py