linux-i2c.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Wolfram Sang <wsa@the-dreams.de>
To: devicetree@vger.kernel.org
Cc: linux-i2c@vger.kernel.org, robh+dt@kernel.org,
	Wolfram Sang <wsa@the-dreams.de>
Subject: [PATCH 1/2] dt-bindings: deprecate trivial-devices.txt for i2c
Date: Thu, 26 Jan 2017 23:55:43 +0100	[thread overview]
Message-ID: <20170126225544.5431-2-wsa@the-dreams.de> (raw)
In-Reply-To: <20170126225544.5431-1-wsa@the-dreams.de>

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(-)

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
 ==========		=============
-- 
2.10.2

  reply	other threads:[~2017-01-26 22:56 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-01-26 22:55 [PATCH 0/2] dt-bindings: deprecate and move i2c/trivial-devices.txt Wolfram Sang
2017-01-26 22:55 ` Wolfram Sang [this message]
2017-02-01 13:48   ` [PATCH 1/2] dt-bindings: deprecate trivial-devices.txt for i2c Rob Herring
     [not found] ` <20170126225544.5431-1-wsa-z923LK4zBo2bacvFa/9K2g@public.gmane.org>
2017-01-26 22:55   ` [PATCH 2/2] dt-bindings: move trivial devices out of i2c subdir Wolfram Sang
2017-02-01 13:50     ` Rob Herring
2017-02-01 18:35       ` Wolfram Sang
2017-02-07 11:08         ` Wolfram Sang
2017-02-07 15:46           ` Rob Herring

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20170126225544.5431-2-wsa@the-dreams.de \
    --to=wsa@the-dreams.de \
    --cc=devicetree@vger.kernel.org \
    --cc=linux-i2c@vger.kernel.org \
    --cc=robh+dt@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).