[GIT PULL] Documentation for 6.2

From: Jonathan Corbet
Date: Mon Dec 12 2022 - 04:26:01 EST

The following changes since commit 2f3f53d62307262f0086804ea7cea99b0e085450:

docs/process/howto: Replace C89 with C11 (2022-10-24 11:27:51 -0600)

are available in the Git repository at:

git://git.lwn.net/linux.git tags/docs-6.2

for you to fetch changes up to cc8c418b4fc09ed58ddd27b8e90ec797e9ca1e67:

Documentation/features: Use loongarch instead of loong (2022-12-05 02:50:12 -0700)

----------------------------------------------------------------
This was a not-too-busy cycle for documentation; highlights include:

- The beginnings of a set of translations into Spanish, headed up by Carlos
Bilbao.

- More Chinese translations.

- A change to the Sphinx "alabaster" theme by default for HTML generation.
Unlike the previous default (Read the Docs), alabaster is shipped with
Sphinx by default, reducing the number of other dependencies that need to
be installed. It also (IMO) produces a cleaner and more readable result.

- The ability to render the documentation into the texinfo format
(something Sphinx could always do, we just never wired it up until now).

Plus the usual collection of typo fixes, build-warning fixes, and minor
updates.

MEA CULPA: there is a messy set of merges into docs-next that really
should not be there. I tried a different Git workflow this time around
and clearly didn't get it quite right. Those merges were not meant to be
in the history at all, but I misbased the alabaster work and, worse,
didn't notice until now. I've opted to show my messiness to the world
rather than engage in last-second rebasing, but I can easily clean that
up if you would prefer. Won't happen again either way.

----------------------------------------------------------------
Akira Yokosawa (2):
docs/ja_JP/howto: Update for v6.1
docs/zh_CN: Fix '.. only::' directive's expression

Albert Zhou (1):
Documentation: eisa: Fix typo

Alexander Potapenko (1):
docs: kmsan: fix formatting of "Example report"

Binbin Zhou (3):
docs/zh_CN: core-api: Add this_cpu_ops Chinese translation
docs/zh_CN: core-api: Add timekeeping Chinese translation
docs/zh_CN: core-api: Add errseq Chinese translation

Björn Töpel (1):
Documentation: riscv: Document the sv57 VM layout

Carlos Bilbao (10):
Documentation: Start translations to Spanish
Documentation: Add HOWTO Spanish translation into rst based build system
docs/sp_SP: Add process submitting-patches translation
docs: Update maintainer of kernel-docs.rst
docs: Retire old resources from kernel-docs.rst
docs: Add book to process/kernel-docs.rst
docs: Create translations/sp_SP/process/, move submitting-patches.rst
docs/sp_SP: Add kernel-docs.rst Spanish translation
docs/sp_SP: Add process coding-style translation
docs/sp_SP: Add memory-barriers.txt Spanish translation

Chen Linxuan (1):
Documentation: update the description of TracerPid in procfs.rst

Daniel Vetter (1):
docs/sphinx: More depth in the rtd sidebar toc

David Heidelberg (1):
Docs/admin-guide/mm/zswap: remove a paragraph about zswap being a new feature

Jonathan Corbet (15):
Merge branch 'docs-mw' into docs-next
Merge branch 'docs-mw' into docs-next
Merge branch 'docs-mw' into docs-next
Merge branch 'docs-mw' into docs-next
Merge branch 'docs-mw' into docs-next
docs: Switch the default HTML theme to alabaster
docs: tweak some Alabaster style parameters
docs: update sphinx.rst to reflect the default theme change
docs: sphinx-pre-install: don't require the RTD theme
docs: improve the HTML formatting of kerneldoc comments
docs: decruft Documentation/conf.py
Merge branch 'alabaster-rb' into docs-mw
Revert "docs/zh_CN: core-api: Add timekeeping Chinese translation"
docs: Don't wire font sizes for HTML output
Merge branch 'docs-fixes' into docs-mw

Jonathan Neuschäfer (2):
docs: admin-guide: hw_random: Make document title more generic and concise
docs: ia64: Fix a typo ("identify mappings")

Kushagra Verma (1):
Documentation: Fixed a typo in bootconfig.rst

Liam Beguin (3):
math64: favor kernel-doc from header files
math64: add kernel-doc for DIV64_U64_ROUND_UP
math64: fix kernel-doc return value warnings

Maxim Cournoyer (1):
doc: add texinfodocs and infodocs targets

Pali Rohár (1):
Documentation: arm: marvell: Add Orion codenames and archive homepage

Randy Dunlap (3):
sysfs: update Documentation
debugfs: small Documentation cleaning
Documentation: USB: correct possessive "its" usage

Rui Li (9):
docs/zh_CN: Add userspace-api/index Chinese translation
docs/zh_CN: Add userspace-api/ebpf Chinese translation
docs/zh_CN: Add staging/index Chinese translation
docs/zh_CN: Add staging/xz Chinese translation
docs/zh_CN: Add userspace-api/no_new_privs Chinese translation
docs/zh_CN: Add userspace-api/sysfs-platform_profile Chinese translation
docs/zh_CN: Add userspace-api/seccomp_filter Chinese translation
docs/zh_CN: Add userspace-api/futex2 Chinese translation
docs/zh_CN: Add userspace-api/accelerators/ocxl Chinese translation

