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    peci/index
 140
 141 Architecture-agnostic documentation
 142 -----------------------------------
 143
 144 .. toctree::
 145    :maxdepth: 2
 146
 147    asm-annotations
 148
 149 Architecture-specific documentation
 150 -----------------------------------
 151
 152 .. toctree::
 153    :maxdepth: 2
 154
 155    arch
 156
 157
 158 Other documentation
 159 -------------------
 160
 161 There are several unsorted documents that don't seem to fit on other parts
 162 of the documentation body, or may require some adjustments and/or conversion
 163 to ReStructured Text format, or are simply too old.
 164
 165 .. toctree::
 166    :maxdepth: 2
 167
 168    tools/index
 169    staging/index
 170
 171
 172 Translations
 173 ------------
 174
 175 .. toctree::
 176    :maxdepth: 2
 177
 178    translations/index
 179
 180 Indices and tables
 181 ==================
 182
 183 * :ref:`genindex`