From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Tue, 25 Apr 2023 16:55:41 +0000 (+0200)
Subject: man: add more info about qemu monitor
X-Git-Tag: v15~187^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F1513%2Fhead;p=thirdparty%2Fmkosi.git

man: add more info about qemu monitor

This is very hard to discover, but useful. Let's give the
users a hint.
---

diff --git a/man/mkosi.1 b/man/mkosi.1
index b3b226ae2..70b7d414a 100644
--- a/man/mkosi.1
+++ b/man/mkosi.1
@@ -1459,6 +1459,13 @@ fedora login: root (automatic login)
 .fi
 .PP
 The default is to boot with a text console only.
+In this mode, messages from the boot loader, the kernel, and systemd,
+and later the getty login prompt and shell all use the same terminal.
+It is possible to switch between the qemu console and monitor by
+pressing \f[V]Ctrl-a c\f[R].
+The qemu monitor may for example be used to inject special keys or shut
+down the machine quickly.
+.PP
 To boot with a graphical window, add \f[V]--qemu-qui\f[R]:
 .IP
 .nf
diff --git a/mkosi.md b/mkosi.md
index 8b07df451..59e7844eb 100644
--- a/mkosi.md
+++ b/mkosi.md
@@ -1387,6 +1387,13 @@ fedora login: root (automatic login)
 ```
 
 The default is to boot with a text console only.
+In this mode, messages from the boot loader, the kernel, and systemd,
+and later the getty login prompt and shell all use the same terminal.
+It is possible to switch between the qemu console and monitor
+by pressing `Ctrl-a c`.
+The qemu monitor may for example be used to inject special keys
+or shut down the machine quickly.
+
 To boot with a graphical window, add `--qemu-qui`:
 ```console
 $ mkosi -d fedora --qemu-gui qemu