mirror of
https://github.com/torvalds/linux.git
synced 2026-03-08 02:44:41 +01:00
72c395024d
fair amount going on, including:
- Some signs of life on the long-moribund Japanese translation
- Documentation on policies around the use of generative tools for patch
submissions, and a separate document intended for consumption by
generative tools.
- The completion of the move of the documentation tools to tools/docs. For
now we're leaving a /scripts/kernel-doc symlink behind to avoid breaking
scripts.
- Ongoing build-system work includes the incorporation of documentation in
Python code, better support for documenting variables, and lots of
improvements and fixes.
- Automatic linking of man-page references -- cat(1), for example -- to
the online pages in the HTML build.
...and the usual array of typo fixes and such.
-----BEGIN PGP SIGNATURE-----
iQFDBAABCgAtFiEEIw+MvkEiF49krdp9F0NaE2wMflgFAmmKM8YPHGNvcmJldEBs
d24ubmV0AAoJEBdDWhNsDH5YLK4H/2gqVxY8wKbVymiB95/zudiba8EtWlKE4hZl
KAd4+csZ8RCTMxHJLI23FXOi56CYr3XOQol0DIDUGimQiQx/Cxa2QDWewpkqbNH1
tHPTaNWAj16wKzrZxXhWt+6FoBHd7wrqilLH180IRmezRhu+7kURQ5XEAAXfK08B
CfDXBsCpnGsKn+m72x04cpvnsf/iK3pznbKrZ0ZYGIoaZb6+BV3+jqVaLROWSQZt
Nvt1rYjsi0vaeNapbQL8q72UJ/+zO4nK9am13s7p20zD+jUVY48yfQB/ZqvHp/1L
aymcJUCq0h5sSOHnfSqY5MTZUR/0CK+npRcEPgDYzLBigc9XU9g=
=hHq1
-----END PGP SIGNATURE-----
Merge tag 'docs-7.0' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linux
Pull documentation updates from Jonathan Corbet:
"A slightly calmer cycle for docs this time around, though there is
still a fair amount going on, including:
- Some signs of life on the long-moribund Japanese translation
- Documentation on policies around the use of generative tools for
patch submissions, and a separate document intended for consumption
by generative tools
- The completion of the move of the documentation tools to
tools/docs. For now we're leaving a /scripts/kernel-doc symlink
behind to avoid breaking scripts
- Ongoing build-system work includes the incorporation of
documentation in Python code, better support for documenting
variables, and lots of improvements and fixes
- Automatic linking of man-page references -- cat(1), for example --
to the online pages in the HTML build
...and the usual array of typo fixes and such"
* tag 'docs-7.0' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linux: (107 commits)
doc: development-process: add notice on testing
tools: sphinx-build-wrapper: improve its help message
docs: sphinx-build-wrapper: allow -v override -q
docs: kdoc: Fix pdfdocs build for tools
docs: ja_JP: process: translate 'Obtain a current source tree'
docs: fix 're-use' -> 'reuse' in documentation
docs: ioctl-number: fix a typo in ioctl-number.rst
docs: filesystems: ensure proc pid substitutable is complete
docs: automarkup.py: Skip common English words as C identifiers
Documentation: use a source-read extension for the index link boilerplate
docs: parse_features: make documentation more consistent
docs: add parse_features module documentation
docs: jobserver: do some documentation improvements
docs: add jobserver module documentation
docs: kabi: helpers: add documentation for each "enum" value
docs: kabi: helpers: add helper for debug bits 7 and 8
docs: kabi: system_symbols: end docstring phrases with a dot
docs: python: abi_regex: do some improvements at documentation
docs: python: abi_parser: do some improvements at documentation
docs: add kabi modules documentation
...
143 lines
2.5 KiB
ReStructuredText
143 lines
2.5 KiB
ReStructuredText
======================
|
|
Core API Documentation
|
|
======================
|
|
|
|
This is the beginning of a manual for core kernel APIs. The conversion
|
|
(and writing!) of documents for this manual is much appreciated!
|
|
|
|
Core utilities
|
|
==============
|
|
|
|
This section has general and "core core" documentation. The first is a
|
|
massive grab-bag of kerneldoc info left over from the docbook days; it
|
|
should really be broken up someday when somebody finds the energy to do
|
|
it.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
kernel-api
|
|
workqueue
|
|
watch_queue
|
|
printk-basics
|
|
printk-formats
|
|
printk-index
|
|
symbol-namespaces
|
|
asm-annotations
|
|
real-time/index
|
|
housekeeping.rst
|
|
|
|
Data structures and low-level utilities
|
|
=======================================
|
|
|
|
Library functionality that is used throughout the kernel.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
kobject
|
|
kref
|
|
cleanup
|
|
assoc_array
|
|
folio_queue
|
|
xarray
|
|
maple_tree
|
|
idr
|
|
circular-buffers
|
|
rbtree
|
|
generic-radix-tree
|
|
packing
|
|
this_cpu_ops
|
|
timekeeping
|
|
errseq
|
|
wrappers/atomic_t
|
|
wrappers/atomic_bitops
|
|
floating-point
|
|
union_find
|
|
min_heap
|
|
parser
|
|
list
|
|
|
|
Low level entry and exit
|
|
========================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
entry
|
|
|
|
Concurrency primitives
|
|
======================
|
|
|
|
How Linux keeps everything from happening at the same time. See
|
|
Documentation/locking/index.rst for more related documentation.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
refcount-vs-atomic
|
|
irq/index
|
|
local_ops
|
|
padata
|
|
../RCU/index
|
|
wrappers/memory-barriers.rst
|
|
|
|
Low-level hardware management
|
|
=============================
|
|
|
|
Cache management, managing CPU hotplug, etc.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
cachetlb
|
|
cpu_hotplug
|
|
memory-hotplug
|
|
genericirq
|
|
protection-keys
|
|
|
|
Memory management
|
|
=================
|
|
|
|
How to allocate and use memory in the kernel. Note that there is a lot
|
|
more memory-management documentation in Documentation/mm/index.rst.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
memory-allocation
|
|
unaligned-memory-access
|
|
dma-api
|
|
dma-api-howto
|
|
dma-attributes
|
|
dma-isa-lpc
|
|
swiotlb
|
|
mm-api
|
|
cgroup
|
|
genalloc
|
|
pin_user_pages
|
|
boot-time-mm
|
|
gfp_mask-from-fs-io
|
|
kho/index
|
|
|
|
Interfaces for kernel debugging
|
|
===============================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
debug-objects
|
|
tracepoint
|
|
debugging-via-ohci1394
|
|
|
|
Everything else
|
|
===============
|
|
|
|
Documents that don't fit elsewhere or which have yet to be categorized.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
librs
|
|
liveupdate
|
|
netlink
|