Received: by 2002:a05:6a10:8c0a:0:0:0:0 with SMTP id go10csp817270pxb; Sat, 6 Mar 2021 19:19:46 -0800 (PST) X-Google-Smtp-Source: ABdhPJxWKBXUus9yOyfWZlGUjlNfMfI2sY3mRcuwCL7fL6Z91O5k/eQzL1S8KwmhKwmhIv2BETXO X-Received: by 2002:aa7:d656:: with SMTP id v22mr15854761edr.119.1615087186359; Sat, 06 Mar 2021 19:19:46 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1615087186; cv=none; d=google.com; s=arc-20160816; b=OvvvWZ/3NqQ1OJYjcYMD575QwRORFWAw4OPQh8Ezhq4cLWD8b7s+z7e0pAUdi0zdhv iPG0cNovEWp8fYhJKQCqP+q/ZYUy8MmgIVo5w77u81W61CBuWPyKz0k9bHqlKRDrv8fd KEXK6jubKEO5xa/zYs698l1tgkNvWZZSx0t16ib3/ZxNafnZbAGaODEvQXUd3k+aLP2s sb4ch8tJZgmC5uo8GBeHMcRj+2k3cylOiUoLfzMF8y2UBI69Rjs8t6LhuRZLFFP/8t/S /r70ZUQ7pOlg6vzL5OdmuqKXYUv6TKU1d/r0Hl/k0Yqfc3Bh6CaA498inp9n/iLw6vf8 UpZQ== 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 :dkim-signature; bh=oiRhle4TTum29WBndw3nlIp4Qv2NDLxbnTie42IDOu4=; b=BVCwtdvO2fs6PUiSBAzFReLOymFQHrGUZUU/ft2cCH3n169jxWBqtxTuq8R/wEyMMs yjjHWNJTNtOx9lLg/4hHNmps0mrGHSCnntFrVWnoOgdY++7furdmeieEorttza5Bhhef FrzszmM0HViK5miu7iUbJzBqvd5GNC3WBo2Spofw4QAUnxaf+eRxlBVct231e2YtohXL unU9De+V5DoqDV4LNtjP3BWZ6rnVv5oGyVkbUuJKyxdz4Uh7K/YrGyC2VqUwnvYHWlmd 2lYO1W9VXSRPmrTedBy7cub+u4Tu7t+pCgzE1CH8BaQegl2PkVB0oBf+b2g6wIUjZQqf xOzQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@penguintechs.org header.s=google header.b=NmPk+Kxg; 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id jp23si3687379ejb.643.2021.03.06.19.18.32; Sat, 06 Mar 2021 19:19:46 -0800 (PST) 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=@penguintechs.org header.s=google header.b=NmPk+Kxg; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230023AbhCGDMz (ORCPT + 99 others); Sat, 6 Mar 2021 22:12:55 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54466 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230045AbhCGDMk (ORCPT ); Sat, 6 Mar 2021 22:12:40 -0500 Received: from mail-pj1-x1036.google.com (mail-pj1-x1036.google.com [IPv6:2607:f8b0:4864:20::1036]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2B00EC06174A for ; Sat, 6 Mar 2021 19:12:29 -0800 (PST) Received: by mail-pj1-x1036.google.com with SMTP id mz6-20020a17090b3786b02900c16cb41d63so1260741pjb.2 for ; Sat, 06 Mar 2021 19:12:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=penguintechs.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=oiRhle4TTum29WBndw3nlIp4Qv2NDLxbnTie42IDOu4=; b=NmPk+Kxg1z7kuzVBw3tqljeRtZKghfrQkQc54IbKIUjCljpfFAoNUe6EED0099ejIT axeNugqurE27yihRz7oj6uWLk7iiLVvsJko9xYVMDv7dDcGhFwq3IfNehPGbyqiBydWV qPz6qOd/AZY3BUYULTpuQ9AyQLI5irCodk7gA= 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=oiRhle4TTum29WBndw3nlIp4Qv2NDLxbnTie42IDOu4=; b=QBE55fB1lWQxxKAX7kdcZDUtulknKtSoSgEACacOgHNY/Ntpk8r2hFkNN/l1gbSkuB Cw9C9/x1kZw4cd9D5fjujBb1s6IOiEZmT0uWl1joIjSlPJiXIdy4E2CYBX8GOzEsm4k3 2o0qnTfp+ld7rGr+wbIe/e27JZOUd0YVd0zy7s6yIkwtis+RGKFAomB5WGmlsvspWNH7 issHzIRgCqzxHwQmXtyQ5bJvQldMf8r1RmU4feaA3gGA44msR3i2y9HI932opw5XQgr6 Azo5kbGgX2mXb64VBILimJa2JNcCsrMrrQWiDPdpk2Vmq4Xs7GpSe8h0zotIatqeCQHz PRFw== X-Gm-Message-State: AOAM530upoq2OZDugQnUZk2c/aadzH8D8RxUffeff22n4Sx1DQvEfd5d 4fKh9qAlr6uQYlKyb4HZRsXHNg== X-Received: by 2002:a17:90a:d311:: with SMTP id p17mr17904181pju.43.1615086748344; Sat, 06 Mar 2021 19:12:28 -0800 (PST) Received: from braindead.localdomain (c-71-202-115-154.hsd1.ca.comcast.net. [71.202.115.154]) by smtp.gmail.com with ESMTPSA id s194sm6329911pfs.57.2021.03.06.19.12.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Mar 2021 19:12:27 -0800 (PST) From: Wren Turkal To: Jonathan Corbet Cc: Wren Turkal , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v2] Expose the bus kernel docs to the build docs. Date: Sat, 6 Mar 2021 19:12:19 -0800 Message-Id: <20210307031219.53800-1-wt@penguintechs.org> X-Mailer: git-send-email 2.30.1 In-Reply-To: <20210307014445.GT2723601@casper.infradead.org> References: <20210307014445.GT2723601@casper.infradead.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Before, the bus type related APIs that were defined in the include/linux/device/bus.h were not referenced anywhere in the docs, so I linked it to the bus types api documentation. Signed-off-by: Wren Turkal --- Documentation/driver-api/driver-model/bus.rst | 8 ++++++++ Documentation/driver-api/infrastructure.rst | 3 +-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/Documentation/driver-api/driver-model/bus.rst b/Documentation/driver-api/driver-model/bus.rst index 016b15a6e8ea..6bed459b87cc 100644 --- a/Documentation/driver-api/driver-model/bus.rst +++ b/Documentation/driver-api/driver-model/bus.rst @@ -1,3 +1,5 @@ +.. _bus_types: + ========= Bus Types ========= @@ -144,3 +146,9 @@ sysfs directory using:: int bus_create_file(struct bus_type *, struct bus_attribute *); void bus_remove_file(struct bus_type *, struct bus_attribute *); + +Fucntions and Structures +======================== + +.. kernel-doc:: include/linux/device/bus.h +.. kernel-doc:: drivers/base/bus.c diff --git a/Documentation/driver-api/infrastructure.rst b/Documentation/driver-api/infrastructure.rst index 683bd460e222..eb2a2c9e3c0c 100644 --- a/Documentation/driver-api/infrastructure.rst +++ b/Documentation/driver-api/infrastructure.rst @@ -41,8 +41,7 @@ Device Drivers Base .. kernel-doc:: drivers/base/platform.c :export: -.. kernel-doc:: drivers/base/bus.c - :export: +:ref:`bus_types` Device Drivers DMA Management ----------------------------- -- 2.30.1