rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-05-14 13:39:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

RTEMS Docs: Check sphinx version

Browse Source 
Sphinx.util.compat module was removed at Sphinx version 1.7.
Imported module was not being used.

Closes #3311.
This commit is contained in:
Richard Campbell 2018-02-22 10:23:08 -06:00 committed by Joel Sherrill
parent 9c9ba8f8bc
commit 2a0664402b
2 changed files with 23 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
common/rtemsdomain.py
View File

@ -6,7 +6,6 @@ from sphinx.roles import XRefRole
from sphinx.locale import l_, _
from sphinx.directives import ObjectDescription
from sphinx.domains import Domain, ObjType, Index
from sphinx.util.compat import Directive
from sphinx.util.nodes import make_refnode
from sphinx.util.docfields import Field, TypedField

27
common/waf.py
View File

@ -81,12 +81,31 @@ class linkcheck(BuildContext):
fun = 'cmd_linkcheck'
def check_sphinx_version(ctx, minver):
version = ctx.cmd_and_log(ctx.env.BIN_SPHINX_BUILD +
['--version']).split(" ")[-1:][0].strip()
try:
ver = tuple(map(int, re.split('[\D]', version)))
import sphinx
# sphinx.version_info was introduced in sphinx ver 1.2
version = sphinx.version_info
# version looks like (1, 7, 0, 'final', 0))
ver = version[0:2]
except:
ctx.fatal("Sphinx version cannot be checked: %s" % version)
try:
# sphinx-build returns its version info in stderr
(out, err) = ctx.cmd_and_log(ctx.env.BIN_SPHINX_BUILD +
['--version'], output=Context.BOTH)
# err looks like 'sphinx-build 1.7.0\n'
version = err.split(" ")[-1:][0].strip()
ver = tuple(map(int, re.split('[\D]', version)))
except:
try:
# sphinx-build returns its version info in stdout
version = ctx.cmd_and_log(ctx.env.BIN_SPHINX_BUILD +
['--version']).split(" ")[-1:][0].strip()
try:
ver = tuple(map(int, re.split('[\D]', version)))
except:
ctx.fatal("Sphinx version cannot be checked")
except:
ctx.fatal("Sphinx version cannot be checked: %s" % version)
if ver < minver:
ctx.fatal("Sphinx version is too old: %s" % ".".join(map(str, ver)))
return ver