Received: by 10.223.185.116 with SMTP id b49csp202316wrg; Thu, 8 Mar 2018 15:44:38 -0800 (PST) X-Google-Smtp-Source: AG47ELtwSnjuI3t1wLXXy4yVAr8oBQknwxdZCjHOM0tsS7C8ndlgSv9vfHOt7uObwAfSa5d6nyLP X-Received: by 2002:a17:902:d20e:: with SMTP id t14-v6mr15243772ply.212.1520552678832; Thu, 08 Mar 2018 15:44:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1520552678; cv=none; d=google.com; s=arc-20160816; b=MZTz/1sY7fvsWLl880DEYJpApB4YRq613URK3YlmR3jEuL3NoCt1HT9kdWOE5+sLpd dbBkDB+eM9KIgLjApPPh1lhYRqtOLXSY5Gn1Y2FXC3xUEaUOONEKgICxZ9k92xgK0FnG pQZotc7rQNCSnTPq8u3uCNpMy6JDc3d2IMzcOwrsVAgQLNxnD1ZwFecF3oCbo9SIiMp4 mmvF3sQ6V3HwUkpCiBMc+TTKqbDiYLSjtLHV27eIJiiX8KNegWd7mxIsC9uK3CcjNQfV 3SQyfpvjYhRw9HCJhkOcPPe1ml+PkxGHljoxuFH7riF5AsJBz7NTbQwkB2yR96Vr46Jl aQBA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :arc-authentication-results; bh=H6TEEggeiqZnKcJM414MZJ6e/J6tXP1CfrV59TqtDfM=; b=b2fN2IdqoYXTPHp1rMePe2irrasAnVw63+BqIotwPMJZs1lSolit0zYXcq0+btVcnl pv8LY/+OzoPPgU8na5FB95BO6m3gqiHY638sJspy6K9gn3umUAlvkUnqZkp2nMvW0Ben WD/pfcQCv6Q7UBwMNSOmt/Px2WkN9Caa+YNKU52cCKaSoSQezZRI+GE6Aw0QWKIcLXYb jbxvGhkU2pdKC4sHmpIkt3XKTPr2PZMt6c9Jl6rCVSKt82hbl3HWQsebIYRlbmw5YYAv ODtIb9t28L6BAUng1Tk2Yo8JeQsKUG4LGQlatCT48VVrIco83wdk5TD7D+/x25GvZyHi e4Cg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id p7si16397865pff.80.2018.03.08.15.44.24; Thu, 08 Mar 2018 15:44:38 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751323AbeCHXlT (ORCPT + 99 others); Thu, 8 Mar 2018 18:41:19 -0500 Received: from mout.gmx.net ([212.227.15.19]:59351 "EHLO mout.gmx.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750857AbeCHXlR (ORCPT ); Thu, 8 Mar 2018 18:41:17 -0500 Received: from latitude ([88.153.6.235]) by mail.gmx.com (mrgmx001 [212.227.17.190]) with ESMTPSA (Nemesis) id 0LyEJp-1eYlBi35zp-015Xnp; Fri, 09 Mar 2018 00:41:11 +0100 From: =?UTF-8?q?Jonathan=20Neusch=C3=A4fer?= To: linux-gpio@vger.kernel.org Cc: linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, =?UTF-8?q?Jonathan=20Neusch=C3=A4fer?= , Linus Walleij , Jonathan Corbet Subject: [PATCH 3/8] Documentation: gpio: Move introduction to driver-api Date: Fri, 9 Mar 2018 00:40:19 +0100 Message-Id: <20180308234024.24145-4-j.neuschaefer@gmx.net> X-Mailer: git-send-email 2.16.1 In-Reply-To: <20180308234024.24145-1-j.neuschaefer@gmx.net> References: <20180308234024.24145-1-j.neuschaefer@gmx.net> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Provags-ID: V03:K0:TwEs7abHjTdQq9mYXNP744jhC/hLBDAHPYv1kxVTFArKYWY+i8x bauym80iLZfjoMQ1m37yzsqIdi4u8JCIigLla3SW+FHrAWkBPeKJHQfS7C140pnJSszoRZG PzT5lK7vl+MGQh/VoB5UxwiQy7tuSpBJYvHiCf92mPgPiZB69qsflbc7EIQejYh1zJzpYx8 //zOh4jkVbeCPHiI5X08Q== X-UI-Out-Filterresults: notjunk:1;V01:K0:vCb4CZ6r7j4=:wRpNFpHkMDmA1gvVF9JEZo IjB8Nt4cHgEE9Ty2Jn9zlS+4lMuhczVwt6vLECozS4gen2HBxZqRYMQZs4PLiQfDRor428VOt jrL/usHBeFf6yxb73MnePl/j9uNVHz5HCD7J7ahHrWnSod5zg1zslKpZvfcTB7jr3fL/nZUNS DRk1T1TTfn+yQwOvjgPcg7QmUWS51QreP/8LE/Jr14XCD2hzI3D/HXEcX4JyqIEFWlGSn+yQr P6uAgYznIM91h8KmIbvnIDYPunSRbZQ63pnG6qyVwNzwEkaudDdcjb0XuzbYo0EuIjB63Y+oq wfPQdFYB7N4TCAI2hGwQj0uu+S3L9HEFUq+QOrzxKIXVxEtQOfdJDMTKBQnXh+Ksq0Ad4bnbO EYKhSR5fuzwfqyB6W2iNaH3jC2yK/NDuguvUNVg9C1WAhEbFg2130Cw6LCdd9cO1LXsz0wiDR R4YTQqs6IzqqclRXCjbLr1+BGmpT34X3mFRdG3PURwno8vbnkDHti4Lk7YRjK2NfVXnOc/ltC dv6jEPY+qdQrriyaBoqlxI18v3vyavUUdqPGNv4+/FDDIBHAXhuUrYVWmE0o79XdDUqKOjwzl l48hOUUJ/eXuEkzRh83RX3Vx3fJ6QuH1GqbOW6KAXy4DrDyW0Ugk+pYp3+s++oDkNPj/hEPg3 i04Vbeux4e+SAv3FMU3kXc6iy3GWqpNCROQ0EpIrbYrkCLGOGjSYgaco4bsLw+8OEVfZ5ijId 02uEBDBytXtqyqMcHWTNwRssfUuhAJKgoLIKyy9Tz7pnSHnh6jwQUbPmGPkizq0wI/+RMhqMR q0BnMBiB2JikUt42kstYFKVO5v/hDOm19tHKC2KELhLTLwg4y8= Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Move gpio/intro.txt to driver-api/gpio/intro.rst and make sure it builds cleanly as ReST. Signed-off-by: Jonathan Neuschäfer --- Documentation/driver-api/gpio/index.rst | 7 +++++++ Documentation/{gpio/gpio.txt => driver-api/gpio/intro.rst} | 9 +++++++-- Documentation/gpio/00-INDEX | 2 -- 3 files changed, 14 insertions(+), 4 deletions(-) rename Documentation/{gpio/gpio.txt => driver-api/gpio/intro.rst} (96%) diff --git a/Documentation/driver-api/gpio/index.rst b/Documentation/driver-api/gpio/index.rst index 6dd4aa647f27..db47d845f473 100644 --- a/Documentation/driver-api/gpio/index.rst +++ b/Documentation/driver-api/gpio/index.rst @@ -2,6 +2,13 @@ General Purpose Input/Output (GPIO) =================================== +Contents: + +.. toctree:: + :maxdepth: 2 + + intro + Core ==== diff --git a/Documentation/gpio/gpio.txt b/Documentation/driver-api/gpio/intro.rst similarity index 96% rename from Documentation/gpio/gpio.txt rename to Documentation/driver-api/gpio/intro.rst index cd9b356e88cd..74591489d0b5 100644 --- a/Documentation/gpio/gpio.txt +++ b/Documentation/driver-api/gpio/intro.rst @@ -1,3 +1,8 @@ +============ +Introduction +============ + + GPIO Interfaces =============== @@ -9,9 +14,9 @@ Due to the history of GPIO interfaces in the kernel, there are two different ways to obtain and use GPIOs: - The descriptor-based interface is the preferred way to manipulate GPIOs, -and is described by all the files in this directory excepted gpio-legacy.txt. + and is described by all the files in this directory excepted gpio-legacy.txt. - The legacy integer-based interface which is considered deprecated (but still -usable for compatibility reasons) is documented in gpio-legacy.txt. + usable for compatibility reasons) is documented in gpio-legacy.txt. The remainder of this document applies to the new descriptor-based interface. gpio-legacy.txt contains the same information applied to the legacy diff --git a/Documentation/gpio/00-INDEX b/Documentation/gpio/00-INDEX index 179beb234f98..52fe0fa6c964 100644 --- a/Documentation/gpio/00-INDEX +++ b/Documentation/gpio/00-INDEX @@ -1,7 +1,5 @@ 00-INDEX - This file -gpio.txt - - Introduction to GPIOs and their kernel interfaces consumer.txt - How to obtain and use GPIOs in a driver driver.txt -- 2.16.1