Documentation/index.rst

   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
   6 .. _linux_doc:
   7
   8 The Linux Kernel documentation
   9 ==============================
  10
  11 This is the top level of the kernel's documentation tree.  Kernel
  12 documentation, like the kernel itself, is very much a work in progress;
  13 that is especially true as we work to integrate our many scattered
  14 documents into a coherent whole.  Please note that improvements to the
  15 documentation are welcome; join the linux-doc list at vger.kernel.org if
  16 you want to help out.
  17
  18 Licensing documentation
  19 -----------------------
  20
  21 The following describes the license of the Linux kernel source code
  22 (GPLv2), how to properly mark the license of individual files in the source
  23 tree, as well as links to the full license text.
  24
  25 * :ref:`kernel_licensing`
  26
  27 User-oriented documentation
  28 ---------------------------
  29
  30 The following manuals are written for *users* of the kernel — those who are
  31 trying to get it to work optimally on a given system.
  32
  33 .. toctree::
  34    :maxdepth: 2
  35
  36    admin-guide/index
  37
  38 Firmware-related documentation
  39 ------------------------------
  40 The following holds information on the kernel's expectations regarding the
  41 platform firmwares.
  42
  43 .. toctree::
  44    :maxdepth: 2
  45
  46    firmware-guide/index
  47
  48 Application-developer documentation
  49 -----------------------------------
  50
  51 The user-space API manual gathers together documents describing aspects of
  52 the kernel interface as seen by application developers.
  53
  54 .. toctree::
  55    :maxdepth: 2
  56
  57    userspace-api/index
  58
  59
  60 Introduction to kernel development
  61 ----------------------------------
  62
  63 These manuals contain overall information about how to develop the kernel.
  64 The kernel community is quite large, with thousands of developers
  65 contributing over the course of a year.  As with any large community,
  66 knowing how things are done will make the process of getting your changes
  67 merged much easier.
  68
  69 .. toctree::
  70    :maxdepth: 2
  71
  72    process/index
  73    dev-tools/index
  74    doc-guide/index
  75    kernel-hacking/index
  76    trace/index
  77    maintainer/index
  78
  79 Kernel API documentation
  80 ------------------------
  81
  82 These books get into the details of how specific kernel subsystems work
  83 from the point of view of a kernel developer.  Much of the information here
  84 is taken directly from the kernel source, with supplemental material added
  85 as needed (or at least as we managed to add it — probably *not* all that is
  86 needed).
  87
  88 .. toctree::
  89    :maxdepth: 2
  90
  91    driver-api/index
  92    core-api/index
  93    infiniband/index
  94    media/index
  95    networking/index
  96    input/index
  97    hwmon/index
  98    gpu/index
  99    security/index
 100    sound/index
 101    crypto/index
 102    filesystems/index
 103    vm/index
 104    bpf/index
 105    usb/index
 106    PCI/index
 107    misc-devices/index
 108
 109 Architecture-specific documentation
 110 -----------------------------------
 111
 112 These books provide programming details about architecture-specific
 113 implementation.
 114
 115 .. toctree::
 116    :maxdepth: 2
 117
 118    sh/index
 119    x86/index
 120
 121 Filesystem Documentation
 122 ------------------------
 123
 124 The documentation in this section are provided by specific filesystem
 125 subprojects.
 126
 127 .. toctree::
 128    :maxdepth: 2
 129
 130    filesystems/ext4/index
 131
 132 Translations
 133 ------------
 134
 135 .. toctree::
 136    :maxdepth: 2
 137
 138    translations/index
 139
 140 Indices and tables
 141 ==================
 142
 143 * :ref:`genindex`