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
locking/atomics: Don't assume that scripts are executable
2019-04-19 14:21:43 +02:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
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
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
treewide: Add SPDX license identifier for missed files
2019-05-21 10:50:45 +02:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
kbuild: modversions: Fix relative CRC byte order interpretation
2019-03-28 23:46:56 +09:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
scripts: Add Python 3 support to tracing/draw_functrace.py
2018-07-29 11:08:38 +09:00
scripts: remove unnecessary ihex2fw and check-lc_ctypes from .gitignore
2018-12-22 00:37:52 +09:00
kbuild: source include/config/auto.conf instead of ${KCONFIG_CONFIG}
2019-03-14 02:39:11 +09:00
treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 36
2019-05-24 17:27:11 +02:00
kbuild: move bin2c back to scripts/ from scripts/basic/
2018-07-18 01:18:05 +09:00
bloat-o-meter: ignore __addressable_ symbols
2018-12-28 12:11:44 -08:00
bpf: fix script for generating man page on BPF helpers
2019-05-13 01:12:45 +02:00
bpfilter: check compiler capability in Kconfig
2018-06-28 13:36:39 +09:00
checkpatch.pl: Update DT vendor prefix check
2019-05-22 14:54:49 -05:00
scripts/checkstack.pl: dynamic stack growth for aarch64
2018-12-28 12:11:44 -08:00
checksyscalls: fix up mq_timedreceive and stat exceptions
2019-02-19 21:27:53 +01:00
kbuild: update comment block of scripts/clang-version.sh
2019-03-04 22:34:54 +09:00
coccicheck: return proper error code on fail
2018-08-14 08:58:56 +09:00
treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 54
2019-05-24 17:36:42 +02:00
scripts/decode_stacktrace.sh: handle RIP address with segment
2019-03-05 21:07:13 -08:00
scripts/decodecode: set ARCH when running natively on arm/arm64
2018-12-28 12:11:44 -08:00
kbuild: modules_install: warn when missing System.map file
2018-09-09 09:14:07 +09:00
scripts/documentation-file-ref-check: detect broken :doc:foo
2019-05-03 06:45:22 -06:00
extract-vmlinux: Check for uncompressed image as fallback
2018-10-17 08:18:01 +02:00
MAINTAINERS & files: Canonize the e-mails I use at files
2018-05-04 06:21:06 -04:00
scripts/faddr2line: fix location of start_kernel in comment
2018-11-18 10:15:09 -08:00
kbuild: Use ls(1) instead of stat(1) to obtain file size
2018-03-26 02:01:24 +09:00
jump_label: move 'asm goto' support test to Kconfig
2019-01-06 09:46:51 +09:00
kbuild: clean up scripts/gcc-version.sh
2019-03-04 22:35:04 +09:00
stack-protector: test compiler capability in Kconfig and drop AUTO mode
2018-06-08 18:56:00 +09:00
stack-protector: Fix test with 32-bit userland and CONFIG_64BIT=y
2018-06-25 23:21:13 +09:00
scripts: add a tool to produce a compile_commands.json file
2018-12-19 23:41:36 +09:00
kbuild: simplify dependency generation for CONFIG_TRIM_UNUSED_KSYMS
2018-12-01 23:13:14 +09:00
treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 61
2019-05-24 17:36:45 +02:00
get_maintainer: allow option --mpath <directory> to read all files in <directory>
2018-08-22 10:52:48 -07:00
kbuild: Improve portability of some sed invocations
2018-03-26 02:01:18 +09:00
Kbuild updates for v5.1
2019-03-10 17:48:21 -07:00
kbuild: drop support for cc-ldoption
2019-05-21 00:02:59 +09:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
kernel-doc: suppress 'not described' warnings for embedded struct fields
2019-01-16 15:04:01 -07:00
leaking_addresses: Completely remove --version flag
2019-03-07 08:53:18 +11:00
Kbuild updates for v5.2
2019-05-08 12:25:12 -07:00
scripts/gdb: do not descend into scripts/gdb from scripts
2019-02-27 21:40:09 +09:00
kbuild: force all architectures except um to include mandatory-y
2019-03-17 12:56:32 +09:00
Kbuild updates for v5.2
2019-05-08 12:25:12 -07:00
kbuild: remove deprecated host-progs variable
2018-08-09 21:51:17 +09:00
kbuild: add all Clang-specific flags unconditionally
2019-05-18 11:49:53 +09:00
gcc-plugins: structleak: Generalize to all variable types
2019-03-04 09:29:41 -08:00
kbuild: generate asm-generic wrappers if mandatory headers are missing
2019-01-06 09:46:51 +09:00
kbuild: remove 'addtree' and 'flags' magic for header search paths
2019-05-18 11:49:57 +09:00
kasan: remove use after scope bugs detection.
2019-03-05 21:07:13 -08:00
treewide: Add SPDX license identifier - Makefile/Kconfig
2019-05-21 10:50:46 +02:00
dt-bindings: Pass binding directory to validation tools
2019-05-22 09:01:01 -05:00
kbuild: use $(srctree) instead of KBUILD_SRC to check out-of-tree build
2019-04-02 23:28:04 +09:00
Revert "modsign: Abort modules_install when signing fails"
2019-03-17 12:56:31 +09:00
modpost: make KBUILD_MODPOST_WARN also configurable for external modules
2019-04-11 23:11:51 +09:00
kbuild: remove duplicated comments about PHONY
2018-07-06 22:04:03 +09:00
ubsan: Remove vla bound checks.
2019-05-06 11:12:09 -07:00
kbuild: remove unnecessary in-subshell execution
2019-01-28 09:11:17 +09:00
kbuild: mkmakefile: generate a simple wrapper of top Makefile
2019-04-02 23:27:38 +09:00
kbuild: do not check name uniqueness of builtin modules
2019-05-21 08:54:05 +09:00
kbuild: rename built-in.o to built-in.a
2018-03-26 02:01:19 +09:00
scripts/recordmcount.{c,pl}: support -ffunction-sections .text.* section names
2018-12-08 20:54:08 -05:00
scripts: Fixed printf format mismatch
2018-05-29 22:04:12 +09:00
Kbuild updates for v5.2
2019-05-08 12:25:12 -07:00
scripts/setlocalversion: Improve -dirty check with git-status --no-optional-locks
2018-11-21 23:57:33 +09:00
scripts: add spdxcheck.py self test
2018-12-28 12:11:44 -08:00
scripts/spdxcheck.py: Add dual license subdirectory
2019-05-21 09:29:41 -06:00
scripts/spelling.txt: add more spellings to spelling.txt
2019-03-07 18:31:59 -08:00
scripts/sphinx-pre-install: make it handle Sphinx versions
2019-05-24 09:09:32 -06:00
MAINTAINERS & files: Canonize the e-mails I use at files
2018-05-04 06:21:06 -04:00
selftests: add headers_install to lib.mk
2018-09-05 08:12:09 -06:00
treewide: Add SPDX license identifier for missed files
2019-05-21 10:50:45 +02:00
unifdef: use memcpy instead of strncpy
2018-11-30 14:45:01 -08:00
ver_linux: Assign constant RE to variable name for clarity
2019-01-22 13:34:35 +01:00
bec7550cca