OSDN Git Service

gpio: OF: Cut painful BNF experiments from bindings
authorLinus Walleij <linus.walleij@linaro.org>
Thu, 13 Sep 2018 07:28:13 +0000 (09:28 +0200)
committerLinus Walleij <linus.walleij@linaro.org>
Thu, 20 Sep 2018 15:35:47 +0000 (08:35 -0700)
commit25db30c335d997b0838001c29f7341891b403006
treec992f409a5313756a6536079f6e1ba1457a39d68
parent79b73ff9b2a3ef312d8fa30894fd963c80ded466
gpio: OF: Cut painful BNF experiments from bindings

In 2011 the commit bf859f84a19f
("gpio/dt: Refine GPIO device tree binding") introduced an
experimental BNF notation for defining a regular grammar for
the GPIO phandles used by different devices.

This was an interesting approach, and shows that we have long
nutured the idea to formally verify device tree files using
regular grammar.

Most if not all other bindings use natural language to define
the bindings, and the recent thinking for verifying device
tree files is to use JSON schemas in separate definitions.

Cut the BNF business and replace it with natural language
so that it becomes more human-readable for now.

Cc: devicetree@vger.kernel.org
Cc: Grant Likely <grant.likely@secretlab.ca>
Cc: Kumar Gala <galak@kernel.crashing.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
Documentation/devicetree/bindings/gpio/gpio.txt