[PATCH v2] qemu-docs: Update options for graphical frontends

[PATCH v2] qemu-docs: Update options for graphical frontends

[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.

Resolves: https://gitlab.com/qemu-project/qemu/-/issues/2103
Signed-off-by: Yihuan Pan <xun794@gmail.com>
---
 docs/system/keys.rst.inc | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/system/keys.rst.inc b/docs/system/keys.rst.inc
index bd9b8e5f6f..2e2c97aa23 100644
--- a/docs/system/keys.rst.inc
+++ b/docs/system/keys.rst.inc
@@ -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
-- 
2.43.0

Re: [PATCH v2] qemu-docs: Update options for graphical frontends

[Michael Tokarev]

22.01.2024 07:22, Yihuan Pan wrote:
> 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

> Resolves: https://gitlab.com/qemu-project/qemu/-/issues/2103
> Signed-off-by: Yihuan Pan <xun794@gmail.com>
> ---
>   docs/system/keys.rst.inc | 11 ++++++-----
>   1 file changed, 6 insertions(+), 5 deletions(-)
> 
> diff --git a/docs/system/keys.rst.inc b/docs/system/keys.rst.inc
> index bd9b8e5f6f..2e2c97aa23 100644
> --- a/docs/system/keys.rst.inc
> +++ b/docs/system/keys.rst.inc
> @@ -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