From patchwork Thu Nov 30 10:04:53 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 120090 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp464141qgn; Thu, 30 Nov 2017 02:05:00 -0800 (PST) X-Google-Smtp-Source: AGs4zMZFtkVmlt6C2sC66e80Mzu6r2LBBauahzjZklpllg4R5X5OYSg7x1W/HwwaFr1/op7eHFLb X-Received: by 10.159.206.131 with SMTP id bg3mr2102250plb.124.1512036300133; Thu, 30 Nov 2017 02:05:00 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1512036300; cv=none; d=google.com; s=arc-20160816; b=YKDBhTSPkFUnWmc4+X+a6jKNnYm2D0HcE767T9fAVAECPoopf6L1QrEt3xbmj7wD+V KEknKPTxKZowbLNHbo4tT63/KQCE2yHeRLmm8wHzlQPHs3kNkqqB4t36HvxfO01j0i4O g+NnPQt9nTQfBM4qF6NcpOw5dBCq836uCfqdYUa0JEOOip60SVZhPu/7cUim8jwL7yl4 2RHFWApBA0pnXJRGqj0Y1l1YkkPjnZmhxaVNcXeox+G8njSeHwkd5WsEPw67P1joRHpd joNYx/INKiQCyVH7wVagbAHeRcG3OOxHE/CIMO2mvh2FEnnV33ygTsdJQa4xnPc973Sm DGIQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :dkim-signature:arc-authentication-results; bh=ovrlgo+9XRXsEDUvyy9XFe+u+1AMsWolSmpiZjk7Hks=; b=p/OIYf6CrzyE8MJO4HkOvjVeeRk/TYsQ8Vm0tySOU73PycEiUrs9hxqPHnqaSpdRWP uwr/oQtLxkYOdnva6i3V4KKEAYrePSa/kPagup29yJb97QusL6wtRO8+gCxA/S9iDNFA ilXioE1+cHI/HEC0eYZYdBsIVZEvzOCDGrv5FuKuK8pktzcxZDf2A6CVzVV70xNkXn99 iYSYAFveJuzb05ZYw+OwUCZ0CR2elnqTh/FhLBrh6SPm3qlWb7QewAgXw2vWCFh7bWnq V+3NPZA+gd9pRg8TaMjz7WWhDoHNQ5ntalswZZ3UKMQdVW801n1liQaSsAv2AAWFnzlb aZpQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=VACDisUN; spf=pass (google.com: best guess record for domain of linux-gpio-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-gpio-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id x184si2951133pfd.165.2017.11.30.02.04.59; Thu, 30 Nov 2017 02:05:00 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-gpio-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=VACDisUN; spf=pass (google.com: best guess record for domain of linux-gpio-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-gpio-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751850AbdK3KE7 (ORCPT + 6 others); Thu, 30 Nov 2017 05:04:59 -0500 Received: from mail-lf0-f67.google.com ([209.85.215.67]:43529 "EHLO mail-lf0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750984AbdK3KE6 (ORCPT ); Thu, 30 Nov 2017 05:04:58 -0500 Received: by mail-lf0-f67.google.com with SMTP id 94so7219349lfy.10 for ; Thu, 30 Nov 2017 02:04:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=rDX/VsBmyAj5ElvIbRuQxyNlZ/SYPRg9zz6FptfPa6I=; b=VACDisUN8I3iQIpRSY3PYaEI/B2cd1XMn5UPNP3igYkEoVqqRj9SWP0cv5Q52HV+ue 1QFmQO1t/AeDIh9bq/dYqYaTX3dhON5B8tfkOFGldzmP7V/hmxehvUkvuxZqHnCefQ4c J1jtLqTx7TaFiO1sbXU+7kdDBRnZnx3+69Sf4= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=rDX/VsBmyAj5ElvIbRuQxyNlZ/SYPRg9zz6FptfPa6I=; b=oFJGmymKpOcZc1JPhcwGmQ3ntxyHcK4zQxgmz8QHlFQ9+LHZGD68tjoZ92QA7+RO2j l13gSIQmvXi2AV+MeaQ/Ej5Exu24n/b3A7uFVq9EI4Xo5nuGTp4pjMEc0dPKUquexaFy JjG1kUWeJaVFFsgPb4u131/WZYkHBzsfKZfmJ3gLrSI4TXSODqLRSUvzi9qpHeH06y7n CLDdJmJOAov77kOxJgTkuVNF15SpvYKyF81oXjyL8OibQzlBHJcGGRSjBmQflcUQizzd ao7g7z5Jt+9pd02QTiGCDd/eD2jtPF4xZ1jsWxVblf04B84JNPEp6+of2Su80+rT8wHm Ezvw== X-Gm-Message-State: AJaThX6eMeYJtFbFQTlrvjWhdT5zwl8JTlcL6OUFfDr2SQa5cuLsKa5A 7O+3/A9nUgkA5bXXfMn5W+T8MZ8ldos= X-Received: by 10.25.81.194 with SMTP id g63mr2644218lfl.58.1512036296896; Thu, 30 Nov 2017 02:04:56 -0800 (PST) Received: from genomnajs.ideon.se ([85.235.10.227]) by smtp.gmail.com with ESMTPSA id 17sm765033ljo.3.2017.11.30.02.04.55 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 30 Nov 2017 02:04:56 -0800 (PST) From: Linus Walleij To: linux-gpio@vger.kernel.org Cc: Linus Walleij Subject: [PATCH] gpio: Clarify that is legacy Date: Thu, 30 Nov 2017 11:04:53 +0100 Message-Id: <20171130100453.29561-1-linus.walleij@linaro.org> X-Mailer: git-send-email 2.14.3 Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org It should be clear to developers that they should not include this file in new code. Suggested-by: Arnd Bergmann Signed-off-by: Linus Walleij --- While I should certainly try to fix checkpatch.pl to warn about this, it doesn't hurt to spell it out in the file as well. --- include/linux/gpio.h | 10 ++++++++++ 1 file changed, 10 insertions(+) -- 2.14.3 -- To unsubscribe from this list: send the line "unsubscribe linux-gpio" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/include/linux/gpio.h b/include/linux/gpio.h index 8ef7fc0ce0f0..91ed23468530 100644 --- a/include/linux/gpio.h +++ b/include/linux/gpio.h @@ -1,4 +1,14 @@ /* SPDX-License-Identifier: GPL-2.0 */ +/* + * + * + * This is the LEGACY GPIO bulk include file, including legacy APIs. It is + * used for GPIO drivers still referencing the global GPIO numberspace, + * and should not be included in new code. + * + * If you're implementing a GPIO driver, only include + * If you're implementing a GPIO consumer, only include + */ #ifndef __LINUX_GPIO_H #define __LINUX_GPIO_H