]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame_incremental - Documentation/index.rst
x86/kvm: Expose X86_FEATURE_MD_CLEAR to guests
[mirror_ubuntu-bionic-kernel.git] / Documentation / index.rst
... / ...
CommitLineData
1.. The Linux Kernel documentation master file, created by
2 sphinx-quickstart on Fri Feb 12 13:51:46 2016.
3 You can adapt this file completely to your liking, but it should at least
4 contain the root `toctree` directive.
5
6The Linux Kernel documentation
7==============================
8
9This is the top level of the kernel's documentation tree. Kernel
10documentation, like the kernel itself, is very much a work in progress;
11that is especially true as we work to integrate our many scattered
12documents into a coherent whole. Please note that improvements to the
13documentation are welcome; join the linux-doc list at vger.kernel.org if
14you want to help out.
15
16User-oriented documentation
17---------------------------
18
19The following manuals are written for *users* of the kernel — those who are
20trying to get it to work optimally on a given system.
21
22.. toctree::
23 :maxdepth: 2
24
25 admin-guide/index
26
27Application-developer documentation
28-----------------------------------
29
30The user-space API manual gathers together documents describing aspects of
31the kernel interface as seen by application developers.
32
33.. toctree::
34 :maxdepth: 2
35
36 userspace-api/index
37
38
39Introduction to kernel development
40----------------------------------
41
42These manuals contain overall information about how to develop the kernel.
43The kernel community is quite large, with thousands of developers
44contributing over the course of a year. As with any large community,
45knowing how things are done will make the process of getting your changes
46merged much easier.
47
48.. toctree::
49 :maxdepth: 2
50
51 process/index
52 dev-tools/index
53 doc-guide/index
54 kernel-hacking/index
55
56Kernel API documentation
57------------------------
58
59These books get into the details of how specific kernel subsystems work
60from the point of view of a kernel developer. Much of the information here
61is taken directly from the kernel source, with supplemental material added
62as needed (or at least as we managed to add it — probably *not* all that is
63needed).
64
65.. toctree::
66 :maxdepth: 2
67
68 driver-api/index
69 core-api/index
70 media/index
71 networking/index
72 input/index
73 gpu/index
74 security/index
75 sound/index
76 crypto/index
77 filesystems/index
78
79Architecture-specific documentation
80-----------------------------------
81
82These books provide programming details about architecture-specific
83implementation.
84
85.. toctree::
86 :maxdepth: 2
87
88 sh/index
89
90Korean translations
91-------------------
92
93.. toctree::
94 :maxdepth: 1
95
96 translations/ko_KR/index
97
98Chinese translations
99--------------------
100
101.. toctree::
102 :maxdepth: 1
103
104 translations/zh_CN/index
105
106Japanese translations
107---------------------
108
109.. toctree::
110 :maxdepth: 1
111
112 translations/ja_JP/index
113
114Indices and tables
115==================
116
117* :ref:`genindex`