snapshots: Clarify comments on snapshot role

Give some more details on what a snapshot is good for, to make
it easier to distinguish from the role of upcoming additions for
incremental backups.

Signed-off-by: Eric Blake <eblake@redhat.com>
Reviewed-by: John Ferlan <jferlan@redhat.com>
This commit is contained in:
Eric Blake 2018-06-25 19:16:04 -05:00
parent f78b73e68e
commit 0ec6343a06

View File

@ -31,15 +31,17 @@
/** /**
* virDomainSnapshot: * virDomainSnapshot:
* *
* a virDomainSnapshot is a private structure representing a snapshot of * A virDomainSnapshot is a private structure representing a snapshot of
* a domain. * a domain. A snapshot captures the state of the domain at a point in
* time, with the intent that the guest can be reverted back to that
* state at a later time.
*/ */
typedef struct _virDomainSnapshot virDomainSnapshot; typedef struct _virDomainSnapshot virDomainSnapshot;
/** /**
* virDomainSnapshotPtr: * virDomainSnapshotPtr:
* *
* a virDomainSnapshotPtr is pointer to a virDomainSnapshot private structure, * A virDomainSnapshotPtr is pointer to a virDomainSnapshot private structure,
* and is the type used to reference a domain snapshot in the API. * and is the type used to reference a domain snapshot in the API.
*/ */
typedef virDomainSnapshot *virDomainSnapshotPtr; typedef virDomainSnapshot *virDomainSnapshotPtr;