On 05/09/15 04:56, Robert P. J. Day wrote: > > A number of fairly straightforward grammatical fixes and minor > updates to the devicetree docs. > > Signed-off-by: Robert P. J. Day <rpjday@xxxxxxxxxxxxxx> > > --- > Please add a diffstat listing here. > there's certainly a lot more that can be tidied up in that > directory, but i'll start with the easy stuff if that's all right. > > diff --git a/Documentation/devicetree/00-INDEX b/Documentation/devicetree/00-INDEX > index 8c4102c..141c43a31 100644 > --- a/Documentation/devicetree/00-INDEX > +++ b/Documentation/devicetree/00-INDEX > @@ -7,6 +7,14 @@ https://lists.ozlabs.org/listinfo/devicetree-discuss > 00-INDEX > - this file > booting-without-of.txt > - - Booting Linux without Open Firmware, describes history and format of device trees. > + - Booting Linux without Open Firmware, describes history and format of device trees > +changesets.txt > + - How to apply DT changesets to the live tree atomically > +dynamic-resolution-notes.txt > + - The implementation of the in-kernel DT dynamic resolver > +of_unittest.txt > + - How test data is attached to the live tree dynamically maybe s/is/are/, but no big deal. > +overlay-notes.txt > + - Implementation of the in-kernel DT overlay functionality > usage-model.txt > - - How Linux uses DT and what DT aims to solve. > \ No newline at end of file > + - How Linux uses DT and what DT aims to solve > diff --git a/Documentation/devicetree/overlay-notes.txt b/Documentation/devicetree/overlay-notes.txt > index d418a6c..0eb830d 100644 > --- a/Documentation/devicetree/overlay-notes.txt > +++ b/Documentation/devicetree/overlay-notes.txt > @@ -1,23 +1,21 @@ > Device Tree Overlay Notes > ------------------------- > > -This document describes the implementation of the in-kernel > -device tree overlay functionality residing in drivers/of/overlay.c and is a > -companion document to Documentation/devicetree/dt-object-internal.txt[1] & > -Documentation/devicetree/dynamic-resolution-notes.txt[2] > +This document describes the implementation of the in-kernel device tree > +overlay functionality residing in drivers/of/overlay.c and is a companion > +document to Documentation/devicetree/dynamic-resolution-notes.txt[1]. > > How overlays work > ----------------- > > -A Device Tree's overlay purpose is to modify the kernel's live tree, and > -have the modification affecting the state of the kernel in a way that > -is reflecting the changes. > -Since the kernel mainly deals with devices, any new device node that result > +A Device Tree's overlay purpose is to modify the kernel's live tree, > +so that the new state of the kernel reflects those changes. > + > +Since the kernel mainly deals with devices, any new device node that results > in an active device should have it created while if the device node is either > disabled or removed all together, the affected device should be deregistered. > > -Lets take an example where we have a foo board with the following base tree > -which is taken from [1]. > +Lets take an example where we have a foo board with the following base tree: Let's > > ---- foo.dts ----------------------------------------------------------------- > /* FOO platform */ -- ~Randy -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html