Commit:     eff2ebd207af9f501af0ef667a7d14befcb36c1b
Parent:     ea1a734ad73478dace97e9712101029f536d10a3
Author:     David Gibson <[EMAIL PROTECTED]>
AuthorDate: Thu Jun 28 15:56:26 2007 +1000
Committer:  Paul Mackerras <[EMAIL PROTECTED]>
CommitDate: Thu Jun 28 19:19:31 2007 +1000

    [POWERPC] In booting-without-of.txt, clarify that properties must precede 
    A strict reading of the flattened device tree format defined in
    booting-without-of.txt does in fact require that all the tags defining
    properties for a node go before any definitions of subnodes, however
    it's not particularly emphasised.  Although allowing intermingled
    properties and subnodes would not be ambiguous in meaning, the kernel
    parser does currently require that properties precede subnodes.
    Furthermore, keeping this constraint makes life easier for various
    device tree scanning tools.
    Therefore, re-emphasise in booting-without-of.txt that this is a
    strict requirement of the flattened device tree format.
    Signed-off-by: David Gibson <[EMAIL PROTECTED]>
    Signed-off-by: Paul Mackerras <[EMAIL PROTECTED]>
 Documentation/powerpc/booting-without-of.txt |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)

diff --git a/Documentation/powerpc/booting-without-of.txt 
index d42d981..c169299 100644
--- a/Documentation/powerpc/booting-without-of.txt
+++ b/Documentation/powerpc/booting-without-of.txt
@@ -626,6 +626,14 @@ So the node content can be summarized as a start token, a 
full path,
 a list of properties, a list of child nodes, and an end token. Every
 child node is a full node structure itself as defined above.
+NOTE: The above definition requires that all property definitions for
+a particular node MUST precede any subnode definitions for that node.
+Although the structure would not be ambiguous if properties and
+subnodes were intermingled, the kernel parser requires that the
+properties come first (up until at least 2.6.22).  Any tools
+manipulating a flattened tree must take care to preserve this
 4) Device tree "strings" block
 In order to save space, property names, which are generally redundant,
To unsubscribe from this list: send the line "unsubscribe git-commits-head" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at

Reply via email to