On 07/30/2018 09:52 PM, John Arbuckle wrote:
Add an example on how to use the create command. I believe this will make
qemu-img easier to use.
Signed-off-by: John Arbuckle <programmingk...@gmail.com>
---
qemu-img-cmds.hx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/qemu-img-cmds.hx b/qemu-img-cmds.hx
index 69758fb6e8..92f7437944 100644
--- a/qemu-img-cmds.hx
+++ b/qemu-img-cmds.hx
@@ -50,7 +50,7 @@ STEXI
ETEXI
DEF("create", img_create,
- "create [--object objectdef] [-q] [-f fmt] [-b backing_file] [-F backing_fmt]
[-u] [-o options] filename [size]")
+ "create [--object objectdef] [-q] [-f fmt] [-b backing_file] [-F backing_fmt]
[-u] [-o options] filename [size]\nExample: qemu-img create -f qcow2 WindowsXP.qcow2
10G")
Making a long line longer. It would be worth using C string
concatenation and splitting this over two lines, at the \n.
Using the name WindowsXP.qcow2 as the guest is somewhat misleading (that
OS is proprietary, and quickly reaching the point of obsolescence from
its vendor - furthermore, qemu-img doesn't actually install an OS, but
rather creates a blank image for a later install process to utilize);
better would be a generic name that won't go out of date, such
'image.qcow2'.
STEXI
@item create [--object @var{objectdef}] [-q] [-f @var{fmt}] [-b
@var{backing_file}] [-F @var{backing_fmt}] [-u] [-o @var{options}]
@var{filename} [@var{size}]
ETEXI
--
Eric Blake, Principal Software Engineer
Red Hat, Inc. +1-919-301-3266
Virtualization: qemu.org | libvirt.org
