iface-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-interface.c b/src/libvirt-interface.c
index 815a41a78d048a47af86d23de71db736ae98b0a7..4c155ca17b744d955a9573746f6771eb15d0561c 100644 (file)
--- a/src/libvirt-interface.c
+++ b/src/libvirt-interface.c
@@ -1,7 +1,7 @@
 /*
  * libvirt-interface.c: entry points for virInterfacePtr 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
@@ -443,7 +443,8 @@ virInterfaceGetXMLDesc(virInterfacePtr iface, unsigned int flags)
  * @xml: the XML description for the interface, preferably in UTF-8
  * @flags: extra flags; not used yet, so callers should always pass 0
  *
- * Define an interface (or modify existing interface configuration).
+ * Define an inactive persistent physical host interface or modify an existing
+ * persistent one from the XML description.
  *
  * Normally this change in the interface configuration is immediately
  * permanent/persistent, but if virInterfaceChangeBegin() has been

diff --git a/tools/virsh-interface.c b/tools/virsh-interface.c
index 5f848b6140b62fcecde0df32212d29fe174bcd43..3251e01c92b589aaaec320472d6ab81eebd3fcbd 100644 (file)
--- a/tools/virsh-interface.c
+++ b/tools/virsh-interface.c
@@ -1,7 +1,7 @@
 /*
  * virsh-interface.c: Commands to manage host interface
  *
- * 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
@@ -507,10 +507,11 @@ cmdInterfaceDumpXML(vshControl *ctl, const vshCmd *cmd)
  */
 static const vshCmdInfo info_interface_define[] = {
     {.name = "help",
-     .data = N_("define (but don't start) a physical host interface from an XML file")
+     .data = N_("define an inactive persistent physical host interface or "
+                "modify an existing persistent one from an XML file")
     },
     {.name = "desc",
-     .data = N_("Define a physical host interface.")
+     .data = N_("Define or modify a persistent physical host interface.")
     },
     {.name = NULL}
 };

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 4670554e0cbe8b83bb266e2256fc4cf141871289..7cff5c4cd8f2108e9ad6fb9c52353567d415a5d4 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -2861,8 +2861,8 @@ See also B<iface-unbridge> for undoing this operation.
 
 =item B<iface-define> I<file>
 
-Define a host interface from an XML I<file>, the interface is just defined but
-not started.
+Define an inactive persistent physical host interface or modify an existing
+persistent one from the XML I<file>.
 
 =item B<iface-destroy> I<interface>