Linus Torvalds 5b9b41617b Another moderately busy cycle for documentation, including: ... - The minimum Sphinx requirement has been raised to 2.4.4, following a warning that was added in 6.2. - Some reworking of the Documentation/process front page to, hopefully, make it more useful. - Various kernel-doc tweaks to, for example, make it deal properly with __counted_by annotations. - We have also restored a warning for documentation of nonexistent structure members that disappeared a while back. That had the delightful consequence of adding some 600 warnings to the docs build. A sustained effort by Randy, Vegard, and myself has addressed almost all of those, bringing the documentation back into sync with the code. The fixes are going through the appropriate maintainer trees. - Various improvements to the HTML rendered docs, including automatic links to Git revisions and a nice new pulldown to make translations easy to access. - Speaking of translations, more of those for Spanish and Chinese. ...plus the usual stream of documentation updates and typo fixes. -----BEGIN PGP SIGNATURE----- iQFDBAABCAAtFiEEIw+MvkEiF49krdp9F0NaE2wMflgFAmWcRKMPHGNvcmJldEBs d24ubmV0AAoJEBdDWhNsDH5YTKIH/AxBt/3iWt40dPf18arZHLU6tdUbmg01ttef CNKWkniCmABGKc//KYDXvjZMRDt0YlrS0KgUzrb8nIQTBlZG40D+88EwjXE0HeGP xt1Fk7OPOiJEqBZ3HEe0PDVfOiA+4yR6CmDKklCJuKg77X9atklneBwPUw/cOASk CWj+BdbwPBiSNQv48Lp87rGusKwnH/g0MN2uS0z9MPr1DYjM1K8+ngZjGW24lZHt qs5yhP43mlZGBF/lwNJXQp/xhnKAqJ9XwylBX9Wmaoxaz9yyzNVsADGvROMudgzi 9YB+Jdy7Z0JSrVoLIRhUuDOv7aW8vk+8qLmGJt2aTIsqehbQ6pk= =fCtT -----END PGP SIGNATURE----- Merge tag 'docs-6.8' of git://git.lwn.net/linux Pull documentation update from Jonathan Corbet: "Another moderately busy cycle for documentation, including: - The minimum Sphinx requirement has been raised to 2.4.4, following a warning that was added in 6.2 - Some reworking of the Documentation/process front page to, hopefully, make it more useful - Various kernel-doc tweaks to, for example, make it deal properly with __counted_by annotations - We have also restored a warning for documentation of nonexistent structure members that disappeared a while back. That had the delightful consequence of adding some 600 warnings to the docs build. A sustained effort by Randy, Vegard, and myself has addressed almost all of those, bringing the documentation back into sync with the code. The fixes are going through the appropriate maintainer trees - Various improvements to the HTML rendered docs, including automatic links to Git revisions and a nice new pulldown to make translations easy to access - Speaking of translations, more of those for Spanish and Chinese ... plus the usual stream of documentation updates and typo fixes" * tag 'docs-6.8' of git://git.lwn.net/linux: (57 commits) MAINTAINERS: use tabs for indent of CONFIDENTIAL COMPUTING THREAT MODEL A reworked process/index.rst ring-buffer/Documentation: Add documentation on buffer_percent file Translated the RISC-V architecture boot documentation. Docs: remove mentions of fdformat from util-linux Docs/zh_CN: Fix the meaning of DEBUG to pr_debug() Documentation: move driver-api/dcdbas to userspace-api/ Documentation: move driver-api/isapnp to userspace-api/ Documentation/core-api : fix typo in workqueue Documentation/trace: Fixed typos in the ftrace FLAGS section kernel-doc: handle a void function without producing a warning scripts/get_abi.pl: ignore some temp files docs: kernel_abi.py: fix command injection scripts/get_abi: fix source path leak CREDITS, MAINTAINERS, docs/process/howto: Update man-pages' maintainer docs: translations: add translations links when they exist kernel-doc: Align quick help and the code MAINTAINERS: add reviewer for Spanish translations docs: ignore __counted_by attribute in structure definitions scripts: kernel-doc: Clarify missing struct member description ..		2024-01-11 19:46:52 -08:00
..
libbpf	documentation/bpf: Document cgroup unix socket address hooks	2023-10-11 17:27:55 -07:00
standardization	bpf, docs: Define signed modulo as using truncated division	2023-10-19 01:36:12 +02:00
bpf_design_QA.rst	docs/bpf: Add documentation for new instructions	2023-07-27 18:54:17 -07:00
bpf_devel_QA.rst	bpf: Replace deprecated -target with --target= for Clang	2023-06-29 15:46:17 +02:00
bpf_iterators.rst	bpf, docs: BPF Iterator Document	2023-06-22 19:44:22 +02:00
bpf_licensing.rst	bpf: Document BPF licensing.	2021-09-22 23:13:13 +02:00
bpf_prog_run.rst	Documentation/bpf: Add documentation for BPF_PROG_RUN	2022-03-09 14:19:22 -08:00
btf.rst	docs: automarkup: linkify git revs	2023-11-17 13:13:24 -07:00
clang-notes.rst	bpf, docs: Explain helper functions	2023-03-10 13:02:00 -08:00
classic_vs_extended.rst	bpf, docs: Split the comparism to classic BPF from instruction-set.rst	2021-12-30 16:31:44 -08:00
cpumasks.rst	bpf: Add bpf_cpumask_weight() kfunc	2023-12-09 21:37:33 -08:00
drgn.rst	bpf: Document bpf_inspect drgn tool	2020-03-26 00:08:36 +01:00
faq.rst	bpf, docs: Fix ordering of bpf documentation	2021-11-17 23:24:01 +01:00
fs_kfuncs.rst	Documentation/bpf: Add documentation for filesystem kfuncs	2023-12-01 16:21:03 -08:00
graph_ds_impl.rst	Documentation: Fix typos	2023-08-18 11:29:03 -06:00
helpers.rst	bpf, docs: Fix ordering of bpf documentation	2021-11-17 23:24:01 +01:00
index.rst	Documentation/bpf: Add documentation for filesystem kfuncs	2023-12-01 16:21:03 -08:00
kfuncs.rst	bpf: Introduce KF_ARG_PTR_TO_CONST_STR	2023-11-09 19:07:38 -08:00
linux-notes.rst	bpf, docs: Move linux-notes.rst to root bpf docs tree	2023-08-30 16:35:44 +02:00
llvm_reloc.rst	docs/bpf: Fix "file doesn't exist" warnings in {llvm_reloc,btf}.rst	2023-09-01 15:56:48 +02:00
map_array.rst	docs/bpf: Fix sphinx warnings in BPF map docs	2022-11-24 01:05:04 +01:00
map_bloom_filter.rst	docs/bpf: Document BPF_MAP_TYPE_BLOOM_FILTER	2022-11-23 22:47:32 +01:00
map_cgroup_storage.rst	Remove duplicate words inside documentation	2022-09-27 13:21:43 -06:00
map_cgrp_storage.rst	docs/bpf: Add documentation for new cgroup local storage	2022-10-25 23:19:20 -07:00
map_cpumap.rst	docs/bpf: Fix sphinx warnings for cpumap	2022-11-23 22:38:53 +01:00
map_devmap.rst	docs/bpf: Fix sphinx warnings for devmap	2022-11-23 22:40:27 +01:00
map_hash.rst	docs/bpf: Add LRU internals description and graph	2023-04-27 14:20:44 +02:00
map_lpm_trie.rst	docs/bpf: Fix sphinx warnings in BPF map docs	2022-11-24 01:05:04 +01:00
map_lru_hash_update.dot	docs/bpf: Add LRU internals description and graph	2023-04-27 14:20:44 +02:00
map_of_maps.rst	docs/bpf: Fix sphinx warnings in BPF map docs	2022-11-24 01:05:04 +01:00
map_queue_stack.rst	docs/bpf: Fix sphinx warnings in BPF map docs	2022-11-24 01:05:04 +01:00
map_sk_storage.rst	docs/bpf: Reword docs for BPF_MAP_TYPE_SK_STORAGE	2022-12-14 18:35:41 +01:00
map_sockmap.rst	sock: Remove ->sendpage*() in favour of sendmsg(MSG_SPLICE_PAGES)	2023-06-24 15:50:13 -07:00
map_xskmap.rst	Documentation: bpf: correct spelling	2023-01-28 12:22:20 -08:00
maps.rst	bpf, docs: Fix final bpf docs build failure	2023-03-02 22:36:10 -08:00
other.rst	bpf, documentation: Add graph documentation for non-owning refs	2023-02-13 19:40:53 -08:00
prog_cgroup_sockopt.rst	bpf: Document EFAULT changes for sockopt	2023-05-13 16:55:46 -07:00
prog_cgroup_sysctl.rst	bpf: Document BPF_PROG_TYPE_CGROUP_SYSCTL	2019-04-18 16:05:36 -07:00
prog_flow_dissector.rst	docs/bpf: update out-of-date doc in BPF flow dissector	2023-09-13 14:22:57 -07:00
prog_lsm.rst	lsm: move hook comments docs to security/security.c	2023-04-28 11:58:34 -04:00
prog_sk_lookup.rst	bpf: sk_lookup: Add user documentation	2020-08-24 14:46:50 -07:00
programs.rst	docs/bpf: Add table of BPF program types to libbpf docs	2022-11-23 13:31:20 -08:00
redirect.rst	bpf, docs: DEVMAPs and XDP_REDIRECT	2022-11-18 23:16:31 +01:00
ringbuf.rst	Documentation: bpf: correct spelling	2023-01-28 12:22:20 -08:00
s390.rst	bpf: Add s390 testing documentation	2019-10-30 16:25:31 +01:00
syscall_api.rst	bpf, docs: Fix ordering of bpf documentation	2021-11-17 23:24:01 +01:00
test_debug.rst	bpf, docs: Fix ordering of bpf documentation	2021-11-17 23:24:01 +01:00
verifier.rst	docs/bpf: Add description of register liveness tracking algorithm	2023-02-02 20:21:59 -08:00