98f01cf7a2
Update the documentation build system according to Linux v5.11-rc1. Deactive the automarkup.py extension module which on Gitlab CI is incompatible with Unicode. With this patch we can build the HTML documentation using either of Sphinx 2 and Sphinx 3. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
34 lines
876 B
Bash
34 lines
876 B
Bash
#!/bin/sh
|
|
# SPDX-License-Identifier: GPL-2.0+
|
|
#
|
|
# Figure out if we should follow a specific parallelism from the make
|
|
# environment (as exported by scripts/jobserver-exec), or fall back to
|
|
# the "auto" parallelism when "-jN" is not specified at the top-level
|
|
# "make" invocation.
|
|
|
|
sphinx="$1"
|
|
shift || true
|
|
|
|
parallel="$PARALLELISM"
|
|
if [ -z "$parallel" ] ; then
|
|
# If no parallelism is specified at the top-level make, then
|
|
# fall back to the expected "-jauto" mode that the "htmldocs"
|
|
# target has had.
|
|
auto=$(perl -e 'open IN,"'"$sphinx"' --version 2>&1 |";
|
|
while (<IN>) {
|
|
if (m/([\d\.]+)/) {
|
|
print "auto" if ($1 >= "1.7")
|
|
}
|
|
}
|
|
close IN')
|
|
if [ -n "$auto" ] ; then
|
|
parallel="$auto"
|
|
fi
|
|
fi
|
|
# Only if some parallelism has been determined do we add the -jN option.
|
|
if [ -n "$parallel" ] ; then
|
|
parallel="-j$parallel"
|
|
fi
|
|
|
|
exec "$sphinx" $parallel "$@"
|