dts: fix up type comments in binding-template.yaml

List the details for each type in the order they appear in the summary
of all types. Add the missing 'path' value to the summary.

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
This commit is contained in:
Martí Bolívar 2020-02-08 15:47:19 -08:00 committed by Kumar Gala
commit 026f7fc97e

View file

@ -89,7 +89,7 @@ on-bus: <string describing bus type, e.g. "i2c">
# <property name>: # <property name>:
# required: <true | false> # required: <true | false>
# type: <string | int | boolean | array | uint8-array | string-array | # type: <string | int | boolean | array | uint8-array | string-array |
# phandle | phandles | phandle-array | compound> # phandle | phandles | phandle-array | path | compound>
# description: <description of the property> # description: <description of the property>
# enum: # enum:
# - <item1> # - <item1>
@ -101,33 +101,14 @@ on-bus: <string describing bus type, e.g. "i2c">
# #
# These types are available: # These types are available:
# #
# - 'type: int' is for properties that are assigned a single 32-bit value,
# like
#
# frequency = <100>;
#
# - 'type: array' is for properties that are assigned zero or more 32-bit
# values, like
#
# pin-config = <1 2 3>;
#
# - 'type: uint8-array' is for properties that are assigned zero or more
# bytes with the [] syntax, like
#
# lookup-table = [89 AB CD EF];
#
# Each byte is given in hex.
#
# This type is called 'bytestring' in the Devicetree specification.
#
# - 'type: string' is for properties that are assigned a single string, like # - 'type: string' is for properties that are assigned a single string, like
# #
# ident = "foo"; # ident = "foo";
# #
# - 'type: string-array' if for properties that are assigned zero or more # - 'type: int' is for properties that are assigned a single 32-bit value,
# strings, like # like
# #
# idents = "foo", "bar", "baz"; # frequency = <100>;
# #
# - 'type: boolean' is for properties used as flags that don't take a value, # - 'type: boolean' is for properties used as flags that don't take a value,
# like # like
@ -144,6 +125,25 @@ on-bus: <string describing bus type, e.g. "i2c">
# #
# #if DT_SOME_BOOLEAN_PROP == 1 # #if DT_SOME_BOOLEAN_PROP == 1
# #
# - 'type: array' is for properties that are assigned zero or more 32-bit
# values, like
#
# pin-config = <1 2 3>;
#
# - 'type: uint8-array' is for properties that are assigned zero or more
# bytes with the [] syntax, like
#
# lookup-table = [89 AB CD EF];
#
# Each byte is given in hex.
#
# This type is called 'bytestring' in the Devicetree specification.
#
# - 'type: string-array' if for properties that are assigned zero or more
# strings, like
#
# idents = "foo", "bar", "baz";
#
# - 'type: phandle' is for properties that are assigned a single phandle, # - 'type: phandle' is for properties that are assigned a single phandle,
# like # like
# #