docs: standardize description of flags
docs: standardize description of flags

We had loads of different styles in describing the @flags parameter
for various APIs, as well as several APIs that didn't list which
enums provided the bit values valid for the flags.

The end result is one of two formats:
@flags: bitwise-OR of vir...Flags
@flags: extra flags; not used yet, so callers should always pass 0

* src/libvirt.c: Use common sentences for flags.  Also,
(virDomainGetBlockIoTune): Mention virTypedParameterFlags.
(virConnectOpenAuth): Mention virConnectFlags.
(virDomainMigrate, virDomainMigrate2, virDomainMigrateToURI)
(virDomainMigrateToURI2): Mention virDomainMigrateFlags.
(virDomainMemoryPeek): Mention virDomainMemoryFlags.
(virStoragePoolBuild): Mention virStoragePoolBuildFlags.
(virStoragePoolDelete): Mention virStoragePoolDeleteFlags.
(virStreamNew): Mention virStreamFlags.
(virDomainOpenGraphics): Mention virDomainOpenGraphicsFlags.

olafhering/libvirt,siboulet/libvirt-openvz,wiedi/libvirt,zhlcindy/libvirt-1.1.4-maintain,libvirt/libvirt,jardasgit/libvirt,emaste/libvirt,rmarwaha/libvirt1,wiedi/libvirt,emaste/libvirt,jeckersb/libvirt,danwent/libvirt-ovs,wiedi/libvirt,dumbbell/libvirt,dumbbell/libvirt,datto/libvirt,dumbbell/libvirt,bjzhang/libvirt,agx/libvirt,novel/fbsd-libvirt,trainstack/libvirt,olafhering/libvirt,iam-TJ/libvirt,shugaoye/libvirt,elmarco/libvirt,zippy2/libvirt,agx/libvirt,rlaager/libvirt,bjzhang/libvirt,iam-TJ/libvirt,nertpinx/libvirt,andreabolognani/libvirt,jeckersb/libvirt,jeckersb/libvirt,zippy2/libvirt,jfehlig/libvirt,rmarwaha/libvirt1,foomango/libvirt,warewolf/libvirt,shugaoye/libvirt,elmarco/libvirt,emaste/libvirt,shugaoye/libvirt,eskultety/libvirt,emaste/libvirt,nertpinx/libvirt,rlaager/libvirt,dumbbell/libvirt,trainstack/libvirt,rlaager/libvirt,bjzhang/libvirt,libvirt/libvirt,rmarwaha/libvirt1,jeckersb/libvirt,rmarwaha/libvirt,fabianfreyer/libvirt,andreabolognani/libvirt,jeckersb/libvirt,jfehlig/libvirt,fabianfreyer/libvirt,elmarco/libvirt,nertpinx/libvirt,shugaoye/libvirt,taget/libvirt,olafhering/libvirt,bjzhang/libvirt,rmarwaha/libvirt,zhlcindy/libvirt-1.1.4-maintain,warewolf/libvirt,iam-TJ/libvirt,cbosdo/libvirt,iam-TJ/libvirt,VenkatDatta/libvirt,nertpinx/libvirt,cbosdo/libvirt,emaste/libvirt,cbosdo/libvirt,eskultety/libvirt,jfehlig/libvirt,zippy2/libvirt,danwent/libvirt-ovs,libvirt/libvirt,novel/fbsd-libvirt,warewolf/libvirt,elmarco/libvirt,wiedi/libvirt,jeckersb/libvirt,taget/libvirt,taget/libvirt,crobinso/libvirt,datto/libvirt,trainstack/libvirt,rmarwaha/libvirt,emaste/libvirt,emaste/libvirt,rmarwaha/libvirt,danwent/libvirt-ovs,danwent/libvirt-ovs,wiedi/libvirt,datto/libvirt,eskultety/libvirt,eskultety/libvirt,shugaoye/libvirt,warewolf/libvirt,siboulet/libvirt-openvz,agx/libvirt,novel/fbsd-libvirt,datto/libvirt,warewolf/libvirt,jardasgit/libvirt,rmarwaha/libvirt,olafhering/libvirt,jfehlig/libvirt,crobinso/libvirt,nertpinx/libvirt,rmarwaha/libvirt1,trainstack/libvirt,VenkatDatta/libvirt,siboulet/libvirt-openvz,fabianfreyer/libvirt,bjzhang/libvirt,libvirt/libvirt,zhlcindy/libvirt-1.1.4-maintain,warewolf/libvirt,novel/fbsd-libvirt,danwent/libvirt-ovs,zhlcindy/libvirt-1.1.4-maintain,siboulet/libvirt-openvz,trainstack/libvirt,fabianfreyer/libvirt,siboulet/libvirt-openvz,taget/libvirt,datto/libvirt,jardasgit/libvirt,rmarwaha/libvirt1,jeckersb/libvirt,zippy2/libvirt,crobinso/libvirt,iam-TJ/libvirt,warewolf/libvirt,foomango/libvirt,agx/libvirt,VenkatDatta/libvirt,crobinso/libvirt,dumbbell/libvirt,rmarwaha/libvirt1,jardasgit/libvirt,VenkatDatta/libvirt,eskultety/libvirt,iam-TJ/libvirt,novel/fbsd-libvirt,novel/fbsd-libvirt,trainstack/libvirt,novel/fbsd-libvirt,taget/libvirt,VenkatDatta/libvirt,novel/fbsd-libvirt,rlaager/libvirt,dumbbell/libvirt,iam-TJ/libvirt,cbosdo/libvirt,foomango/libvirt,zhlcindy/libvirt-1.1.4-maintain,foomango/libvirt,foomango/libvirt,novel/fbsd-libvirt,fabianfreyer/libvirt,cbosdo/libvirt,trainstack/libvirt,wiedi/libvirt,agx/libvirt,andreabolognani/libvirt,andreabolognani/libvirt,rmarwaha/libvirt,rlaager/libvirt,elmarco/libvirt,jardasgit/libvirt,andreabolognani/libvirt,wiedi/libvirt