On 6/21/23 15:35, Jakub Kicinski wrote:
> Enums benefit from private markings, too. For netlink attribute
> name enums always end with a pair of __$n_MAX and $n_MAX members.
> Documenting them feels a bit tedious.
>
> Signed-off-by: Jakub Kicinski <kuba@xxxxxxxxxx>
Reviewed-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Thanks.
> ---
> Hi Jon, we've CCed you recently on a related discussion
> but it appears that the fix is simple enough so posting
> it before you had a chance to reply.
> ---
> scripts/kernel-doc | 3 +++
> 1 file changed, 3 insertions(+)
>
> diff --git a/scripts/kernel-doc b/scripts/kernel-doc
> index 2486689ffc7b..66b554897899 100755
> --- a/scripts/kernel-doc
> +++ b/scripts/kernel-doc
> @@ -1301,6 +1301,9 @@ sub dump_enum($$) {
> my $file = shift;
> my $members;
>
> + # ignore members marked private:
> + $x =~ s/\/\*\s*private:.*?\/\*\s*public:.*?\*\///gosi;
> + $x =~ s/\/\*\s*private:.*}/}/gosi;
>
> $x =~ s@/\*.*?\*/@@gos; # strip comments.
> # strip #define macros inside enums
--
~Randy
