]> git.ipfire.org Git - thirdparty/u-boot.git/blame - doc/index.rst
Merge tag 'dm-pull-30may20' of https://gitlab.denx.de/u-boot/custodians/u-boot-dm
[thirdparty/u-boot.git] / doc / index.rst
CommitLineData
04459788 1.. SPDX-License-Identifier: GPL-2.0+
78a88f79 2
f0e608bc
BM
3.. _u-boot_doc:
4
5The U-Boot Documentation
6========================
7
8This is the top level of the U-Boot's documentation tree. U-Boot
9documentation, like the U-Boot itself, is very much a work in progress;
10that is especially true as we work to integrate our many scattered
11documents into a coherent whole. Please note that improvements to the
12documentation are welcome; join the U-Boot list at http://lists.denx.de
13if you want to help out.
14
15.. toctree::
16 :maxdepth: 2
78a88f79 17
7114d89e
BM
18User-oriented documentation
19---------------------------
20
21The following manuals are written for *users* of the U-Boot - those who are
22trying to get it to work optimally on a given system.
23
24.. toctree::
25 :maxdepth: 2
26
27 build/index
28
932b8f8c
HS
29Developer-oriented documentation
30--------------------------------
31
32The following manuals are written for *developers* of the U-Boot - those who
33want to contribute to U-Boot.
34
35.. toctree::
36 :maxdepth: 2
37
38 develop/index
39
73d95c24
HS
40Unified Extensible Firmware (UEFI)
41----------------------------------
42
43U-Boot provides an implementation of the UEFI API allowing to run UEFI
44compliant software like Linux, GRUB, and iPXE. Furthermore U-Boot itself
45can be run an UEFI payload.
46
47.. toctree::
48 :maxdepth: 2
49
50 uefi/index
51
d9756c41
BM
52Driver-Model documentation
53--------------------------
73d95c24 54
d9756c41
BM
55The following holds information on the U-Boot device driver framework:
56driver-model, including the design details of itself and several driver
57subsystems.
58
59.. toctree::
60 :maxdepth: 2
61
62 driver-model/index
63
c8fe916c
BM
64U-Boot API documentation
65------------------------
66
67These books get into the details of how specific U-Boot subsystems work
68from the point of view of a U-Boot developer. Much of the information here
69is taken directly from the U-Boot source, with supplemental material added
70as needed (or at least as we managed to add it - probably *not* all that is
71needed).
72
04459788 73.. toctree::
c8fe916c 74 :maxdepth: 2
78a88f79 75
c8fe916c 76 api/index
f0e608bc 77
d8381386
BM
78Architecture-specific doc
79-------------------------
80
81These books provide programming details about architecture-specific
82implementation.
83
84.. toctree::
85 :maxdepth: 2
86
87 arch/index
88
428c3f55
BM
89Board-specific doc
90------------------
91
92These books provide details about board-specific information. They are
93organized in a vendor subdirectory.
94
95.. toctree::
96 :maxdepth: 2
97
98 board/index
99
586a1bf5
SP
100Android-specific doc
101--------------------
102
103These books provide information about booting the Android OS from U-Boot,
104manipulating Android images from U-Boot shell and discusses other
105Android-specific features available in U-Boot.
106
107.. toctree::
108 :maxdepth: 2
109
110 android/index
111
f0e608bc
BM
112Indices and tables
113==================
114
115* :ref:`genindex`