Re: [libvirt] consistency of virsh help output

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Heya, I've a bit of re-shuffled original e-mail and for that I'm sorry. On 02/03/11 19:05, Eric Blake wrote: Patch is attached. I didn't say we should take one way or another; neither I've said I'm going to. I merely wanted to point out at differences, which I think, create a bit of confusion. As suggested in my hasty reply, perhaps we should have a vote or poll. It doesn't seem to be easy decision to me. This is domain of man pages and might be (the best) understood. But it's damn-o-damn long. And although we are way past 80 char terminals, I still tend to keep within this limit etc. :) When understood, it's ok. And the majority of virsh commands have this format; except 19; I would stick with it. I have nothing against either of these format, although this short one requires '<domain> -> [--domain] <string>' substitution and a bit of thinking :) I wouldn't make boolean/switches shorter though -> keep eg. [--print-xml] in Synopsis as it is. I'm still a bit confused about this part. :| I don't think Options part needs changes, although one could split params(domain) and booleans/switches(print-xml) aside. Regards, Zdenek - -- Zdenek Styblik Net/Linux admin OS TurnovFree.net email: stybla(a)turnovfree.net jabber: stybla(a)jabber.turnovfree.net