blob: 8066fcbfc0b87965407f48740d71905e5c95935b [file] [log] [blame]
Heinrich Schuchardt653a5472018-07-29 13:45:47 +02001.. SPDX-License-Identifier: GPL-2.0+
Mario Six8fac2912018-07-10 08:40:17 +02002
Bin Meng407189a2019-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 Six8fac2912018-07-10 08:40:17 +020017
Bin Mengbcb78a02019-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 Schuchardt5d398792020-12-12 08:50:37 +010028 usage/index
Bin Mengbcb78a02019-10-27 05:19:45 -070029
Heinrich Schuchardt71820612020-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 Mengbe3beaa2019-07-18 00:33:48 -070041
Bin Meng450704e2019-07-18 00:33:46 -070042U-Boot API documentation
43------------------------
44
45These 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
Heinrich Schuchardt653a5472018-07-29 13:45:47 +020051.. toctree::
Bin Meng450704e2019-07-18 00:33:46 -070052 :maxdepth: 2
Mario Six8fac2912018-07-10 08:40:17 +020053
Bin Meng450704e2019-07-18 00:33:46 -070054 api/index
Bin Meng407189a2019-07-18 00:33:47 -070055
Bin Meng1ba396e2019-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
Marek Vasute4a0f542021-03-25 01:20:48 +010067Machine-specific doc
68--------------------
69
70These books provide programming details about machine-specific
71implementation.
72
73.. toctree::
74 :maxdepth: 2
75
76 imx/index
77
Bin Mengc2c82cb2019-07-18 00:34:04 -070078Board-specific doc
79------------------
80
81These books provide details about board-specific information. They are
82organized in a vendor subdirectory.
83
84.. toctree::
85 :maxdepth: 2
86
87 board/index
88
Sam Protsenkocd43fa12020-01-24 17:53:44 +020089Android-specific doc
90--------------------
91
92These books provide information about booting the Android OS from U-Boot,
93manipulating Android images from U-Boot shell and discusses other
94Android-specific features available in U-Boot.
95
96.. toctree::
97 :maxdepth: 2
98
99 android/index
100
Simon Glass8dfb1352021-03-15 18:11:20 +1300101Chromium OS-specific doc
102------------------------
103
104.. toctree::
105 :maxdepth: 2
106
107 chromium/index
108
Bin Meng407189a2019-07-18 00:33:47 -0700109Indices and tables
110==================
111
112* :ref:`genindex`