Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-18 Thread Programmingkid
> On Aug 17, 2018, at 4:59 PM, Eric Blake wrote: > > On 08/17/2018 02:28 PM, Programmingkid wrote: > -o Used with a comma separated list of format specific options in a name=value format. Use "-o ?" for an overview of the options >>> >>>

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-17 Thread Eric Blake
On 08/17/2018 02:28 PM, Programmingkid wrote: -o Used with a comma separated list of format specific options in a name=value format. Use "-o ?" for an overview of the options Please spell that "-o help", not "-o ?". Otherwise, the user has to quote the ? to

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-17 Thread Programmingkid
> On Aug 17, 2018, at 9:44 AM, Eric Blake wrote: > > On 08/16/2018 08:27 PM, Programmingkid wrote: > >> I am by no means an expert at qemu-img. But I did try my best to create what >> I think should be the new output for qemu-img --help. This is just >> the text I plan on using in a future

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-17 Thread Eric Blake
On 08/16/2018 08:27 PM, Programmingkid wrote: I am by no means an expert at qemu-img. But I did try my best to create what I think should be the new output for qemu-img --help. This is just the text I plan on using in a future patch. It is easier to read right now than it will be in patch

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-16 Thread Programmingkid
> On Aug 14, 2018, at 4:40 AM, Kevin Wolf wrote: > > Am 13.08.2018 um 20:19 hat Eric Blake geschrieben: >> On 08/13/2018 11:56 AM, Max Reitz wrote: >>> >>> Ah, hm, so much for that. Hm... I don't quite know what to think of >>> this. It does indeed improve legibility. But the question is

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-14 Thread Programmingkid
> On Aug 14, 2018, at 8:55 AM, Eric Blake wrote: > > On 08/14/2018 03:40 AM, Kevin Wolf wrote: >>> And I've already expressed my opinion that it is already rather long, where >>> making it longer is not necessarily making it smarter. >> I think if we want to improve the help text, we should

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-14 Thread Eric Blake
On 08/14/2018 03:40 AM, Kevin Wolf wrote: And I've already expressed my opinion that it is already rather long, where making it longer is not necessarily making it smarter. I think if we want to improve the help text, we should split it up. $ qemu-img --help qemu-img version 2.12.94

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-14 Thread Kevin Wolf
Am 13.08.2018 um 20:19 hat Eric Blake geschrieben: > On 08/13/2018 11:56 AM, Max Reitz wrote: > > > > Ah, hm, so much for that. Hm... I don't quite know what to think of > > this. It does indeed improve legibility. But the question is whether > > --help should be as condensed as possible, and

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-13 Thread Eric Blake
On 08/13/2018 11:56 AM, Max Reitz wrote: Ah, hm, so much for that. Hm... I don't quite know what to think of this. It does indeed improve legibility. But the question is whether --help should be as condensed as possible, and if the user finds it hard to read, whether they should not just

Re: [Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-08-13 Thread Max Reitz
On 2018-07-30 23:22, John Arbuckle wrote: > When the user uses the --help option in qemu-img, the output for the commands > is very hard to read due to being so close to each other. With this patch the > help for the commands is double spaced making things easier to read. > > Signed-off-by:

[Qemu-block] [PATCH] qemu-img.c: increase spacing between commands in documentation

2018-07-30 Thread John Arbuckle
When the user uses the --help option in qemu-img, the output for the commands is very hard to read due to being so close to each other. With this patch the help for the commands is double spaced making things easier to read. Signed-off-by: John Arbuckle --- qemu-img.c | 2 +- 1 file changed,