devicetree: bindings: improve description for GPIO assisted NAND flash

[Linux-MTD Mailing List]

Gitweb:     http://git.infradead.org/?p=mtd-2.6.git;a=commit;h=f861a9253e7f456d870f8dd46bdde2ac02149bc6
Commit:     f861a9253e7f456d870f8dd46bdde2ac02149bc6
Parent:     1f04a73e2c6368bac8f9e0ac3ada58e6b41163f0
Author:     Gerhard Sittig <gsi at denx.de>
AuthorDate: Tue Aug 5 10:37:25 2014 +0200
Committer:  Brian Norris <computersforpeace at gmail.com>
CommitDate: Tue Nov 4 23:53:06 2014 -0800

    devicetree: bindings: improve description for GPIO assisted NAND flash
    
    Expand the description of the 'gpios' property in the GPIO assisted
    NAND flash binding, to explicitly list the required GPIO pin references
    and their order.
    
    Update the example section to individually bracket the GPIO references,
    and capitalize the signal names for improved readability.
    
    Signed-off-by: Gerhard Sittig <gsi at denx.de>
    Signed-off-by: Brian Norris <computersforpeace at gmail.com>
---
 .../devicetree/bindings/mtd/gpio-control-nand.txt          | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/Documentation/devicetree/bindings/mtd/gpio-control-nand.txt b/Documentation/devicetree/bindings/mtd/gpio-control-nand.txt
index 36ef07d..af8915b 100644
--- a/Documentation/devicetree/bindings/mtd/gpio-control-nand.txt
+++ b/Documentation/devicetree/bindings/mtd/gpio-control-nand.txt
@@ -11,8 +11,8 @@ Required properties:
   are made in native endianness.
 - #address-cells, #size-cells : Must be present if the device has sub-nodes
   representing partitions.
-- gpios : specifies the gpio pins to control the NAND device.  nwp is an
-  optional gpio and may be set to 0 if not present.
+- gpios : Specifies the GPIO pins to control the NAND device.  The order of
+  GPIO references is:  RDY, nCE, ALE, CLE, and an optional nWP.
 
 Optional properties:
 - bank-width : Width (in bytes) of the device.  If not present, the width
@@ -35,11 +35,11 @@ gpio-nand at 1,0 {
 	reg = <1 0x0000 0x2>;
 	#address-cells = <1>;
 	#size-cells = <1>;
-	gpios = <&banka 1 0	/* rdy */
-		 &banka 2 0 	/* nce */
-		 &banka 3 0 	/* ale */
-		 &banka 4 0 	/* cle */
-		 0		/* nwp */>;
+	gpios = <&banka 1 0>,	/* RDY */
+		<&banka 2 0>, 	/* nCE */
+		<&banka 3 0>, 	/* ALE */
+		<&banka 4 0>, 	/* CLE */
+		<0>;		/* nWP */
 
 	partition at 0 {
 	...