Skip to contentSkip to conversation

qemu-docs: Update options for graphical frontends

PATCH Applied Yihuan Pan 2 participants 2 messages Jan 22, 2024 – Jan 26, 2024

lore
Share & tools
lore

Yihuan Pan

author
#0 lore raw

PATCH v2 1/1 qemu-docs: Update options for graphical frontends

The command line options -ctrl-grab and -alt-grab have been removed in QEMU 7.1. Instead, use the -display sdl,grab-mod=<modifiers> option to specify the grab modifiers.

Resolves: https://gitlab.com/qemu-project/qemu/-/issues/2103

---
 docs/system/keys.rst.inc | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)
docs/system/keys.rst.inc +6 -5
index bd9b8e5f6f..2e2c97aa23 100644
@@ -1,8 +1,9 @@
-During the graphical emulation, you can use special key combinations to
-change modes. The default key mappings are shown below, but if you use
-``-alt-grab`` then the modifier is Ctrl-Alt-Shift (instead of Ctrl-Alt)
-and if you use ``-ctrl-grab`` then the modifier is the right Ctrl key
-(instead of Ctrl-Alt):
+During the graphical emulation, you can use special key combinations from
+the following table to change modes. By default the modifier is Ctrl-Alt
+(used in the table below) which can be changed with ``-display`` suboption
+``mod=`` where appropriate. For example, ``-display sdl,
+grab-mod=lshift-lctrl-lalt`` changes the modifier key to Ctrl-Alt-Shift,
+while ``-display sdl,grab-mod=rctrl`` changes it to the right Ctrl key.
 
 Ctrl-Alt-f
    Toggle full screen
Signature · 1 line
2.43.0
#1 lore raw
Quoted 3 lines · Yihuan Pan

The command line options -ctrl-grab and -alt-grab have been removed in QEMU 7.1. Instead, use the -display sdl,grab-mod=<modifiers> option to specify the grab modifiers.

Applied to trivial-patches, thanks!

/mjt

Quoted 25 lines

Resolves: https://gitlab.com/qemu-project/qemu/-/issues/2103

---
  docs/system/keys.rst.inc | 11 ++++++-----
  1 file changed, 6 insertions(+), 5 deletions(-)
docs/system/keys.rst.inc +6 -5
index bd9b8e5f6f..2e2c97aa23 100644
@@ -1,8 +1,9 @@
-During the graphical emulation, you can use special key combinations to
-change modes. The default key mappings are shown below, but if you use
-``-alt-grab`` then the modifier is Ctrl-Alt-Shift (instead of Ctrl-Alt)
-and if you use ``-ctrl-grab`` then the modifier is the right Ctrl key
-(instead of Ctrl-Alt):
+During the graphical emulation, you can use special key combinations from
+the following table to change modes. By default the modifier is Ctrl-Alt
+(used in the table below) which can be changed with ``-display`` suboption
+``mod=`` where appropriate. For example, ``-display sdl,
+grab-mod=lshift-lctrl-lalt`` changes the modifier key to Ctrl-Alt-Shift,
+while ``-display sdl,grab-mod=rctrl`` changes it to the right Ctrl key.
 
  Ctrl-Alt-f
     Toggle full screen