Stephen Kitt (5):
docs: sysctl/fs: remove references to inode-max
docs: sysctl/fs: remove references to dquot-max/-nr
docs: sysctl/fs: merge the aio sections
docs: sysctl/fs: remove references to super-max/-nr
docs: sysctl/fs: re-order, prettify

Tiezhu Yang (4):
docs/LoongArch: Update links of LoongArch ISA Vol1 and ELF psABI
docs/zh_CN/LoongArch: Update links of LoongArch ISA Vol1 and ELF psABI
Documentation/features-refresh.sh: Only sed the beginning "arch" of ARCH_DIR
Documentation/features: Use loongarch instead of loong

Wei Li (1):
Documentation/features: Update feature lists for 6.1

Yang Yingliang (3):
Documentation: devres: add missing IIO helpers
Documentation: devres: add missing LED helpers
Documentation: devres: add missing PWM helper

Yanteng Si (5):
docs/zh_CN: Add rust index Chinese translation
docs/zh_CN: Add rust quick-start Chinese translation
docs/zh_CN: Add rust general-information Chinese translation
docs/zh_CN: Add rust coding-guidelines Chinese translation
docs/zh_CN: Add rust arch-support Chinese translation

Documentation/Makefile | 11 +
Documentation/admin-guide/bootconfig.rst | 2 +-
Documentation/admin-guide/hw_random.rst | 6 +-
Documentation/admin-guide/mm/zswap.rst | 8 +-
Documentation/admin-guide/sysctl/fs.rst | 240 +-
Documentation/admin-guide/sysctl/kernel.rst | 2 +
Documentation/arm/marvell.rst | 12 +-
Documentation/conf.py | 211 +-
Documentation/core-api/kernel-api.rst | 3 -
Documentation/dev-tools/kmsan.rst | 1 +
Documentation/doc-guide/sphinx.rst | 16 +-
Documentation/driver-api/driver-model/devres.rst | 8 +
Documentation/driver-api/eisa.rst | 2 +-
.../features/core/cBPF-JIT/arch-support.txt | 2 +-
.../features/core/eBPF-JIT/arch-support.txt | 2 +-
.../core/generic-idle-thread/arch-support.txt | 2 +-
.../features/core/jump-labels/arch-support.txt | 4 +-
.../core/thread-info-in-task/arch-support.txt | 2 +-
.../features/core/tracehook/arch-support.txt | 2 +-
.../features/debug/KASAN/arch-support.txt | 4 +-
.../debug/debug-vm-pgtable/arch-support.txt | 2 +-
.../debug/gcov-profile-all/arch-support.txt | 2 +-
Documentation/features/debug/kcov/arch-support.txt | 2 +-
Documentation/features/debug/kgdb/arch-support.txt | 2 +-
.../features/debug/kmemleak/arch-support.txt | 2 +-
.../debug/kprobes-on-ftrace/arch-support.txt | 2 +-
.../features/debug/kprobes/arch-support.txt | 2 +-
.../features/debug/kretprobes/arch-support.txt | 2 +-
.../features/debug/optprobes/arch-support.txt | 2 +-
.../features/debug/stackprotector/arch-support.txt | 2 +-
.../features/debug/uprobes/arch-support.txt | 2 +-
.../debug/user-ret-profiler/arch-support.txt | 2 +-
.../features/io/dma-contiguous/arch-support.txt | 2 +-
.../locking/cmpxchg-local/arch-support.txt | 2 +-
.../features/locking/lockdep/arch-support.txt | 2 +-
.../locking/queued-rwlocks/arch-support.txt | 2 +-
.../locking/queued-spinlocks/arch-support.txt | 4 +-
.../features/perf/kprobes-event/arch-support.txt | 2 +-
.../features/perf/perf-regs/arch-support.txt | 2 +-
.../features/perf/perf-stackdump/arch-support.txt | 2 +-
.../sched/membarrier-sync-core/arch-support.txt | 2 +-
.../features/sched/numa-balancing/arch-support.txt | 2 +-
Documentation/features/scripts/features-refresh.sh | 2 +-
.../seccomp/seccomp-filter/arch-support.txt | 2 +-
.../time/arch-tick-broadcast/arch-support.txt | 2 +-
.../features/time/clockevents/arch-support.txt | 2 +-
.../time/context-tracking/arch-support.txt | 2 +-
.../features/time/irq-time-acct/arch-support.txt | 2 +-
.../features/time/virt-cpuacct/arch-support.txt | 2 +-
.../features/vm/ELF-ASLR/arch-support.txt | 2 +-
.../features/vm/PG_uncached/arch-support.txt | 2 +-
Documentation/features/vm/THP/arch-support.txt | 2 +-
Documentation/features/vm/TLB/arch-support.txt | 2 +-
.../features/vm/huge-vmap/arch-support.txt | 2 +-
.../features/vm/ioremap_prot/arch-support.txt | 2 +-
.../features/vm/pte_special/arch-support.txt | 2 +-
Documentation/filesystems/debugfs.rst | 8 +-
Documentation/filesystems/proc.rst | 3 +-
Documentation/filesystems/sysfs.rst | 41 +-
Documentation/ia64/aliasing.rst | 2 +-
Documentation/loongarch/introduction.rst | 8 +-
Documentation/process/kernel-docs.rst | 477 +--
Documentation/riscv/vm-layout.rst | 36 +
Documentation/sphinx-static/custom.css | 29 +
Documentation/sphinx/requirements.txt | 1 -
Documentation/translations/index.rst | 1 +
Documentation/translations/ja_JP/howto.rst | 66 +-
Documentation/translations/sp_SP/disclaimer-sp.rst | 6 +
Documentation/translations/sp_SP/howto.rst | 617 ++++
Documentation/translations/sp_SP/index.rst | 81 +
.../translations/sp_SP/memory-barriers.txt | 3134 ++++++++++++++++++++
.../translations/sp_SP/process/coding-style.rst | 1315 ++++++++
Documentation/translations/sp_SP/process/index.rst | 15 +
.../translations/sp_SP/process/kernel-docs.rst | 187 ++
.../sp_SP/process/submitting-patches.rst | 894 ++++++
.../sp_SP/wrappers/memory-barriers.rst | 19 +
.../translations/zh_CN/core-api/errseq.rst | 145 +
.../translations/zh_CN/core-api/index.rst | 6 +-
.../translations/zh_CN/core-api/this_cpu_ops.rst | 285 ++
.../translations/zh_CN/doc-guide/index.rst | 2 +-
Documentation/translations/zh_CN/index.rst | 11 +-
.../translations/zh_CN/loongarch/introduction.rst | 8 +-
.../translations/zh_CN/rust/arch-support.rst | 23 +
.../translations/zh_CN/rust/coding-guidelines.rst | 192 ++
.../zh_CN/rust/general-information.rst | 75 +
Documentation/translations/zh_CN/rust/index.rst | 28 +
.../translations/zh_CN/rust/quick-start.rst | 211 ++
Documentation/translations/zh_CN/staging/index.rst | 26 +
Documentation/translations/zh_CN/staging/xz.rst | 100 +
.../zh_CN/userspace-api/accelerators/ocxl.rst | 168 ++
.../zh_CN/userspace-api/ebpf/index.rst | 22 +
.../zh_CN/userspace-api/ebpf/syscall.rst | 29 +
.../translations/zh_CN/userspace-api/futex2.rst | 80 +
.../translations/zh_CN/userspace-api/index.rst | 50 +
.../zh_CN/userspace-api/no_new_privs.rst | 57 +
.../zh_CN/userspace-api/seccomp_filter.rst | 293 ++
.../zh_CN/userspace-api/sysfs-platform_profile.rst | 40 +
Documentation/usb/CREDITS | 6 +-
Documentation/usb/functionfs.rst | 2 +-
Documentation/usb/gadget_multi.rst | 2 +-
Documentation/userspace-api/media/Makefile | 3 +-
MAINTAINERS | 10 +
Makefile | 2 +-
include/linux/math64.h | 26 +-
lib/math/div64.c | 15 +-
scripts/kernel-doc | 54 +-
scripts/sphinx-pre-install | 8 -
107 files changed, 8540 insertions(+), 993 deletions(-)
create mode 100644 Documentation/sphinx-static/custom.css
create mode 100644 Documentation/translations/sp_SP/disclaimer-sp.rst
create mode 100644 Documentation/translations/sp_SP/howto.rst
create mode 100644 Documentation/translations/sp_SP/index.rst
create mode 100644 Documentation/translations/sp_SP/memory-barriers.txt
create mode 100644 Documentation/translations/sp_SP/process/coding-style.rst
create mode 100644 Documentation/translations/sp_SP/process/index.rst
create mode 100644 Documentation/translations/sp_SP/process/kernel-docs.rst
create mode 100644 Documentation/translations/sp_SP/process/submitting-patches.rst
create mode 100644 Documentation/translations/sp_SP/wrappers/memory-barriers.rst
create mode 100644 Documentation/translations/zh_CN/core-api/errseq.rst
create mode 100644 Documentation/translations/zh_CN/core-api/this_cpu_ops.rst
create mode 100644 Documentation/translations/zh_CN/rust/arch-support.rst
create mode 100644 Documentation/translations/zh_CN/rust/coding-guidelines.rst
create mode 100644 Documentation/translations/zh_CN/rust/general-information.rst
create mode 100644 Documentation/translations/zh_CN/rust/index.rst
create mode 100644 Documentation/translations/zh_CN/rust/quick-start.rst
create mode 100644 Documentation/translations/zh_CN/staging/index.rst
create mode 100644 Documentation/translations/zh_CN/staging/xz.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/accelerators/ocxl.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/ebpf/index.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/ebpf/syscall.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/futex2.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/index.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/no_new_privs.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/seccomp_filter.rst
create mode 100644 Documentation/translations/zh_CN/userspace-api/sysfs-platform_profile.rst