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