Re: [PATCH] devicetree: Grammatical fixes to Doc/devicetree/ files.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux