Bug 593172

Summary:	DOCS: virsh manpage lacks information about pool- options.
Product:	[Community] Virtualization Tools	Reporter:	Jo-Erlend Schinstad <joerlend.schinstad>
Component:	libvirt	Assignee:	Libvirt Maintainers <libvirt-maint>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	medium	Docs Contact:
Priority:	low
Version:	unspecified	CC:	berrange, crobinso, eblake, jclift, kparal, xen-maint
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-04-18 21:10:15 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Jo-Erlend Schinstad 2010-05-18 04:21:24 UTC

Description of problem:
If you try man virsh to look for things related to the storage pools, then you'll discover that those options aren't mentioned at all. 

Since this is a fairly important part of virsh and the manpage doesn't cover it, other things might be missing. It would be nice if someone who knows virsh very well took a look at it and uncovered anything else that might be missing.

Comment 1 Kamil Páral 2010-07-08 11:14:29 UTC

I second this request, pool-* commands are missing from the virsh manpage.

Comment 2 Eric Blake 2012-04-18 21:10:15 UTC

Fixed starting in 0.8.0 with:
commit 9f337ef7525e44d32afaef5f650ede2d07a482b2
Author: Eric Blake <eblake>
Date:   Mon Apr 5 17:21:02 2010 -0600

    virsh: improve documentation
    
    Document several missing commands.  There's more work that could be
    done, but incremental improvements is better than no patch at all.
    
    * tools/virsh.pod (autostart, connect): Improve grammar.
    (create): Improve example.
    (domjobabort, domjobinfo, domxml-from-native, domxml-to-native):
    Document.
    (storage pool commands): New section.