index.rst 3.1 KB

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