From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f177.google.com (mail-pl1-f177.google.com [209.85.214.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BEA80390CA9 for ; Thu, 12 Mar 2026 17:53:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.177 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773338038; cv=none; b=Ast+RLkjduiUQm0HYywwrh+4X3LGbuRsVyc3dqH/s3+tDbGE+bvD3E7SmhPBHtIqYsRhQ7536J0CHjQlMSP/w4PAYfhhW8cfW4OUVQ0EdJ/5XhX62nba7CXlO5JpUC81jvWUPVUtsubfXAWv2rL/hhU6EDZeVJelKULYx6F8Rig= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773338038; c=relaxed/simple; bh=tEF3yhkGk7GJZbXxScXpV6WB7vdFV4j4XiHTGehOpVU=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=lK2NEqYDHcfiR+SxSfho7AEsVBHcjCjR6EckD5AogIt6DtXX3d08jK8g8rvcM7h0RKGhIvH36oheXYzPOj4IRJqn2jTc0IiC7wnCO3xT4roRA/1a3U6EqAKzuEbedEzei+HZjuDvUHQzVwoEJfXZYKdpiOSO/UZNuSH887QNN/0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=b2HQ2Cea; arc=none smtp.client-ip=209.85.214.177 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="b2HQ2Cea" Received: by mail-pl1-f177.google.com with SMTP id d9443c01a7336-2a7a9b8ed69so16649815ad.2 for ; Thu, 12 Mar 2026 10:53:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773338036; x=1773942836; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=QVWLPpAzQtONe2+RDE4AE36BbHIiMrCDRmv92u2lcVM=; b=b2HQ2Cea1O7SZhuLrNqbXYdKrGjzMzw3VJaV2TZCYg9VBaD6pcLuZMRJVnP3z+WcyK FpCq3HYOMdvR5Q7+Y9q2mMzCOG/1e0ojE597ZP/uV6Zl9j4UVJ9CgSoKwSEWgQpzlcPb 3VZpem2ym/Wpu9j/aju5DeWb2R52xEzciGRuZl9IlkGTh0sLxTujXt5jvTKqxS78TTtL qjyC9SCJ84IIWivaaFzO5t0SJCy2aprMDNv7zbUt3VNefxxbaKykM+6+y6FHjwkPGOV8 5bks8RRwSr7mn9azBn4MwCNjWrcBTUtj4ZclxFdDvgtUCWk3ZPnxS3Eg2B2ySuE4oNYh lAvg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1773338036; x=1773942836; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=QVWLPpAzQtONe2+RDE4AE36BbHIiMrCDRmv92u2lcVM=; b=RMnj0wRSBRU+w5Uh9+KpmdEfGZtdx2MXfEfIurEEvhkavU+NDxZfSM0d4FawmBxKYc 4wMrnkdlQqYfMbcQixRzkEIwx6AxOnK74hMh0XiStq5HWoVm+pulIFXClOC0sMAlqIiy Fwey9KPTr36wwIBVC+7k5+bdse9RdcaIT/mRNfQQY9hL3lmcar3ui0awFmUqNmUrKSJw CrVfapFD3kAWl+2KUtU9Rm6FWVaMRTxY4J9ztxRQJowJQA2GFuEgfFiYe/Fj+nWCbu3U ysPylqvghLG/LDpCrOML/2U82U17Hg3dQ7YoIzsphih3T1SOctFZVGB/b/1+T+U0yHt9 bfoA== X-Forwarded-Encrypted: i=1; AJvYcCVGVoxhMW6AicZhVQitMTDacirilJ6mFMiNiaIOEe6c9P6cvkDMP2RShVrVzO0+wAuqal1iljN9EW0LTZs=@vger.kernel.org X-Gm-Message-State: AOJu0Yxr8Yj0NC7SJ2DP42pIg0VWkjOQAn6XEnV2pPDfmTzCksq04CY2 LwyTy7Eey/Ap7D3wvjIZbbQMgGBZkR271fZHDF1CoZUF8pePeUGgj7nX X-Gm-Gg: ATEYQzykvezRqd87yhsFTY9Luwv7byDB5VDdErcl/ApORRySQGTM70y3FemQBfTYZpk VaMWWOTCDYBfIXPnE/18qMtgXwT6+QWhuTtghyCyJJdYk54rPpIWCjtU5gt+5fMZgUlTbrCn+BZ sqvmarUeOqGoBywrqXSCdDJeU2NP29LuyYSurFSWdy4jcyqGGgPCYzesVm4tJzxT/PSsgeOOYrE cQVH5S3U/QUOERuOttO7+KeFt+KECLZAKD3E69Cg4Ao3aP5wV4WWNN378AXjQYEoiIZHgk0VB0f o1sbqR1rlF3s2X/18pNQlBBP83pVafHv/umhfwzk3o9aU+mM+nUDeky8GZ70PFKeXeRvETEbU0r Y5s0vyILg1tBc9mBSDqKym8p8XjLramIJQZGVm+To/xDxBdFidlQZ+fB9dH32mcrCUT9g1ozPRB DYAyaWtKM2d+ZdNgZVuZhwI/NVquDLjx5EV9bifE4SAUxwXSVFKuDdbJlTIhQRt5Hhq6TnuFkPQ Fsa7IB9zn1Diw4nE1+jKuY9H32g8IUGD6+L X-Received: by 2002:a17:902:d542:b0:2ae:55eb:f82d with SMTP id d9443c01a7336-2aeca92183fmr3959315ad.1.1773338036145; Thu, 12 Mar 2026 10:53:56 -0700 (PDT) Received: from visitorckw-work01.c.googlers.com.com (7.162.199.104.bc.googleusercontent.com. [104.199.162.7]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2aeae378ca7sm60453345ad.91.2026.03.12.10.53.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Mar 2026 10:53:55 -0700 (PDT) From: Kuan-Wei Chiu To: djakov@kernel.org, corbet@lwn.net, skhan@linuxfoundation.org Cc: marscheng@google.com, wllee@google.com, aarontian@google.com, jserv@ccns.ncku.edu.tw, linux-doc@vger.kernel.org, linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, Kuan-Wei Chiu Subject: [PATCH 0/2] docs: interconnect: Improve API documentation coverage Date: Thu, 12 Mar 2026 17:53:39 +0000 Message-ID: <20260312175341.2944154-1-visitorckw@gmail.com> X-Mailer: git-send-email 2.53.0.851.ga537e3e6e9-goog Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Improve the generic interconnect subsystem documentation by including the existing kernel-doc comments from the source files. Currently, the documentation only includes the provider data structures from the header file and incorrectly states that consumer APIs are undocumented. Since drivers/interconnect/core.c contains a mix of both provider and consumer APIs, this series uses the kernel-doc :functions: directive to properly separate and document them in their respective sections. Kuan-Wei Chiu (2): docs: interconnect: Add provider APIs to documentation docs: interconnect: Document consumer APIs and drop outdated text Documentation/driver-api/interconnect.rst | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) -- 2.53.0.851.ga537e3e6e9-goog