Re: [PATCH v3 13/30] docstring: function: libvirt: Add 'Since version' metadata

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Thu, Apr 21, 2022 at 03:42:31PM +0200, Peter Krempa wrote:
> One more thing to consider is (not visible in this snipped patch as we
> see only a typedef) is that we already do have the version info for
> functions in the generated API xml. So ... do we even want to be adding
> them to the comments?
>
> Obvious pro is that it's visible right from the function comment when
> somebody is looking at the code itself.
>
> Obvious con is that there are now multiple places that have this info.

I think it makes sense to document version information for all public
symbols in the same way.

In the case of functions, the other source for this information (the
symbols file) can still be parsed and used to double-check that there
are no inconsistencies.

-- 
Andrea Bolognani / Red Hat / Virtualization




[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]

  Powered by Linux