From patchwork Thu Mar 25 16:47:05 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Rob Herring \(Arm\)" X-Patchwork-Id: 408838 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp700102jai; Thu, 25 Mar 2021 09:48:24 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxVOJsgLkSXcje7qsMtZjTg5yoM7zzqWYpyKDBd38N5E6nrRF+d08Y1wgG8EzBV7o4TMriB X-Received: by 2002:a50:ef11:: with SMTP id m17mr10131676eds.151.1616690904330; Thu, 25 Mar 2021 09:48:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616690904; cv=none; d=google.com; s=arc-20160816; b=MesZGcYyKyceHVyuJ5JPd0MqEQb5gJLI28JKLIT0VQ8dnbljr1NerrLrOvLpniI7pZ 6Ope6rsgIKvDzZzxfE7Q4mQ7JNerPa49qjF1vH8Ji2iWy7fVS4Nku1UR4jqzS+y1itYQ wwfHAGVBOq+eLDZI9fwHEtXhrf0jDCpM7TO48iwCD2UGjEzuKBmEWDxNk/HW4bP7Ssf+ KFMU9wj3i5qDUbkadBiw0VDM7dHga/zUvQA26g0KKB4t14QPEiaFTy3qPmXQ+X1IGyIq MdiqkV9UWq6NfwFxVIets0rqdJFO64bPunJpdsSJ0hukLGuHwqEzc95kDVYq1SfsY5zy ormw== 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=qco6b1JxqCTVvWRDbBicFWTvl9KXzYMhPcolN5l53dSkcQqkBE3OuNDrVRjvRDxXS7 H/8sfxp2PbP9e/tF43yqugXcuaIVcgOzjDLXtuE67CLqgOICG8brd7HMtJ9d0Svw9HAK 1b1EKQJaM8OX7y0cDOvIG4OumT/1uTNi7TtIc34/agYC0wqhVeWRFouBVymGV+U0fM5A tumpwjz3NOAnHFaeJJ4phjufiMiB8j3x3RK1Wg+BNV0n97mf+b+Ev6vUZAb9N2OHGAlR OxiDFOsO+j1nYCBSo0UNZNrSooCHrdVDeOcch08nENKwQ78O+QkuXAEHAtJKUp50jBqG bMuQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-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 f7si4498477edu.503.2021.03.25.09.48.23; Thu, 25 Mar 2021 09:48:24 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-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 devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-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 S229893AbhCYQrv (ORCPT + 6 others); Thu, 25 Mar 2021 12:47:51 -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 Precedence: bulk List-ID: X-Mailing-List: devicetree@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