Subject: Re: [patch net-next] docs: netlink: add NLMSG_DONE message format for doit actions

From: Jakub Kicinski <[email-masked]>
Date: Thu, 30 Nov 2023 09:39:39 -0800

On Thu, 30 Nov 2023 14:30:36 +0100 Jiri Pirko wrote:
> >connector is a really bad example, the doc would have to say "some
> >families use NLMSG_DONE as an actual message type which may have pretty
> >much anything attached to it". It's not worth it, sorry.  
> 
> The existing documentation confuses uapi users (I have sample).
> They expect error with NLMSG_DONE.

I hate this so much.

How about we say:

  Note that some families may issue custom NLMSG_DONE messages,
  in which case the payload is implementation-specific.