From b7d027b6a8b5a3c4094920d59f61d820ccbc0b0f Mon Sep 17 00:00:00 2001
From: Pavel Hrdina <phrdina@redhat.com>
Date: Wed, 25 Feb 2015 16:01:09 +0100
Subject: [PATCH] net-define: update or unify documentation

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

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
---
 src/libvirt-network.c | 5 +++--
 tools/virsh-network.c | 7 ++++---
 tools/virsh.pod       | 4 ++--
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/libvirt-network.c b/src/libvirt-network.c
index 8769c7965b..e3a3650083 100644
--- a/src/libvirt-network.c
+++ b/src/libvirt-network.c
@@ -1,7 +1,7 @@
 /*
  * libvirt-network.c: entry points for virNetworkPtr 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
@@ -433,7 +433,8 @@ virNetworkCreateXML(virConnectPtr conn, const char *xmlDesc)
  * @conn: pointer to the hypervisor connection
  * @xml: the XML description for the network, preferably in UTF-8
  *
- * Define a network, but does not create it
+ * Define an inactive persistent virtual network or modify an existing
+ * persistent one from the XML description.
  *
  * virNetworkFree should be used to free the resources after the
  * network object is no longer needed.
diff --git a/tools/virsh-network.c b/tools/virsh-network.c
index 5f8743c616..62323c4b78 100644
--- a/tools/virsh-network.c
+++ b/tools/virsh-network.c
@@ -1,7 +1,7 @@
 /*
  * virsh-network.c: Commands to manage network
  *
- * 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
@@ -189,10 +189,11 @@ cmdNetworkCreate(vshControl *ctl, const vshCmd *cmd)
  */
 static const vshCmdInfo info_network_define[] = {
     {.name = "help",
-     .data = N_("define (but don't start) a network from an XML file")
+     .data = N_("define an inactive persistent virtual network or modify "
+                "an existing persistent one from an XML file")
     },
     {.name = "desc",
-     .data = N_("Define a network.")
+     .data = N_("Define or modify a persistent virtual network.")
     },
     {.name = NULL}
 };
diff --git a/tools/virsh.pod b/tools/virsh.pod
index 0ff45c6aad..e65378e550 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -2701,8 +2701,8 @@ to get a description of the XML network format used by libvirt.
 
 =item B<net-define> I<file>
 
-Define a persistent virtual network from an XML I<file>, the network is just
-defined but not instantiated (started).
+Define an inactive persistent virtual network or modify an existing persistent
+one from the XML I<file>.
 
 =item B<net-destroy> I<network>
 
-- 
GitLab