Re: [PATCH 2/3] Documentation: devicetree: add binding doc for Broadcom NAND controller

From: Scott Branden
Date: Mon Mar 16 2015 - 19:52:22 EST


Hi Brian,


On 15-03-16 04:46 PM, Brian Norris wrote:
On Mon, Mar 16, 2015 at 04:40:13PM -0700, Scott Branden wrote:

On 15-03-16 04:37 PM, Brian Norris wrote:
On Mon, Mar 16, 2015 at 04:07:51PM -0700, Scott Branden wrote:
So, what's the standard? Company prefix? Long name? Commas? Hyphens?

The problem with devicetree binding is there is no standard for much
of anything. Some others use the vendor prefix for all their
binding documentation. We can try to do the same?

Ok, but we already have 3 versions for Broadcom. I can use 'brcm,' if
that helps...

Yes, it helps if we try standardizing on the brcm vendor prefix in
Documentation/devicetree/bindings/vendor-prefixes.txt. If you sift
through the bindings directory you will find some of the other vendors
have done the same.

Also, of note.
In Documentation/devicetree/bindings/submitting-patches.txt
it states the Documentation should be the first patch in the series.
Perhaps this helps the devicetree maintainer in reviewing bindings?

Scott


Brian


--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/