Received: by 2002:a25:1985:0:0:0:0:0 with SMTP id 127csp709405ybz; Wed, 15 Apr 2020 17:13:18 -0700 (PDT) X-Google-Smtp-Source: APiQypKUArFoYAEpxazpZz4Yox+laECivcVOz7y6MG6QTfH+pfpTq4SJQ0FAqoDWXvcyIG4xe/iS X-Received: by 2002:a17:906:d14b:: with SMTP id br11mr7483368ejb.213.1586995998552; Wed, 15 Apr 2020 17:13:18 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1586995998; cv=none; d=google.com; s=arc-20160816; b=o2kHaUdQRkve2HG9WWBeiHJ17PalcbdmropDNI6/wWh3m51XEpQGzlXWEnwd7eUqTO NL0SsF3ng+Kzlp0MY9pMvRdwtRdigdyC0XEyj/aPDX/68/HlFLRwbFvUHMQc1WJswazz QmuIUzW5eho1+aj04wi5JLH/6cFJUtpX5RdPSGjkVwOHN9x6x0BCvAbwYpiBsF2RvHdk wuDQO21aVqSZdegYktKSnB7wnV5QXlYRyqDLDhjODsFz5cR/IC5H0Lwrg52l1Al5Hw/U qACQkfqTqFc+nMS9XaNbz7Y68+pXM38LSNAhpaDh2kqPncollc7J4xDaKXuHLit0wGUX 7Y7w== 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 :message-id:date:subject:cc:to:from:dkim-signature; bh=hto/aadDrKOZbdaWt4v2ooOaAT3V+5eu9RhJ021FkvY=; b=n1UbwFbpyBXcZRxBbBv2DcXnf9WOwPN4/IJ3L8C9lYaIxJngmyb6v3Tunv6jXKZPMt +E2UQJH6NQkIGqQAp9YEoscf6O2ojh3VQ8eHKdVSm3TbrYkztd8h4DukTEwWEOHK6xmb unICQRa2MYUNCSWBBqveVZU1IfHu6l/56jNQtE+wGwVb2hORzseJ/gVq5xxQKa6QzLq4 4WsmKsCRXd8s7ZPTTkLiELEOCm7JtbHjjSh/RjO6k2eAUKb7sawvk+w7Lg8MJO43rNIG Cv9KjbH3RWBuMsgsJQ0W96GMKEFGLvvDuC8Qz9bqMOban2/mwH4B3ACAwVTObP48hgSp 8Pow== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=n4PNln3z; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id n12si8493073edb.227.2020.04.15.17.12.55; Wed, 15 Apr 2020 17:13:18 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=n4PNln3z; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2634658AbgDOOps (ORCPT + 99 others); Wed, 15 Apr 2020 10:45:48 -0400 Received: from mail.kernel.org ([198.145.29.99]:39956 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2634626AbgDOOpa (ORCPT ); Wed, 15 Apr 2020 10:45:30 -0400 Received: from mail.kernel.org (ip5f5ad4d8.dynamic.kabel-deutschland.de [95.90.212.216]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id D95C7208FE; Wed, 15 Apr 2020 14:45:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586961929; bh=LBRibY2+edxEVgU7UWVvu+ttauPTs/x7bDvivBGYcDM=; h=From:To:Cc:Subject:Date:From; b=n4PNln3zdNelJMiElhbfb9f5iXXBeQXqhu/3vBtCDuyrMr+CvLYnl1L2YPSbo4//J zgJVH8OYkZ14CECkqwXlstWPSgeB0OlKPSoWURDRZ/JOSIcTgB7GFI0G1nas/LEB7W Wo80tmACWbn1qYlO9vCJYnLnfOSb8Se5rWL26R1w= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jOjI7-006kZ8-0p; Wed, 15 Apr 2020 16:45:27 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Martin Blumenstingl , "David S. Miller" , Alexandre Belloni , Joe Perches , Pantelis Antoniou , Kevin Hilman , Neil Armstrong , Alex Shi , Jianxin Pan , Greg Kroah-Hartman , Lee Jones , Christian Hewitt , Federico Vaga , Nicolas Ferre , Rob Herring , Konstantin Ryabitsev , Andy Whitcroft , devicetree@vger.kernel.org, Harry Wei , Jacob Huisman , Frank Rowand Subject: [PATCH v3 00/12] Convert some DT documentation files to ReST Date: Wed, 15 Apr 2020 16:45:14 +0200 Message-Id: X-Mailer: git-send-email 2.25.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org While most of the devicetree stuff has its own format (with is now being converted to YAML format), some documents there are actually describing the DT concepts and how to contribute to it. IMHO, those documents would fit perfectly as part of the documentation body, as part of the firmare documents set. This patch series manually converts some DT documents that, on my opinion, would belong to it. If you want to see how this would show at the documentation body, a sneak peak of this series (together with the other pending doc patches from me) is available at: https://www.infradead.org/~mchehab/kernel_docs/devicetree/index.html - v3: - rebased on the top of next-20200414 Mauro Carvalho Chehab (12): docs: dt: add an index.rst file for devicetree docs: dt: convert usage-model.txt to ReST docs: dt: usage_model.rst: fix link for DT usage docs: dt: convert booting-without-of.txt to ReST format docs: dt: convert changesets to ReST docs: dt: convert dynamic-resolution-notes.txt to ReST docs: dt: convert of_unittest.txt to ReST docs: dt: convert overlay-notes.txt to ReST format docs: dt: minor adjustments at writing-schema.rst docs: dt: convert ABI.txt to ReST format docs: dt: convert submitting-patches.txt to ReST format docs: dt: convert writing-bindings.txt to ReST Documentation/arm/booting.rst | 2 +- Documentation/arm/microchip.rst | 2 +- .../devicetree/bindings/{ABI.txt => ABI.rst} | 5 +- .../devicetree/bindings/arm/amlogic.yaml | 2 +- .../devicetree/bindings/arm/syna.txt | 2 +- Documentation/devicetree/bindings/index.rst | 12 + ...ing-patches.txt => submitting-patches.rst} | 12 +- ...ting-bindings.txt => writing-bindings.rst} | 9 +- ...-without-of.txt => booting-without-of.rst} | 299 ++++++++++-------- .../{changesets.txt => changesets.rst} | 24 +- ...notes.txt => dynamic-resolution-notes.rst} | 5 +- Documentation/devicetree/index.rst | 18 ++ .../{of_unittest.txt => of_unittest.rst} | 186 +++++------ .../{overlay-notes.txt => overlay-notes.rst} | 143 +++++---- .../{usage-model.txt => usage-model.rst} | 35 +- Documentation/devicetree/writing-schema.rst | 9 +- Documentation/index.rst | 3 + Documentation/process/submitting-patches.rst | 2 +- .../it_IT/process/submitting-patches.rst | 2 +- Documentation/translations/zh_CN/arm/Booting | 2 +- MAINTAINERS | 4 +- include/linux/mfd/core.h | 2 +- scripts/checkpatch.pl | 2 +- 23 files changed, 446 insertions(+), 336 deletions(-) rename Documentation/devicetree/bindings/{ABI.txt => ABI.rst} (94%) create mode 100644 Documentation/devicetree/bindings/index.rst rename Documentation/devicetree/bindings/{submitting-patches.txt => submitting-patches.rst} (92%) rename Documentation/devicetree/bindings/{writing-bindings.txt => writing-bindings.rst} (89%) rename Documentation/devicetree/{booting-without-of.txt => booting-without-of.rst} (90%) rename Documentation/devicetree/{changesets.txt => changesets.rst} (59%) rename Documentation/devicetree/{dynamic-resolution-notes.txt => dynamic-resolution-notes.rst} (90%) create mode 100644 Documentation/devicetree/index.rst rename Documentation/devicetree/{of_unittest.txt => of_unittest.rst} (54%) rename Documentation/devicetree/{overlay-notes.txt => overlay-notes.rst} (56%) rename Documentation/devicetree/{usage-model.txt => usage-model.rst} (97%) -- 2.25.2