[Libguestfs] [libnbd PATCH] docs: Clarify how callbacks should handle errors

Laszlo Ersek lersek at redhat.com
Thu Feb 3 12:39:12 UTC 2022


On 02/03/22 13:10, Nir Soffer wrote:

> The text should make it clear that the caller need to chose how to use
> the library, either use callbacks or use completion checks.

Agreed 100%; this was one of my points as well:

"""
s/auto-retirement is in use/you choose to retire asynchronous commands
automatically, rather than manually/
"""

Keyword being "choose" -- it's a decision the programmer needs to make.
The term "is in use" does not place the responsibility clearly with
anything or anyone.

Thanks!
Laszlo




More information about the Libguestfs mailing list