[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL v2 01/15] docs/system: add a gentle prompt for the complexity to c
From: |
Alex Bennée |
Subject: |
[PULL v2 01/15] docs/system: add a gentle prompt for the complexity to come |
Date: |
Wed, 10 Mar 2021 15:59:48 +0000 |
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>
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Reviewed-by: John Snow <jsnow@redhat.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Message-Id: <20210305092328.31792-3-alex.bennee@linaro.org>
diff --git a/docs/system/quickstart.rst b/docs/system/quickstart.rst
index 3a3acab5e7..681678c86e 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 assumes the
+first non switch argument is a PC compatible disk image with a boot
+sector. For a non-x86 system where we emulate a broad range of machine
+types, the command lines are generally more explicit in defining the
+machine and boot behaviour. You will find more example command lines
+in the :ref:`system-targets-ref` section of the manual.
diff --git a/docs/system/targets.rst b/docs/system/targets.rst
index 75ed1087fd..9dcd95dd84 100644
--- a/docs/system/targets.rst
+++ b/docs/system/targets.rst
@@ -1,3 +1,5 @@
+.. _system-targets-ref:
+
QEMU System Emulator Targets
============================
--
2.20.1
- [PULL v2 00/15] testing, docs, semihosting move and guest-loader, Alex Bennée, 2021/03/10
- [PULL v2 02/15] tests/docker: add a test-tcg for building then running check-tcg, Alex Bennée, 2021/03/10
- [PULL v2 01/15] docs/system: add a gentle prompt for the complexity to come,
Alex Bennée <=
- [PULL v2 03/15] gitlab-ci.yml: Allow custom # of parallel linkers, Alex Bennée, 2021/03/10
- [PULL v2 06/15] .editorconfig: update the automatic mode setting for Emacs, Alex Bennée, 2021/03/10
- [PULL v2 04/15] gitlab-ci.yml: Add jobs to test CFI flags, Alex Bennée, 2021/03/10
- [PULL v2 05/15] tests/docker: Use --arch-only when building Debian cross image, Alex Bennée, 2021/03/10
- [PULL v2 12/15] docs: add some documentation for the guest-loader, Alex Bennée, 2021/03/10
- [PULL v2 13/15] tests/avocado: add boot_xen tests, Alex Bennée, 2021/03/10
- [PULL v2 07/15] hw/board: promote fdt from ARM VirtMachineState to MachineState, Alex Bennée, 2021/03/10