From: Pavel Hrdina <phrdina@redhat.com>
Date: Wed, 25 Feb 2015 14:51:41 +0000 (+0100)
Subject: pool-define: update and unify documentation
X-Git-Tag: v1.2.14-rc1~229
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=03369d9643a1d96b385455bcbd13f9fcc9bd7470;p=thirdparty%2Flibvirt.git

pool-define: update and unify documentation

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1127045

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
---

diff --git a/src/libvirt-storage.c b/src/libvirt-storage.c
index 54c7332fae..474f198511 100644
--- a/src/libvirt-storage.c
+++ b/src/libvirt-storage.c
@@ -1,7 +1,7 @@
 /*
  * libvirt-storage.c: entry points for virStorage{Pool,Vol}Ptr APIs
  *
- * Copyright (C) 2006-2014 Red Hat, Inc.
+ * Copyright (C) 2006-2015 Red Hat, Inc.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -551,8 +551,8 @@ virStoragePoolCreateXML(virConnectPtr conn,
  * @xml: XML description for new pool
  * @flags: extra flags; not used yet, so callers should always pass 0
  *
- * Define a new inactive storage pool based on its XML description. The
- * pool is persistent, until explicitly undefined.
+ * Define an inactive persistent storage pool or modify an existing persistent
+ * one from the XML description.
  *
  * virStoragePoolFree should be used to free the resources after the
  * storage pool object is no longer needed.
diff --git a/tools/virsh-pool.c b/tools/virsh-pool.c
index addbcccb09..485d23daa6 100644
--- a/tools/virsh-pool.c
+++ b/tools/virsh-pool.c
@@ -1,7 +1,7 @@
 /*
  * virsh-pool.c: Commands to manage storage pool
  *
- * Copyright (C) 2005, 2007-2014 Red Hat, Inc.
+ * Copyright (C) 2005, 2007-2015 Red Hat, Inc.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -397,10 +397,11 @@ cmdPoolCreateAs(vshControl *ctl, const vshCmd *cmd)
  */
 static const vshCmdInfo info_pool_define[] = {
     {.name = "help",
-     .data = N_("define (but don't start) a pool from an XML file")
+     .data = N_("define an inactive persistent storage pool or modify "
+                "an existing persistent one from an XML file")
     },
     {.name = "desc",
-     .data = N_("Define a pool.")
+     .data = N_("Define or modify a persistent storage pool.")
     },
     {.name = NULL}
 };
diff --git a/tools/virsh.pod b/tools/virsh.pod
index 7cff5c4cd8..0ff45c6aad 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -3089,7 +3089,8 @@ the vHBA.
 
 =item B<pool-define> I<file>
 
-Create, but do not start, a pool object from the XML I<file>.
+Define an inactive persistent storage pool or modify an existing persistent one
+from the XML I<file>.
 
 =item B<pool-define-as> I<name> I<type> [I<--print-xml>]
 [I<--source-host hostname>] [I<--source-path path>] [I<--source-dev path>]