[PATCH 0/3] Better documentation of migration APIs and flags

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

 



We have 6 public APIs for migration: virDomainMigrate,
virDomainMigrate2, virDomainMigrate3, virDomainMigrateToURI,
virDomainMigrateToURI2, and virDomainMigrateToURI3. Each of them was
documented separately, but the documentation was not consistent. Some
APIs documented individual flags, some didn't do that. Some notes about
specific behavior were not added to all APIs. And so on. Since the newer
versions provide a superset of the functionality of the older ones
mainly adding new parameters, it doesn't really make sense to keep 6
(ideally) almost identical copies of the same documentation.

To get out of this mess this patch set moves documentation of individual
migration flags directly to libvirt-domain.h, where the flags are
defined. And the documentation of virDomainMigrate{,ToURI}{,2} is
reduced to point to the *3 APIs with a description of how old parameters
are mapped to the new ones.

Jiri Denemark (3):
  Enhance documentation of virDomainMigrateFlags
  Consolidate documentation of virDomainMigrate{,ToURI}{,2,3}
  docs: Update news

 docs/news.html.in                |   2 +
 include/libvirt/libvirt-domain.h | 153 ++++++++++++++---
 src/libvirt-domain.c             | 348 ++++-----------------------------------
 3 files changed, 170 insertions(+), 333 deletions(-)

-- 
2.11.0.rc2

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list



[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