Merge https://gitlab.denx.de/u-boot/custodians/u-boot-fsl-qoriq
[platform/kernel/u-boot.git] / doc / index.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 .. _u-boot_doc:
4
5 The U-Boot Documentation
6 ========================
7
8 This is the top level of the U-Boot's documentation tree.  U-Boot
9 documentation, like the U-Boot 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 U-Boot list at http://lists.denx.de
13 if you want to help out.
14
15 .. toctree::
16    :maxdepth: 2
17
18 Unified Extensible Firmware (UEFI)
19 ----------------------------------
20
21 U-Boot provides an implementation of the UEFI API allowing to run UEFI
22 compliant software like Linux, GRUB, and iPXE. Furthermore U-Boot itself
23 can be run an UEFI payload.
24
25 .. toctree::
26    :maxdepth: 2
27
28    uefi/index
29
30 Driver-Model documentation
31 --------------------------
32
33 The following holds information on the U-Boot device driver framework:
34 driver-model, including the design details of itself and several driver
35 subsystems.
36
37 .. toctree::
38    :maxdepth: 2
39
40    driver-model/index
41
42 U-Boot API documentation
43 ------------------------
44
45 These books get into the details of how specific U-Boot subsystems work
46 from the point of view of a U-Boot developer.  Much of the information here
47 is taken directly from the U-Boot source, with supplemental material added
48 as needed (or at least as we managed to add it - probably *not* all that is
49 needed).
50
51 .. toctree::
52    :maxdepth: 2
53
54    api/index
55
56 Architecture-specific doc
57 -------------------------
58
59 These books provide programming details about architecture-specific
60 implementation.
61
62 .. toctree::
63    :maxdepth: 2
64
65    arch/index
66
67 Board-specific doc
68 ------------------
69
70 These books provide details about board-specific information. They are
71 organized in a vendor subdirectory.
72
73 .. toctree::
74    :maxdepth: 2
75
76    board/index
77
78 Indices and tables
79 ==================
80
81 * :ref:`genindex`