Re: [PATCH net-next v3] net: Add support for providing the PTP hardware source in tsinfo

[Kory Maincent]

On Thu, 15 May 2025 13:51:40 +0200
Paolo Abeni <pabeni@xxxxxxxxxx> wrote:

> On 5/13/25 1:40 PM, Kory Maincent wrote:
> > diff --git a/Documentation/netlink/specs/ethtool.yaml
> > b/Documentation/netlink/specs/ethtool.yaml index
> > c650cd3dcb80bc93c5039dc8ba2c5c18793ff987..881e483f32e18f77c009f278bd2d2029c30af352
> > 100644 --- a/Documentation/netlink/specs/ethtool.yaml +++
> > b/Documentation/netlink/specs/ethtool.yaml @@ -98,6 +98,23 @@ definitions:
> >      name: tcp-data-split
> >      type: enum
> >      entries: [ unknown, disabled, enabled ]
> > +  -
> > +    name: hwtstamp-source
> > +    enum-name: hwtstamp-source
> > +    name-prefix: hwtstamp-source-
> > +    type: enum
> > +    entries:  
> 
> This causes a kdoc warning in the generated hdr, lacking the short
> description for the enum:
> 
> include/uapi/linux/ethtool_netlink_generated.h:42: warning: missing
> initial short description on line:
>  * enum hwtstamp_source
> 
> Please add a:
>     doc: <>

Ack, I will.

Regards,
-- 
Köry Maincent, Bootlin
Embedded Linux and kernel engineering
https://bootlin.com