From: Mika Westerberg <mika.westerberg@linux.intel.com>
To: linux-usb@vger.kernel.org
Cc: Yehezkel Bernat <YehezkelShB@gmail.com>,
Lukas Wunner <lukas@wunner.de>,
Andreas Noever <andreas.noever@gmail.com>,
Andy Shevchenko <andriy.shevchenko@linux.intel.com>,
Alan Borzeszkowski <alan.borzeszkowski@linux.intel.com>,
Mika Westerberg <mika.westerberg@linux.intel.com>
Subject: [PATCH 00/26] thunderbolt: kernel-doc fixes
Date: Mon, 8 Sep 2025 18:32:04 +0200 [thread overview]
Message-ID: <20250908163230.2614397-1-mika.westerberg@linux.intel.com> (raw)
Hi all,
This series fixes kernel-docs in the Thunderbolt/USB4 subsystem to adhere
the current standards.
All errors/warnings in documentation were found by kernel-doc script and
were subsequently fixed. Main recurring complaint was incorrect or missing
"Return: " section in kernel-doc comments. Besides that, few missing
parameters and structure field descriptions.
No functional changes.
This series was suggested by Andy Shevchenko.
Alan Borzeszkowski (26):
thunderbolt: Update acpi.c function documentation
thunderbolt: Update cap.c function documentation
thunderbolt: Update clx.c function documentation
thunderbolt: Update ctl.c function documentation
thunderbolt: Add missing documentation in ctl.h tb_cfg_request struct
thunderbolt: Update dma_port.c function documentation
thunderbolt: Update domain.c function documentation
thunderbolt: Update eeprom.c function documentation
thunderbolt: Update lc.c function documentation
thunderbolt: Update nhi.c function documentation
thunderbolt: Add missing documentation in nhi_regs.h ring_desc structure
thunderbolt: Update nvm.c function documentation
thunderbolt: Update path.c function documentation
thunderbolt: Update property.c function documentation
thunderbolt: Update retimer.c function documentation
thunderbolt: Update switch.c function documentation
thunderbolt: Update tb.c function documentation
thunderbolt: Update tb.h function documentation
thunderbolt: Add missing documentation in tb.h
thunderbolt: Update tmu.c function documentation
thunderbolt: Update tunnel.c function documentation
thunderbolt: Update tunnel.h function documentation
thunderbolt: Update usb4.c function documentation
thunderbolt: Update usb4_port.c function documentation
thunderbolt: Update xdomain.c function documentation
thunderbolt: Update thunderbolt.h header file
drivers/thunderbolt/acpi.c | 28 +--
drivers/thunderbolt/cap.c | 49 +++--
drivers/thunderbolt/clx.c | 12 +-
drivers/thunderbolt/ctl.c | 33 +++-
drivers/thunderbolt/ctl.h | 1 +
drivers/thunderbolt/dma_port.c | 21 +-
drivers/thunderbolt/domain.c | 28 ++-
drivers/thunderbolt/eeprom.c | 4 +-
drivers/thunderbolt/lc.c | 58 ++++--
drivers/thunderbolt/nhi.c | 17 +-
drivers/thunderbolt/nhi_regs.h | 6 +
drivers/thunderbolt/nvm.c | 42 ++--
drivers/thunderbolt/path.c | 14 +-
drivers/thunderbolt/property.c | 38 +++-
drivers/thunderbolt/retimer.c | 7 +-
drivers/thunderbolt/switch.c | 140 ++++++++++----
drivers/thunderbolt/tb.c | 30 +--
drivers/thunderbolt/tb.h | 45 +++--
drivers/thunderbolt/tmu.c | 16 +-
drivers/thunderbolt/tunnel.c | 85 +++++---
drivers/thunderbolt/tunnel.h | 9 +-
drivers/thunderbolt/usb4.c | 333 ++++++++++++++++++++++----------
drivers/thunderbolt/usb4_port.c | 7 +-
drivers/thunderbolt/xdomain.c | 46 +++--
include/linux/thunderbolt.h | 25 +--
25 files changed, 749 insertions(+), 345 deletions(-)
--
2.50.1
next reply other threads:[~2025-09-08 16:32 UTC|newest]
Thread overview: 29+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-09-08 16:32 Mika Westerberg [this message]
2025-09-08 16:32 ` [PATCH 01/26] thunderbolt: Update acpi.c function documentation Mika Westerberg
2025-09-08 16:32 ` [PATCH 02/26] thunderbolt: Update cap.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 03/26] thunderbolt: Update clx.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 04/26] thunderbolt: Update ctl.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 05/26] thunderbolt: Add missing documentation in ctl.h tb_cfg_request struct Mika Westerberg
2025-09-08 16:32 ` [PATCH 06/26] thunderbolt: Update dma_port.c function documentation Mika Westerberg
2025-09-08 16:32 ` [PATCH 07/26] thunderbolt: Update domain.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 08/26] thunderbolt: Update eeprom.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 09/26] thunderbolt: Update lc.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 10/26] thunderbolt: Update nhi.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 11/26] thunderbolt: Add missing documentation in nhi_regs.h ring_desc structure Mika Westerberg
2025-09-08 16:32 ` [PATCH 12/26] thunderbolt: Update nvm.c function documentation Mika Westerberg
2025-09-08 16:32 ` [PATCH 13/26] thunderbolt: Update path.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 14/26] thunderbolt: Update property.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 15/26] thunderbolt: Update retimer.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 16/26] thunderbolt: Update switch.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 17/26] thunderbolt: Update tb.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 18/26] thunderbolt: Update tb.h " Mika Westerberg
2025-09-08 16:32 ` [PATCH 19/26] thunderbolt: Add missing documentation in tb.h Mika Westerberg
2025-09-08 16:32 ` [PATCH 20/26] thunderbolt: Update tmu.c function documentation Mika Westerberg
2025-09-08 16:32 ` [PATCH 21/26] thunderbolt: Update tunnel.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 22/26] thunderbolt: Update tunnel.h " Mika Westerberg
2025-09-08 16:32 ` [PATCH 23/26] thunderbolt: Update usb4.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 24/26] thunderbolt: Update usb4_port.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 25/26] thunderbolt: Update xdomain.c " Mika Westerberg
2025-09-08 16:32 ` [PATCH 26/26] thunderbolt: Update thunderbolt.h header file Mika Westerberg
2025-09-17 5:52 ` [PATCH 00/26] thunderbolt: kernel-doc fixes Mika Westerberg
2025-09-17 8:15 ` Andy Shevchenko
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250908163230.2614397-1-mika.westerberg@linux.intel.com \
--to=mika.westerberg@linux.intel.com \
--cc=YehezkelShB@gmail.com \
--cc=alan.borzeszkowski@linux.intel.com \
--cc=andreas.noever@gmail.com \
--cc=andriy.shevchenko@linux.intel.com \
--cc=linux-usb@vger.kernel.org \
--cc=lukas@wunner.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.