[libvirt PATCH 1/4] docs: coding-style: Clarify on virXXXPtr types

Andrea Bolognani abologna at redhat.com
Fri Jan 14 17:24:23 UTC 2022

On Fri, Jan 14, 2022 at 04:43:58PM +0100, Ján Tomko wrote:
> On a Friday in 2022, Tim Wiederhake wrote:
> > +   Historically, libvirt declared pointer types 'virXXXPtr' for
> > +   both public and internal types. Do not introduce new such
> > +   typedefs for internal types.
> This weakly suggests that they should be introduced for new public
> types. I have no preference, but I think we should mention it here
> if we're mentioning internal types.

Agreed. More specifically, I think we should encourage defining the
Ptr alias for public types because, much as I dislike their
existence, having a mix of both conventions in the public API would
be IMO worse than sticking with the status quo.

Andrea Bolognani / Red Hat / Virtualization

More information about the libvir-list mailing list