Linus Torvalds bec7550cca The Sphinx 2.0 release contained a few incompatible API changes that broke ... our extensions and, thus, the documentation build in general. Who knew that those deprecation warnings it was outputting actually meant we should change something? This set of fixes makes the build work again with Sphinx 2.0 and eliminates the warnings for 1.8. As part of that, we also need a few fixes to the docs for places where the new Sphinx is more strict. It is a bit late in the cycle for this kind of change, but it does fix problems that people are experiencing now. There has been some talk of raising the minimum version of Sphinx we support. I don't want to do that abruptly, though, so these changes add some glue to continue to support versions back to 1.3. We will be adding some infrastructure soon to nudge users of old versions forward, with the idea of maybe increasing our minimum version (and removing this glue) sometime in the future. -----BEGIN PGP SIGNATURE----- iQFDBAABCAAtFiEEIw+MvkEiF49krdp9F0NaE2wMflgFAlzsYw8PHGNvcmJldEBs d24ubmV0AAoJEBdDWhNsDH5YGuwH+gOk2lGPpI7tsIsctUr3TTviYbu9EywGINUA c2pPQBHbC13F/QKkb/WArnIhM7eRMWxNy1IlrzqTTLRcAteJihoRNldLVpImxwHJ DaULovUHRO9uNuVORGV4RLOBUUkrguoz4X7OZooT3tluRZcL58C3Qn8MbZYiZYf1 ZJKHVJxfSedyHYTK1H5qB9uAAvdoNGLjvK8pzA9S7HgHM9viuOlY2GTHn4uvlmI+ qgnbVRNeEb8IRFztvKy2RyMAisx2o5v/lfpKVM+OC9EJgkpw+mw55YUdfDeNavJg 2d3xv8zgS1TP+qAmba2uVwiRDNChTKxz72nbaqZZGOt16StRiyY= =hrKI -----END PGP SIGNATURE----- Merge tag 'docs-5.2-fixes2' of git://git.lwn.net/linux Pull documentation fixes from Jonathan Corbet: "The Sphinx 2.0 release contained a few incompatible API changes that broke our extensions and, thus, the documentation build in general. Who knew that those deprecation warnings it was outputting actually meant we should change something? This set of fixes makes the build work again with Sphinx 2.0 and eliminates the warnings for 1.8. As part of that, we also need a few fixes to the docs for places where the new Sphinx is more strict. It is a bit late in the cycle for this kind of change, but it does fix problems that people are experiencing now. There has been some talk of raising the minimum version of Sphinx we support. I don't want to do that abruptly, though, so these changes add some glue to continue to support versions back to 1.3. We will be adding some infrastructure soon to nudge users of old versions forward, with the idea of maybe increasing our minimum version (and removing this glue) sometime in the future" * tag 'docs-5.2-fixes2' of git://git.lwn.net/linux: drm/i915: Maintain consistent documentation subsection ordering scripts/sphinx-pre-install: make it handle Sphinx versions docs: Fix conf.py for Sphinx 2.0 docs: fix multiple doc build warnings in enumeration.rst lib/list_sort: fix kerneldoc build error docs: fix numaperf.rst and add it to the doc tree doc: Cope with the deprecation of AutoReporter doc: Cope with Sphinx logging deprecations		2019-05-29 14:36:41 -07:00
..
atomic	locking/atomics: Don't assume that scripts are executable	2019-04-19 14:21:43 +02:00
basic	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
coccinelle	fs: stream_open - opener for stream-like files so that read and write can run simultaneously without deadlock	2019-04-06 07:01:55 -10:00
dtc	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
gcc-plugins	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
gdb	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
genksyms	treewide: Add SPDX license identifier for missed files	2019-05-21 10:50:45 +02:00
kconfig	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
ksymoops	Fix dead URLs to ftp.kernel.org	2017-03-28 16:16:52 +02:00
mod	kbuild: modversions: Fix relative CRC byte order interpretation	2019-03-28 23:46:56 +09:00
package	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
selinux	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
tracing	scripts: Add Python 3 support to tracing/draw_functrace.py	2018-07-29 11:08:38 +09:00
.gitignore	scripts: remove unnecessary ihex2fw and check-lc_ctypes from .gitignore	2018-12-22 00:37:52 +09:00
adjust_autoksyms.sh	kbuild: source include/config/auto.conf instead of ${KCONFIG_CONFIG}	2019-03-14 02:39:11 +09:00
asn1_compiler.c	treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 36	2019-05-24 17:27:11 +02:00
bin2c.c	kbuild: move bin2c back to scripts/ from scripts/basic/	2018-07-18 01:18:05 +09:00
bloat-o-meter	bloat-o-meter: ignore __addressable_ symbols	2018-12-28 12:11:44 -08:00
bootgraph.pl	scripts: Switch to more portable Perl shebang	2017-05-14 11:20:44 +09:00
bpf_helpers_doc.py	bpf: fix script for generating man page on BPF helpers	2019-05-13 01:12:45 +02:00
cc-can-link.sh	bpfilter: check compiler capability in Kconfig	2018-06-28 13:36:39 +09:00
check_extable.sh	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
checkincludes.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
checkkconfigsymbols.py	checkkconfigsymbols.py: support Kconfig's 'imply' statement	2017-02-03 11:49:06 +01:00
checkpatch.pl	checkpatch.pl: Update DT vendor prefix check	2019-05-22 14:54:49 -05:00
checkstack.pl	scripts/checkstack.pl: dynamic stack growth for aarch64	2018-12-28 12:11:44 -08:00
checksyscalls.sh	checksyscalls: fix up mq_timedreceive and stat exceptions	2019-02-19 21:27:53 +01:00
checkversion.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
clang-version.sh	kbuild: update comment block of scripts/clang-version.sh	2019-03-04 22:34:54 +09:00
cleanfile	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
cleanpatch	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
coccicheck	coccicheck: return proper error code on fail	2018-08-14 08:58:56 +09:00
config	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
conmakehash.c	treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 54	2019-05-24 17:36:42 +02:00
const_structs.checkpatch	const_structs.checkpatch: add frequently used from Julia Lawall's list	2016-10-11 15:06:30 -07:00
decode_stacktrace.sh	scripts/decode_stacktrace.sh: handle RIP address with segment	2019-03-05 21:07:13 -08:00
decodecode	scripts/decodecode: set ARCH when running natively on arm/arm64	2018-12-28 12:11:44 -08:00
depmod.sh	kbuild: modules_install: warn when missing System.map file	2018-09-09 09:14:07 +09:00
diffconfig	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
documentation-file-ref-check	scripts/documentation-file-ref-check: detect broken :doc:foo	2019-05-03 06:45:22 -06:00
export_report.pl	scripts: Switch to more portable Perl shebang	2017-05-14 11:20:44 +09:00
extract_xc3028.pl	MAINTAINERS & files: Canonize the e-mails I use at files	2018-05-04 06:21:06 -04:00
extract-cert.c
extract-ikconfig
extract-module-sig.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
extract-sys-certs.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
extract-vmlinux	extract-vmlinux: Check for uncompressed image as fallback	2018-10-17 08:18:01 +02:00
faddr2line	scripts/faddr2line: fix location of start_kernel in comment	2018-11-18 10:15:09 -08:00
file-size.sh	kbuild: Use ls(1) instead of stat(1) to obtain file size	2018-03-26 02:01:24 +09:00
find-unused-docs.sh	scripts: Add a script to find unused documentation	2017-10-23 08:01:37 -06:00
gcc-goto.sh	jump_label: move 'asm goto' support test to Kconfig	2019-01-06 09:46:51 +09:00
gcc-ld	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
gcc-plugin.sh	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
gcc-version.sh	kbuild: clean up scripts/gcc-version.sh	2019-03-04 22:35:04 +09:00
gcc-x86_32-has-stack-protector.sh	stack-protector: test compiler capability in Kconfig and drop AUTO mode	2018-06-08 18:56:00 +09:00
gcc-x86_64-has-stack-protector.sh	stack-protector: Fix test with 32-bit userland and CONFIG_64BIT=y	2018-06-25 23:21:13 +09:00
gen_compile_commands.py	scripts: add a tool to produce a compile_commands.json file	2018-12-19 23:41:36 +09:00
gen_ksymdeps.sh	kbuild: simplify dependency generation for CONFIG_TRIM_UNUSED_KSYMS	2018-12-01 23:13:14 +09:00
get_dvb_firmware	treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 61	2019-05-24 17:36:45 +02:00
get_maintainer.pl	get_maintainer: allow option --mpath <directory> to read all files in <directory>	2018-08-22 10:52:48 -07:00
gfp-translate
headerdep.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
headers_check.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
headers_install.sh	kbuild: Improve portability of some sed invocations	2018-03-26 02:01:18 +09:00
headers.sh	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
insert-sys-cert.c
kallsyms.c	Kbuild updates for v5.1	2019-03-10 17:48:21 -07:00
Kbuild.include	kbuild: drop support for cc-ldoption	2019-05-21 00:02:59 +09:00
Kconfig.include	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
kernel-doc	kernel-doc: suppress 'not described' warnings for embedded struct fields	2019-01-16 15:04:01 -07:00
ld-version.sh	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
leaking_addresses.pl	leaking_addresses: Completely remove --version flag	2019-03-07 08:53:18 +11:00
Lindent	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
link-vmlinux.sh	Kbuild updates for v5.2	2019-05-08 12:25:12 -07:00
Makefile	scripts/gdb: do not descend into scripts/gdb from scripts	2019-02-27 21:40:09 +09:00
Makefile.asm-generic	kbuild: force all architectures except um to include mandatory-y	2019-03-17 12:56:32 +09:00
Makefile.build	Kbuild updates for v5.2	2019-05-08 12:25:12 -07:00
Makefile.clean	kbuild: remove deprecated host-progs variable	2018-08-09 21:51:17 +09:00
Makefile.dtbinst	DeviceTree for 4.15:	2017-11-14 18:25:40 -08:00
Makefile.extrawarn	kbuild: add all Clang-specific flags unconditionally	2019-05-18 11:49:53 +09:00
Makefile.gcc-plugins	gcc-plugins: structleak: Generalize to all variable types	2019-03-04 09:29:41 -08:00
Makefile.headersinst	kbuild: generate asm-generic wrappers if mandatory headers are missing	2019-01-06 09:46:51 +09:00
Makefile.host	kbuild: remove 'addtree' and 'flags' magic for header search paths	2019-05-18 11:49:57 +09:00
Makefile.kasan	kasan: remove use after scope bugs detection.	2019-03-05 21:07:13 -08:00
Makefile.kcov	treewide: Add SPDX license identifier - Makefile/Kconfig	2019-05-21 10:50:46 +02:00
Makefile.lib	dt-bindings: Pass binding directory to validation tools	2019-05-22 09:01:01 -05:00
Makefile.modbuiltin	kbuild: use $(srctree) instead of KBUILD_SRC to check out-of-tree build	2019-04-02 23:28:04 +09:00
Makefile.modinst	Revert "modsign: Abort modules_install when signing fails"	2019-03-17 12:56:31 +09:00
Makefile.modpost	modpost: make KBUILD_MODPOST_WARN also configurable for external modules	2019-04-11 23:11:51 +09:00
Makefile.modsign	kbuild: remove duplicated comments about PHONY	2018-07-06 22:04:03 +09:00
Makefile.ubsan	ubsan: Remove vla bound checks.	2019-05-06 11:12:09 -07:00
makelst	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
markup_oops.pl	scripts: Switch to more portable Perl shebang	2017-05-14 11:20:44 +09:00
mkcompile_h	kbuild: remove unnecessary in-subshell execution	2019-01-28 09:11:17 +09:00
mkmakefile	kbuild: mkmakefile: generate a simple wrapper of top Makefile	2019-04-02 23:27:38 +09:00
mksysmap
mkuboot.sh	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
module-common.lds	module: set .init_array alignment to 8	2017-03-13 09:40:28 -07:00
modules-check.sh	kbuild: do not check name uniqueness of builtin modules	2019-05-21 08:54:05 +09:00
namespace.pl	kbuild: rename built-in.o to built-in.a	2018-03-26 02:01:19 +09:00
objdiff	scripts: objdiff: Ignore debug info when comparing	2017-03-11 11:13:38 +09:00
parse-maintainers.pl	parse-maintainers: add ability to specify filenames	2017-11-17 16:10:01 -08:00
patch-kernel	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
pnmtologo.c
profile2linkerlist.pl	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
prune-kernel	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
recordmcount.c	scripts/recordmcount.{c,pl}: support -ffunction-sections .text.* section names	2018-12-08 20:54:08 -05:00
recordmcount.h	scripts: Fixed printf format mismatch	2018-05-29 22:04:12 +09:00
recordmcount.pl	Kbuild updates for v5.2	2019-05-08 12:25:12 -07:00
setlocalversion	scripts/setlocalversion: Improve -dirty check with git-status --no-optional-locks	2018-11-21 23:57:33 +09:00
show_delta
sign-file.c	sign-file: fix build error in sign-file.c with libressl	2017-02-10 12:43:47 +11:00
sortextable.c	powerpc: Build-time sort the exception table	2016-11-14 11:11:51 +11:00
sortextable.h
spdxcheck-test.sh	scripts: add spdxcheck.py self test	2018-12-28 12:11:44 -08:00
spdxcheck.py	scripts/spdxcheck.py: Add dual license subdirectory	2019-05-21 09:29:41 -06:00
spelling.txt	scripts/spelling.txt: add more spellings to spelling.txt	2019-03-07 18:31:59 -08:00
sphinx-pre-install	scripts/sphinx-pre-install: make it handle Sphinx versions	2019-05-24 09:09:32 -06:00
split-man.pl	MAINTAINERS & files: Canonize the e-mails I use at files	2018-05-04 06:21:06 -04:00
stackdelta	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
stackusage	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
subarch.include	selftests: add headers_install to lib.mk	2018-09-05 08:12:09 -06:00
tags.sh	treewide: Add SPDX license identifier for missed files	2019-05-21 10:50:45 +02:00
unifdef.c	unifdef: use memcpy instead of strncpy	2018-11-30 14:45:01 -08:00
ver_linux	ver_linux: Assign constant RE to variable name for clarity	2019-01-22 13:34:35 +01:00
xen-hypercalls.sh	License cleanup: add SPDX GPL-2.0 license identifier to files with no license	2017-11-02 11:10:55 +01:00
xz_wrap.sh