Description of problem: at virDomainDetachDeviceFlags Doc, it is stated that this function is asynchronous, and the user should verify that a device was actually detached after using it. at virDomainDetachDevice Doc, Nothing is mentioned regarding that issue, which is misleading. Expected results: All the information regarding how virDomainDetachDevice works, and what differs it from virDomainDetachDeviceFlags should be detailed in the Docs.
This is now fixed upstream by v1.2.21-141-g63fd27c commit 63fd27cfa35f39b32692b9c66e59c4d157ce8806 Author: Jiri Denemark <jdenemar> Date: Wed Nov 25 16:39:17 2015 +0100 Enhance documentation of virDomainDetachDevice Link it to virDomainDetachDeviceFlags. https://bugzilla.redhat.com/show_bug.cgi?id=1257280 Signed-off-by: Jiri Denemark <jdenemar>