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: 842950 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-gpio-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=linaro.org header.i=@linaro.org header.b="VACDisUN"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3ynY184G4Yz9t2V for ; Thu, 30 Nov 2017 21:05:00 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751850AbdK3KE7 (ORCPT ); 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-Google-Smtp-Source: AGs4zMbtntHrgSn1RSDedvdzVIwb1n57xwQxw/voy5z8xemlbsXI1BQikNKbgk/xuB49f/sGQNkqqg== 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(+) 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