[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [RFC PATCH] docs/system: add a gentle prompt for the complexity to c
From: |
John Snow |
Subject: |
Re: [RFC PATCH] docs/system: add a gentle prompt for the complexity to come |
Date: |
Wed, 3 Mar 2021 13:41:02 -0500 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.7.0 |
On 3/1/21 6:27 AM, Alex Bennée wrote:
We all know the QEMU command line can become a fiendishly complex
beast. Lets gently prepare our user for the horrors to come by
referencing where other example command lines can be found in the
manual.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
docs/system/quickstart.rst | 8 ++++++++
docs/system/targets.rst | 2 ++
2 files changed, 10 insertions(+)
diff --git a/docs/system/quickstart.rst b/docs/system/quickstart.rst
index 3a3acab5e7..3498c5a29f 100644
--- a/docs/system/quickstart.rst
+++ b/docs/system/quickstart.rst
@@ -11,3 +11,11 @@ Download and uncompress a PC hard disk image with Linux
installed (e.g.
|qemu_system| linux.img
Linux should boot and give you a prompt.
+
+Users should be aware the above example elides a lot of the complexity
+of setting up a VM with x86_64 specific defaults and an assumption the
"and assumes the ...", like Thomas says.
+first non switch argument is a PC compatible disk image with a boot
+sector. For non-x86 system where we emulate a broad range of machine
Either "For a non-x86 system ..." or "For non-x86 systems ..."
+types the command lines are generally more explicit in defining the
You need a comma between "machine types" and "the".
+machine and boot behaviour. You will find more example command lines
+in the :ref:`system-targets-ref` section of the manual.
Reviewed-by: John Snow <jsnow@redhat.com>