[PATCH v4 5/5] doc: phy: Document some bulk helper functions
sashiko-bot at kernel.org
sashiko-bot at kernel.org
Tue Sep 29 01:59:46 PDT 2026
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Low] doc: out-of-tree patch link in permanent documentation
--
commit 2b386d50e0a3a5183371e47d0b4d4b3c1f5d09e8
Author: Inochi Amaoto <inochiama at gmail.com>
doc: phy: Document some bulk helper functions
Document newly added bulk helper functions that can be used to manage
a set of PHYs automatically. This simplifies the management of multiple
PHYs for drivers.
> diff --git a/Documentation/driver-api/phy/phy.rst b/Documentation/driver-api/phy/phy.rst
> index 0865c2e94eece..9d238ba0296d3 100644
> --- a/Documentation/driver-api/phy/phy.rst
> +++ b/Documentation/driver-api/phy/phy.rst
[ ... ]
> @@ -221,3 +245,8 @@ DeviceTree Binding
>
> The documentation for PHY dt binding can be found @
> Documentation/devicetree/bindings/phy/phy-bindings.txt
> +
> +Missing Bulk Helpers
> +====================
> +Currently, only a few bulk helper functions are added as they have users.
> +Function not upstreamed can be found at https://lore.kernel.org/linux-phy/20260904083709.425893-1-inochiama@gmail.com/
[Severity: Low]
Is it appropriate to include links to out-of-tree patches in the permanent
kernel documentation?
This type of historical context and reference to unmerged code generally
belongs in the patch commit message or cover letter, rather than the
official API documentation.
--
Sashiko AI review · https://sashiko.dev/#/patchset/20260929085235.469515-1-inochiama@gmail.com?part=5
More information about the linux-phy
mailing list