blob: 02de1d46842ab7680ab8bc84fe122a120198c245 [file] [log] [blame]
Heinrich Schuchardt04459782018-07-29 13:45:47 +02001.. SPDX-License-Identifier: GPL-2.0+
Mario Six78a88f72018-07-10 08:40:17 +02002
Bin Mengf0e608b2019-07-18 00:33:47 -07003.. _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
Mario Six78a88f72018-07-10 08:40:17 +020017
Bin Meng7114d892019-10-27 05:19:45 -070018User-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
Heinrich Schuchardtd2472de2020-12-12 08:50:37 +010028 usage/index
Bin Meng7114d892019-10-27 05:19:45 -070029
Heinrich Schuchardt932b8f82020-04-24 23:31:20 +020030Developer-oriented documentation
31--------------------------------
32
33The following manuals are written for *developers* of the U-Boot - those who
34want to contribute to U-Boot.
35
36.. toctree::
37 :maxdepth: 2
38
39 develop/index
40
Bin Mengd9756c42019-07-18 00:33:48 -070041
Bin Mengc8fe9162019-07-18 00:33:46 -070042U-Boot API documentation
43------------------------
Mario Six78a88f72018-07-10 08:40:17 +020044
Bin Mengc8fe9162019-07-18 00:33:46 -070045These books get into the details of how specific U-Boot subsystems work
46from the point of view of a U-Boot developer. Much of the information here
47is taken directly from the U-Boot source, with supplemental material added
48as needed (or at least as we managed to add it - probably *not* all that is
49needed).
50
51.. toctree::
52 :maxdepth: 2
53
54 api/index
Bin Mengf0e608b2019-07-18 00:33:47 -070055
Bin Mengd8381382019-07-18 00:34:02 -070056Architecture-specific doc
57-------------------------
58
59These books provide programming details about architecture-specific
60implementation.
61
62.. toctree::
63 :maxdepth: 2
64
65 arch/index
66
Bin Meng428c3f52019-07-18 00:34:04 -070067Board-specific doc
68------------------
69
70These books provide details about board-specific information. They are
71organized in a vendor subdirectory.
72
73.. toctree::
74 :maxdepth: 2
75
76 board/index
77
Sam Protsenko586a1bf2020-01-24 17:53:44 +020078Android-specific doc
79--------------------
80
81These books provide information about booting the Android OS from U-Boot,
82manipulating Android images from U-Boot shell and discusses other
83Android-specific features available in U-Boot.
84
85.. toctree::
86 :maxdepth: 2
87
88 android/index
89
Simon Glass2d0423a2021-03-15 18:11:20 +130090Chromium OS-specific doc
91------------------------
92
93.. toctree::
94 :maxdepth: 2
95
96 chromium/index
97
Bin Mengf0e608b2019-07-18 00:33:47 -070098Indices and tables
99==================
100
101* :ref:`genindex`