Received: by 2002:a05:6a10:9848:0:0:0:0 with SMTP id x8csp596416pxf; Thu, 25 Mar 2021 09:49:51 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzng09HJwktMH1+dW2svLlxMXACv6fvHXVkfjS7vDuXOwm1UdGm6QOBj89j0KTWhQAVIv04 X-Received: by 2002:a05:6402:278b:: with SMTP id b11mr10106480ede.380.1616690991245; Thu, 25 Mar 2021 09:49:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616690991; cv=none; d=google.com; s=arc-20160816; b=O7S3u9Q+ZuJM/K4cjVcQQNb9X7O2hpig0WWhoNaxLmjqe2bD40hb28ILurFhSx/iHw if5246UAmZ0oG5zzpB3HnqKl+uD0ICwIY4p+3wP+uptD2CN/nkzqWhPvx1kECaZ8BLmF PiP4GdDGlIw+po8izgCTmsuDoLIniuh29t1J4wKTKhpG8pokhPSAXJL1s0zDN0gdWSYh 8Bj4kgTIk+Nv32j2B7pQMd4FZYFFv9NpXG9eu62dW37p2Xef2NbYaUQWsQ5wsDq02D4s ZBzgv+4Hi8q9GcZEUbgkuQYVzZk07g1EaI8mUhnydfcLd7AeTkEx7nmndTIa1pODeM/M /MyQ== 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 :references:in-reply-to:message-id:date:subject:cc:to:from; bh=1O1E/xRwZme5NOHcXojTDxawVUZizZj5kgRyChIK9Ao=; b=Sic8ZztrX4T5ggJ806Wio/9WGbf9Vjebsp/1tuRkMZFMH2JnH9SghZUJJ2BOujzEYf 2z0BoKzrPL4/Ihb7EsKuLTDHwgi+hi5AQ6Dr85elUoSNwe1nLkg92NwmlHLjOylCBuQF La6uucowsDCx0k99rhp5baDge8/nhuQ0gqa1xut4vPfxjAzTkseDRochYZTK1HK0szpK LmKQNTqS1t3pnMhL2yxDIHoMhmIcCfLrOKJjuzbcSmzAhcia5Qf//bh6CUq+QSVpeWo3 WBMx4IMshO47hbnScdNn+pYUCXCoHBq5lAYFiI4opwxwylMCn5rvdae2aPxf6jZAJIgW vP2A== 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 i9si4590537edx.595.2021.03.25.09.49.28; Thu, 25 Mar 2021 09:49:51 -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 S230095AbhCYQsK (ORCPT + 99 others); Thu, 25 Mar 2021 12:48:10 -0400 Received: from mail-il1-f180.google.com ([209.85.166.180]:34773 "EHLO mail-il1-f180.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229676AbhCYQrt (ORCPT ); Thu, 25 Mar 2021 12:47:49 -0400 Received: by mail-il1-f180.google.com with SMTP id u2so2693350ilk.1; Thu, 25 Mar 2021 09:47:49 -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:in-reply-to :references:mime-version:content-transfer-encoding; bh=1O1E/xRwZme5NOHcXojTDxawVUZizZj5kgRyChIK9Ao=; b=sfi7ror6M6j9nyTvcoRvlWfNcETGxKZaeUeJtcOY1SOnTUmKBhzakvuSGzT0IfPxxl beEfrwA+u2bm+8jQE/+yDv6jWvXs1049j0lv7fQ7tsAELZ7qn1XJvC+BrpPn8l6IMh9G nwYDhFEz4MP/6gJSO28dpkGSoWUfLfM3KliIjCXarWhClpVAK1lEIattqqlOhi+mk8yN /Wunr4bdbGXJU1XknqA+zCOxhiLzqXMeWDRVklOtBXw+fWYVTb77RiA6LAUEH9/gIZ7z OSqhWIW48NxO+vIna50tiFAHd7cLOw4uWrM1X01uSSWNE2yiwOXN7WlzNaghFYlhM8x3 uVPw== X-Gm-Message-State: AOAM5326XItPh+mNexOp7fxztIrmwm4alh3nCyIYoPeycmMAd3ZYtQfC 7Q4jaYmBBraPFHIsv9OnaBqxeVB5rg== X-Received: by 2002:a05:6e02:1d9b:: with SMTP id h27mr7501787ila.279.1616690868432; Thu, 25 Mar 2021 09:47:48 -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.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 25 Mar 2021 09:47:47 -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 8/8] docs: dt: Add DT API documentation Date: Thu, 25 Mar 2021 10:47:13 -0600 Message-Id: <20210325164713.1296407-9-robh@kernel.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210325164713.1296407-1-robh@kernel.org> References: <20210325164713.1296407-1-robh@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The kernel-doc for the DT APIs are not included in the documentation build. Add them. Cc: Frank Rowand Cc: Mauro Carvalho Chehab Signed-off-by: Rob Herring --- Documentation/devicetree/index.rst | 1 + Documentation/devicetree/kernel-api.rst | 57 +++++++++++++++++++++++++ 2 files changed, 58 insertions(+) create mode 100644 Documentation/devicetree/kernel-api.rst diff --git a/Documentation/devicetree/index.rst b/Documentation/devicetree/index.rst index 70b5dcdbcf07..1a2fc8014996 100644 --- a/Documentation/devicetree/index.rst +++ b/Documentation/devicetree/index.rst @@ -11,6 +11,7 @@ Kernel Devicetree Usage usage-model of_unittest + kernel-api Devicetree Overlays =================== diff --git a/Documentation/devicetree/kernel-api.rst b/Documentation/devicetree/kernel-api.rst new file mode 100644 index 000000000000..b7429e6ed6d5 --- /dev/null +++ b/Documentation/devicetree/kernel-api.rst @@ -0,0 +1,57 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. _devicetree: + +====================================== +DeviceTree Kernel API +====================================== + +Core functions +-------------- + +.. kernel-doc:: drivers/of/base.c + :export: + +.. kernel-doc:: include/linux/of.h + :internal: + +.. kernel-doc:: drivers/of/property.c + :export: + +.. kernel-doc:: include/linux/of_graph.h + :internal: + +.. kernel-doc:: drivers/of/address.c + :export: + +.. kernel-doc:: drivers/of/irq.c + :export: + +.. kernel-doc:: drivers/of/fdt.c + :export: + +Driver model functions +---------------------- + +.. kernel-doc:: include/linux/of_device.h + :internal: + +.. kernel-doc:: drivers/of/device.c + :export: + +.. kernel-doc:: include/linux/of_platform.h + :internal: + +.. kernel-doc:: drivers/of/platform.c + :export: + +Overlay and Dynamic DT functions +-------------------------------- + +.. kernel-doc:: drivers/of/resolver.c + :export: + +.. kernel-doc:: drivers/of/dynamic.c + :export: + +.. kernel-doc:: drivers/of/overlay.c + :export: -- 2.27.0