Received: by 2002:a05:6a10:9848:0:0:0:0 with SMTP id x8csp595610pxf; Thu, 25 Mar 2021 09:49:13 -0700 (PDT) X-Google-Smtp-Source: ABdhPJydSiQ5tMDHDUzExA8R7xUDqUUe0TJ2gCadH9PZsL2BgcutMwL7nleeJpp7Nb2jBZTBflsN X-Received: by 2002:aa7:c3c1:: with SMTP id l1mr10381779edr.208.1616690952919; Thu, 25 Mar 2021 09:49:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616690952; cv=none; d=google.com; s=arc-20160816; b=Iwhh1c5eRIDinPBRdd6eFDuO4ZLJLZUJLzqgIvFiBin1ZXj083g+RpgN9hYQp0Q5O/ 58K8H61pjN/V4kyjRCNDgwtTsisx+Ar3TP7dg3DrZK0Fnz/+8jVqhCF1tvyY1NzJbEiD DeHU7HGZ17n6tl8jfFBig3N+3Z6MPGvYibKQWd+1cTTwhk1OXXXAP6bXjzZOOO9l5YmV 0MUJNX23k4xlf21cx2LWVG8utiwo3aoCBL5q9Y24opzO+oViH0crG/05CHoPCmtMBzl6 AOgve/ZLHFtjrPuxXa6Wcnd6UPBEm9GXmHqg9TAabWE26l6tekbRFA85hCwB2tLnZAND N3aA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=p60kgUQia6h9U0zFwDlfZUN+TxQFnlKZhghqx2vserA=; b=S7ObZTjeQsmuJipe+S0FkDUh7nHL7ZL52Ju8a9/TbjhgUvqVANtRj82uKZp87/eJNx q2iHAC/jv7hhR90uLjIvAqIfLH2U6k8C3jOAFJN1d7hoKM5+fQd5LoxNKMUVDKstWl1g HWnxgLeEzzWrmkckLNFAM5UXK0YVgENfPzKtT2n8Ol9cSVhuuR83l6+Y3MPHjZxK5jJ0 87bUjgSKG5zgxPwQW7Tlr79rzySzvtuAGQkMVeFB+NYP+Mf3fa6d7pbvwJDOnY0GLa65 0SHGTo/Th4vjI+P/NzQBabxjiHFZ3bC69YFSx4Lb03Z+avOvm25WthYvl/oJ8evHOgz4 oIEA== ARC-Authentication-Results: i=1; mx.google.com; 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 c12si4566504edv.455.2021.03.25.09.48.49; Thu, 25 Mar 2021 09:49:12 -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; 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 S229913AbhCYQrw (ORCPT + 99 others); Thu, 25 Mar 2021 12:47:52 -0400 Received: from mail-il1-f172.google.com ([209.85.166.172]:42593 "EHLO mail-il1-f172.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229592AbhCYQrX (ORCPT ); Thu, 25 Mar 2021 12:47:23 -0400 Received: by mail-il1-f172.google.com with SMTP id l5so2651645ilv.9; Thu, 25 Mar 2021 09:47:23 -0700 (PDT) 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:mime-version :content-transfer-encoding; bh=p60kgUQia6h9U0zFwDlfZUN+TxQFnlKZhghqx2vserA=; b=CWFGhM/+PXtLMltceWCjRzwQn7QztHJJTfanOxboauqMT3XBhmyGQ5hqfF34oKiXVj hdvDdnee1U66sKKvSalBQKDd9TcObtED6Fk4tKbHZOvGqmplg8+AWb2H0XyJazj9pu7d 5/Upfrr7BVJOm3aQ6FLH0BULvDQPajV6nFP4Cjqb9DP0qiM6x+bE+Zzgme/lLNuuWXT8 BLSEWO6n/i7ZMNZlXXpY6YYhoxg+8biRuYPxP8oolBymKBFMDdnduXdCbDyjdta8/P9I HqoE5tC7UHxPHVCpFWy8vwD2uLdD9ZgS897lGra4QqUlruDbnkR6RwJtO/mAvQVNxQts p9bQ== X-Gm-Message-State: AOAM533i0YpCSPC0XxG9qKbVRHDg7NL3cmgtf7C3CHilJGbpz/7GzBQl /TEiHP+VARJu8OYfeJe3pg4NiJlUvA== X-Received: by 2002:a92:dc49:: with SMTP id x9mr7461691ilq.281.1616690842710; Thu, 25 Mar 2021 09:47:22 -0700 (PDT) Received: from xps15.herring.priv ([64.188.179.253]) by smtp.googlemail.com with ESMTPSA id h13sm2868615ila.82.2021.03.25.09.47.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 25 Mar 2021 09:47:20 -0700 (PDT) From: Rob Herring To: devicetree@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Frank Rowand , Lee Jones , Mauro Carvalho Chehab , Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 0/8] dt: doc build improvements and kerneldoc addition Date: Thu, 25 Mar 2021 10:47:05 -0600 Message-Id: <20210325164713.1296407-1-robh@kernel.org> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This series reorganizes the DT documentation and adds the DT API kerneldoc to the documentation build. It's based on the current DT for-next branch which has a series of kerneldoc fixes from Lee Jones. Cc: Frank Rowand Cc: Lee Jones Cc: Mauro Carvalho Chehab Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Rob Herring (8): dt-bindings: Fix reference in submitting-patches.rst to the DT ABI doc docs: dt: writing-schema: Remove spurious indentation docs: dt: writing-schema: Include the example schema in the doc build docs: dt: Make 'Devicetree' wording more consistent docs: dt: Group DT docs into relevant sub-sections of: Fix kerneldoc output formatting of: Add missing 'Return' section in kerneldoc comments docs: dt: Add DT API documentation Documentation/devicetree/bindings/index.rst | 7 +- .../bindings/submitting-patches.rst | 4 +- .../{ => bindings}/writing-schema.rst | 17 +- Documentation/devicetree/changesets.rst | 8 +- .../devicetree/dynamic-resolution-notes.rst | 8 +- Documentation/devicetree/index.rst | 19 +- Documentation/devicetree/kernel-api.rst | 57 ++++ Documentation/devicetree/of_unittest.rst | 6 +- Documentation/devicetree/overlay-notes.rst | 8 +- Documentation/devicetree/usage-model.rst | 8 +- drivers/of/base.c | 323 +++++++++--------- drivers/of/dynamic.c | 19 +- drivers/of/fdt.c | 17 +- drivers/of/irq.c | 14 +- drivers/of/overlay.c | 16 +- drivers/of/platform.c | 10 +- drivers/of/property.c | 66 ++-- include/linux/of.h | 63 ++-- 18 files changed, 395 insertions(+), 275 deletions(-) rename Documentation/devicetree/{ => bindings}/writing-schema.rst (95%) create mode 100644 Documentation/devicetree/kernel-api.rst -- 2.27.0