On 15/09/2020 21:45, Heinrich Schuchardt wrote:
On 9/15/20 7:04 PM, Grant Likely wrote:
The language was ambiguous. Rephrase and reformat to be more readable.
Co-authored-by: Heinrich Schuchardt <xypron.glpk@xxxxxx>
Signed-off-by: Grant Likely <grant.likely@xxxxxxx>
Cc: Heinrich Schuchardt <xypron.glpk@xxxxxx>
---
source/chapter6-source-language.rst | 20 ++++++++++++++------
1 file changed, 14 insertions(+), 6 deletions(-)
diff --git a/source/chapter6-source-language.rst b/source/chapter6-source-language.rst
index ed4e234..295fcd6 100755
--- a/source/chapter6-source-language.rst
+++ b/source/chapter6-source-language.rst
@@ -233,15 +233,23 @@ File layout
[child nodes]
};
-The /dts-v1/; shall be present to identify the file as a version 1 DTS
+``/dts-v1/;`` shall be present to identify the file as a version 1 DTS
(dts files without this tag will be treated by dtc as being in the
obsolete version 0, which uses a different format for integers in
addition to other small but incompatible changes).
-Memory reservations define an entry for the devicetree blob’s memory
-reservation table. They have the form: e.g., /memreserve/ <address>
-<length>; Where <address> and <length> are 64-bit C-style integers.
+Memory reservations (see section :ref:`sect-fdt-memory-reservation-block`)
+are represented by lines in the form::
-* The / { }; section defines the root node of the devicetree.
+ /memreserve/ <address> <length>;
-* C style (/* ... \*/) and C++ style (//) comments are supported.
+Where ``<address>`` and ``<length>`` are 64-bit C-style integers, e.g.,
+
+.. code-block:: dts
+
+ /memreserve/ 0x10000000 0x0004000;
+ /memreserve/ 0x10000000 0x00004000;
The 28bit number looks strange here. Let's add another zero so that the
number formats match (or remove the leading zeros).
Fixed, thanks.
g.
Best regards
Heinrich
+
+The ``/ { ... };`` section defines the root node of the devicetree, and
+all the device tree data is contained within it.
+
+C style (``/* ... \*/``) and C++ style (``//``) comments are supported.