path: root/Documentation/sh
diff options
authorRob Herring <>2020-10-08 09:24:20 -0500
committerRob Herring <>2020-10-13 13:33:16 -0500
commit441848282c59038b6e9a57b233ac6a9449430648 (patch)
tree4b1a46b81446fd61f55779497a875adfbd694e66 /Documentation/sh
parent588614be61b7cb46f697c3e141b2aef7f6b49347 (diff)
dt: Remove booting-without-of.rst
booting-without-of.rst is an ancient document that first outlined Flattened DeviceTree on PowerPC initially. The DT world has evolved a lot in the 15 years since and booting-without-of.rst is pretty stale. The name of the document itself is confusing if you don't understand the evolution from real 'OpenFirmware'. Most of what booting-without-of.rst contains is now in the DT specification (which evolved out of the ePAPR). The few things that weren't documented in the DT specification are now. All that remains is the boot entry details, so let's move these to arch specific documents. The exception is arm which already has the same details documented. Cc: Frank Rowand <> Cc: Mauro Carvalho Chehab <> Cc: Geert Uytterhoeven <> Cc: Michael Ellerman <> Cc: Thomas Bogendoerfer <> Cc: Jonathan Corbet <> Cc: Paul Mackerras <> Cc: Yoshinori Sato <> Cc: Rich Felker <> Cc: Thomas Gleixner <> Cc: Ingo Molnar <> Cc: Borislav Petkov <> Cc: "H. Peter Anvin" <> Cc: Cc: Cc: Cc: Cc: Acked-by: Benjamin Herrenschmidt <> Acked-by: Borislav Petkov <> Acked-by: Michael Ellerman <> (powerpc) Signed-off-by: Rob Herring <>
Diffstat (limited to 'Documentation/sh')
2 files changed, 13 insertions, 0 deletions
diff --git a/Documentation/sh/booting.rst b/Documentation/sh/booting.rst
new file mode 100644
index 000000000000..d851c49a01bf
--- /dev/null
+++ b/Documentation/sh/booting.rst
@@ -0,0 +1,12 @@
+.. SPDX-License-Identifier: GPL-2.0
+DeviceTree Booting
+ Device-tree compatible SH bootloaders are expected to provide the physical
+ address of the device tree blob in r4. Since legacy bootloaders did not
+ guarantee any particular initial register state, kernels built to
+ inter-operate with old bootloaders must either use a builtin DTB or
+ select a legacy board option (something other than CONFIG_SH_DEVICE_TREE)
+ that does not use device tree. Support for the latter is being phased out
+ in favor of device tree.
diff --git a/Documentation/sh/index.rst b/Documentation/sh/index.rst
index b5933fd399f3..7b9a79a28167 100644
--- a/Documentation/sh/index.rst
+++ b/Documentation/sh/index.rst
@@ -7,6 +7,7 @@ SuperH Interfaces Guide
.. toctree::
:maxdepth: 1
+ booting