Re: [Qemu-devel] [PATCH] Add backing file option to qemu-img create help.

[Eric Blake]

On 05/12/2014 09:13 AM, Kevin Wolf wrote:
> Am 12.05.2014 um 17:05 hat Eric Blake geschrieben:
>> On 05/12/2014 06:35 AM, Mike Day wrote:
>>> For the create subcommand the backing file (-b) option is documented
>>> on-line but not in the binary. Add it.

Online where?  In 'qemu-img --help', or on some web page (at what URL)?

>> is -o considered to be preferred over -b, as an explanation for why it
>> is not documented?
> 
> Yes, it is. -b was documented before -o backing_file existed. Commit
> 8063d0fe removed it.

If anything, that says we need to fix whatever "documented on-line"
source was documenting something that we want to be obsolete; and maybe
tweak qemu-img to be verbose about warning on the use of deprecated
options.  But this patch would go in the wrong direction of reviving
intentionally undocumented code.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

signature.asc
Description: OpenPGP digital signature