Re: [libvirt] Break up virsh man page into smaller sections?

2010-06-03 Thread Justin Clift
On 06/04/2010 10:29 AM, Daniel Veillard wrote: Honnestly, git does it that way and I hate that. The advantage of man is that it's text and you can search for verbs or descriptions which may correspond to the actions you're trying to accomplish. If you split it in a zillion man pages it's a zil

Re: [libvirt] Break up virsh man page into smaller sections?

2010-06-03 Thread Daniel Veillard
On Thu, Jun 03, 2010 at 03:24:33PM +1000, Justin Clift wrote: > Hi all, > > Looking at the virsh man page (tools/virsh.pod), it's getting pretty > unwieldy and hard to grok for end users. > > Wondering if it's worth breaking it up into sections? > > Maybe something similar to how git structures

[libvirt] Break up virsh man page into smaller sections?

2010-06-02 Thread Justin Clift
Hi all, Looking at the virsh man page (tools/virsh.pod), it's getting pretty unwieldy and hard to grok for end users. Wondering if it's worth breaking it up into sections? Maybe something similar to how git structures their man pages? ie. man virsh Giving an overview, the categories