diff mbox

[1/2] dt-bindings: deprecate trivial-devices.txt for i2c

Message ID 20170126225544.5431-2-wsa@the-dreams.de
State Changes Requested
Headers show

Commit Message

Wolfram Sang Jan. 26, 2017, 10:55 p.m. UTC
The idea to collect trivial devices in a seperate file is coming from
the early DT days and turned out to be a bad decision. It regularly
creates maintenance pain and the information is not where users would
expect it (i2c folder is for i2c bus drivers not clients). Also, we do
not maintain such a file for other subsystems, so we should put an end
to this as well. First step is to deprecate it and mention that it
should be refactored into proper bindings.

Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
---
 Documentation/devicetree/bindings/i2c/trivial-devices.txt | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

Comments

Rob Herring Feb. 1, 2017, 1:48 p.m. UTC | #1
On Thu, Jan 26, 2017 at 11:55:43PM +0100, Wolfram Sang wrote:
> The idea to collect trivial devices in a seperate file is coming from
> the early DT days and turned out to be a bad decision. It regularly
> creates maintenance pain and the information is not where users would
> expect it (i2c folder is for i2c bus drivers not clients). Also, we do
> not maintain such a file for other subsystems, so we should put an end
> to this as well. First step is to deprecate it and mention that it
> should be refactored into proper bindings.
> 
> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
> ---
>  Documentation/devicetree/bindings/i2c/trivial-devices.txt | 10 +++++++---
>  1 file changed, 7 insertions(+), 3 deletions(-)

Actually, I prefer to keep it. Move it up a level and I will take 
patches for it.

Rob
--
To unsubscribe from this list: send the line "unsubscribe linux-i2c" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/i2c/trivial-devices.txt b/Documentation/devicetree/bindings/i2c/trivial-devices.txt
index cdd7b48826c38f..39570a1ca5919f 100644
--- a/Documentation/devicetree/bindings/i2c/trivial-devices.txt
+++ b/Documentation/devicetree/bindings/i2c/trivial-devices.txt
@@ -1,11 +1,15 @@ 
+*** This file is DEPRECATED! ***
+
 This is a list of trivial i2c devices that have simple device tree
 bindings, consisting only of a compatible field, an address and
 possibly an interrupt line.
 
-If a device needs more specific bindings, such as properties to
-describe some aspect of it, there needs to be a specific binding
-document for it just like any other devices.
+The entries here need to be refactored to proper binding descriptions in
+their relevant subdirectories.
+
+New items will not be added to this file.
 
+*** This file is DEPRECATED! ***
 
 Compatible		Vendor / Chip
 ==========		=============