doc: Move existing rst files into api sub-directory
authorBin Meng <bmeng.cn@gmail.com>
Thu, 18 Jul 2019 07:33:46 +0000 (00:33 -0700)
committerTom Rini <trini@konsulko.com>
Wed, 24 Jul 2019 14:07:24 +0000 (10:07 -0400)
Currently the Sphinx doc only contains API descriptions of several
U-Boot subsystems. For future extension, group these existing docs
into an API sub-directory.

Signed-off-by: Bin Meng <bmeng.cn@gmail.com>
Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
doc/api/efi.rst [moved from doc/efi.rst with 100% similarity]
doc/api/index.rst [new file with mode: 0644]
doc/api/linker_lists.rst [moved from doc/linker_lists.rst with 100% similarity]
doc/api/serial.rst [moved from doc/serial.rst with 100% similarity]
doc/index.rst

similarity index 100%
rename from doc/efi.rst
rename to doc/api/efi.rst
diff --git a/doc/api/index.rst b/doc/api/index.rst
new file mode 100644 (file)
index 0000000..d484c06
--- /dev/null
@@ -0,0 +1,11 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+U-Boot API documentation
+========================
+
+.. toctree::
+   :maxdepth: 2
+
+   efi
+   linker_lists
+   serial
similarity index 100%
rename from doc/serial.rst
rename to doc/api/serial.rst
index 0353c10..1946d09 100644 (file)
@@ -4,8 +4,16 @@
 U-Boot Developer Manual
 #######################
 
+U-Boot API documentation
+------------------------
+
+These books get into the details of how specific U-Boot subsystems work
+from the point of view of a U-Boot developer.  Much of the information here
+is taken directly from the U-Boot source, with supplemental material added
+as needed (or at least as we managed to add it - probably *not* all that is
+needed).
+
 .. toctree::
+   :maxdepth: 2
 
-   efi
-   linker_lists
-   serial
+   api/index