Documentation/index.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3
   4 .. The Linux Kernel documentation master file, created by
   5    sphinx-quickstart on Fri Feb 12 13:51:46 2016.
   6    You can adapt this file completely to your liking, but it should at least
   7    contain the root `toctree` directive.
   8
   9 .. _linux_doc:
  10
  11 The Linux Kernel documentation
  12 ==============================
  13
  14 This is the top level of the kernel's documentation tree.  Kernel
  15 documentation, like the kernel itself, is very much a work in progress;
  16 that is especially true as we work to integrate our many scattered
  17 documents into a coherent whole.  Please note that improvements to the
  18 documentation are welcome; join the linux-doc list at vger.kernel.org if
  19 you want to help out.
  20
  21 Licensing documentation
  22 -----------------------
  23
  24 The following describes the license of the Linux kernel source code
  25 (GPLv2), how to properly mark the license of individual files in the source
  26 tree, as well as links to the full license text.
  27
  28 * :ref:`kernel_licensing`
  29
  30 User-oriented documentation
  31 ---------------------------
  32
  33 The following manuals are written for *users* of the kernel — those who are
  34 trying to get it to work optimally on a given system.
  35
  36 .. toctree::
  37    :maxdepth: 2
  38
  39    admin-guide/index
  40    kbuild/index
  41
  42 Firmware-related documentation
  43 ------------------------------
  44 The following holds information on the kernel's expectations regarding the
  45 platform firmwares.
  46
  47 .. toctree::
  48    :maxdepth: 2
  49
  50    firmware-guide/index
  51    devicetree/index
  52
  53 Application-developer documentation
  54 -----------------------------------
  55
  56 The user-space API manual gathers together documents describing aspects of
  57 the kernel interface as seen by application developers.
  58
  59 .. toctree::
  60    :maxdepth: 2
  61
  62    userspace-api/index
  63
  64
  65 Introduction to kernel development
  66 ----------------------------------
  67
  68 These manuals contain overall information about how to develop the kernel.
  69 The kernel community is quite large, with thousands of developers
  70 contributing over the course of a year.  As with any large community,
  71 knowing how things are done will make the process of getting your changes
  72 merged much easier.
  73
  74 .. toctree::
  75    :maxdepth: 2
  76
  77    process/index
  78    dev-tools/index
  79    doc-guide/index
  80    kernel-hacking/index
  81    trace/index
  82    maintainer/index
  83    fault-injection/index
  84    livepatch/index
  85
  86
  87 Kernel API documentation
  88 ------------------------
  89
  90 These books get into the details of how specific kernel subsystems work
  91 from the point of view of a kernel developer.  Much of the information here
  92 is taken directly from the kernel source, with supplemental material added
  93 as needed (or at least as we managed to add it — probably *not* all that is
  94 needed).
  95
  96 .. toctree::
  97    :maxdepth: 2
  98
  99    driver-api/index
 100    core-api/index
 101    locking/index
 102    accounting/index
 103    block/index
 104    cdrom/index
 105    cpu-freq/index
 106    fb/index
 107    fpga/index
 108    hid/index
 109    i2c/index
 110    iio/index
 111    isdn/index
 112    infiniband/index
 113    leds/index
 114    netlabel/index
 115    networking/index
 116    pcmcia/index
 117    power/index
 118    target/index
 119    timers/index
 120    spi/index
 121    w1/index
 122    watchdog/index
 123    virt/index
 124    input/index
 125    hwmon/index
 126    gpu/index
 127    security/index
 128    sound/index
 129    crypto/index
 130    filesystems/index
 131    vm/index
 132    bpf/index
 133    usb/index
 134    PCI/index
 135    scsi/index
 136    misc-devices/index
 137    scheduler/index
 138    mhi/index
 139    tty/index
 140    peci/index
 141
 142 Architecture-agnostic documentation
 143 -----------------------------------
 144
 145 .. toctree::
 146    :maxdepth: 2
 147
 148    asm-annotations
 149
 150 Architecture-specific documentation
 151 -----------------------------------
 152
 153 .. toctree::
 154    :maxdepth: 2
 155
 156    arch
 157
 158
 159 Other documentation
 160 -------------------
 161
 162 There are several unsorted documents that don't seem to fit on other parts
 163 of the documentation body, or may require some adjustments and/or conversion
 164 to ReStructured Text format, or are simply too old.
 165
 166 .. toctree::
 167    :maxdepth: 2
 168
 169    tools/index
 170    staging/index
 171
 172
 173 Translations
 174 ------------
 175
 176 .. toctree::
 177    :maxdepth: 2
 178
 179    translations/index
 180
 181 Indices and tables
 182 ==================
 183
 184 * :ref:`genindex`