doc: arch: Convert README.mips to reST
authorBin Meng <bmeng.cn@gmail.com>
Thu, 18 Jul 2019 07:34:03 +0000 (00:34 -0700)
committerTom Rini <trini@konsulko.com>
Wed, 24 Jul 2019 14:07:24 +0000 (10:07 -0400)
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.

Signed-off-by: Bin Meng <bmeng.cn@gmail.com>
Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
doc/README.mips [deleted file]
doc/arch/index.rst
doc/arch/mips.rst [new file with mode: 0644]

diff --git a/doc/README.mips b/doc/README.mips
deleted file mode 100644 (file)
index b28f628..0000000
+++ /dev/null
@@ -1,54 +0,0 @@
-
-Notes for the MIPS architecture port of U-Boot
-
-Toolchains
-----------
-
-  http://www.denx.de/wiki/DULG/ELDK
-  ELDK < DULG < DENX
-
-  http://www.emdebian.org/crosstools.html
-  Embedded Debian -- Cross-development toolchains
-
-  http://buildroot.uclibc.org/
-  Buildroot
-
-Known Issues
-------------
-
-  * Cache incoherency issue caused by do_bootelf_exec() at cmd_elf.c
-
-    Cache will be disabled before entering the loaded ELF image without
-    writing back and invalidating cache lines. This leads to cache
-    incoherency in most cases, unless the code gets loaded after U-Boot
-    re-initializes the cache. The more common uImage 'bootm' command does
-    not suffer this problem.
-
-    [workaround] To avoid this cache incoherency,
-    1) insert flush_cache(all) before calling dcache_disable(), or
-    2) fix dcache_disable() to do both flushing and disabling cache.
-
-  * Note that Linux users need to kill dcache_disable() in do_bootelf_exec()
-    or override do_bootelf_exec() not to disable I-/D-caches, because most
-    Linux/MIPS ports don't re-enable caches after entering kernel_entry.
-
-TODOs
------
-
-  * Probe CPU types, I-/D-cache and TLB size etc. automatically
-
-  * Secondary cache support missing
-
-  * Initialize TLB entries redardless of their use
-
-  * R2000/R3000 class parts are not supported
-
-  * Limited testing across different MIPS variants
-
-  * Due to cache initialization issues, the DRAM on board must be
-    initialized in board specific assembler language before the cache init
-    code is run -- that is, initialize the DRAM in lowlevel_init().
-
-  * centralize/share more CPU code of MIPS32, MIPS64 and XBurst
-
-  * support Qemu Malta
index a03ee6b752dc81b65d7b06ca8ae6bfb2c75e31fa..1aeb7a132708a562088e9a5fb881c4354ba4beef 100644 (file)
@@ -5,3 +5,5 @@ Architecture-specific doc
 
 .. toctree::
    :maxdepth: 2
+
+   mips
diff --git a/doc/arch/mips.rst b/doc/arch/mips.rst
new file mode 100644 (file)
index 0000000..b816608
--- /dev/null
@@ -0,0 +1,46 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+MIPS
+====
+
+Notes for the MIPS architecture port of U-Boot
+
+Toolchains
+----------
+
+  * `ELDK < DULG < DENX <http://www.denx.de/wiki/DULG/ELDK>`_
+  * `Embedded Debian -- Cross-development toolchains <http://www.emdebian.org/crosstools.html>`_
+  * `Buildroot <http://buildroot.uclibc.org/>`_
+
+Known Issues
+------------
+
+  * Cache incoherency issue caused by do_bootelf_exec() at cmd_elf.c
+
+    Cache will be disabled before entering the loaded ELF image without
+    writing back and invalidating cache lines. This leads to cache
+    incoherency in most cases, unless the code gets loaded after U-Boot
+    re-initializes the cache. The more common uImage 'bootm' command does
+    not suffer this problem.
+
+    [workaround] To avoid this cache incoherency:
+       - insert flush_cache(all) before calling dcache_disable(), or
+       - fix dcache_disable() to do both flushing and disabling cache.
+
+  * Note that Linux users need to kill dcache_disable() in do_bootelf_exec()
+    or override do_bootelf_exec() not to disable I-/D-caches, because most
+    Linux/MIPS ports don't re-enable caches after entering kernel_entry.
+
+TODOs
+-----
+
+  * Probe CPU types, I-/D-cache and TLB size etc. automatically
+  * Secondary cache support missing
+  * Initialize TLB entries redardless of their use
+  * R2000/R3000 class parts are not supported
+  * Limited testing across different MIPS variants
+  * Due to cache initialization issues, the DRAM on board must be
+    initialized in board specific assembler language before the cache init
+    code is run -- that is, initialize the DRAM in lowlevel_init().
+  * centralize/share more CPU code of MIPS32, MIPS64 and XBurst
+  * support Qemu Malta