Red Hat Bugzilla – Bug 713922
virsh man page refers to unspecified "documentation"
Last modified: 2016-04-26 10:09:31 EDT
In many places the virsh man page refers the user to "the documentation" but does not provide any guidance as to where that documentation might be found, which is especially puzzling since the man page is itself documentation. For example: "See the documentation to learn about libvirt XML format for a device." In other places, the man page refers the user to a specific webpage: "To better understand the values allowed as options for the command reading the documentation at <http://libvirt.org/formatdomain.html> on the format of the device sections to get the most accurate set of accepted values." The man page should specify the webpage in each instance.
Sent patch upstream.
Sent v2 upstream: http://www.redhat.com/archives/libvir-list/2012-March/msg00907.html
Upstream commit: commit ceb1d36b94be1de7264f86d1490450237238dc30 Author: Dave Allan <dallan@redhat.com> Date: Wed Mar 21 22:07:51 2012 -0400 Clarify what documentation is being referenced virsh.pod had several instances in which it referred to "the documentation" which was a little puzzling to me since it is documentation. Reading the document from end to end makes it clear that it means a specific URI which was noted previously in the text, but I had never noticed those URIs in several years of referring to the man page. This patch adds those URIs to several additional places in the text.
Verified this issue with libvirt-0.9.13-3.el6.x86_64. #man virsh -d, --debug LEVEL Enable debug messages at integer LEVEL and above. LEVEL can range from 0 to 4 (default). See the documentation of VIRSH_DEBUG environment variable below for the description of each LEVEL. #########updated to "below" connect URI [--readonly] ... For remote access see the documentation page at <http://libvirt.org/uri.html> on how to make URIs. The --readonly option allows for read-only connection ##########link was added attach-device domain-id FILE [--config] Attach a device to the domain, using a device definition in an XML file using a device definition element such as <disk> or <interface> as the top-level element. See the documentation at <http://libvirt.org/formatdomain.html#elementsDevices> to learn about libvirt XML format for a device. ###############link was added update-device domain-id file [--config] [--force] Update the characteristics of a device associated with domain-id, based on the device definition in an XML file. If the --config option is used, the changes will take affect the next time libvirt starts the domain. For compatibility purposes, --persistent is alias of --config. The --force option can be used to force device update, e.g., to eject a CD-ROM even if it is locked/mounted in the domain. See the documentation at <http://libvirt.org/formatdomain.html#elementsDevices> to learn about libvirt XML format for a device. ##################link was added net-create file Create a virtual network from an XML file, see the documentation at <http://libvirt.org/formatnetwork.html> to get a description of the XML network format used by libvirt. ##############link was added. So change the bug status to VERIFEID.
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHSA-2013-0276.html