Skip to contentSkip to conversation

handling guest multiple displays

PATCH Superseded Dongwon Kim 3 participants 9 messages Jun 30, 2022 – Jul 6, 2022

v3 of 5 Superseded Latest is v5 →

lore
Share & tools
lore
#0 lore raw

v3 cover handling guest multiple displays

This patch seires is for adding some useful features for the guest os with multi-displays. First patch is to make all of guest displays visible when guest os is launched using "detach". Second patch is for providing a method to assign each guest display to specific physical monitor, which would be useful if someone wants to directly full-screen individual guest scanouts to host's physical displays.

Changes in v3:

* ui/gtk: a new array param monitor to specify the target

- Revised commit message
- Rewrote desription of the new parameter (Markus Armbruster)
- Replaced unnecessary 'for' loop with 'if' condition (Markus Armbruster)

Changes in v2:

* ui/gtk: detach VCS for additional guest displays

- check if the type of VC is GD_VC_GFX before qemu_console_is_graphic (Gerd Hoffman)
- vc[0] is always primary guest display so we won't need n_gfx_vcs (Gerd Hoffmann)
- making sure detached window's size same as original surface size (Daniel P. Berrangé)

Dongwon Kim (2):
ui/gtk: detach VCS for additional guest displays (v3) ui/gtk: a new array param monitor to specify the target displays (v3)

 qapi/ui.json    |  7 ++++++-
 qemu-options.hx |  2 +-
 ui/gtk.c        | 43 +++++++++++++++++++++++++++++++++++++++++--
 3 files changed, 48 insertions(+), 4 deletions(-)
Signature · 1 line
2.30.2
#1 lore raw

PATCH v3 1/3 ui/gtk: detach VCs for additional guest displays

Detaching any addtional guest displays in case multiple displays are assigned to the guest OS (e.g. max_outputs=n) so that all of them are visible upon lauching.

v2: - making sure type of VC is GD_VC_GFX before qemu_console_is_graphic
(Gerd Hoffman)
- vc[0] is always primary guest display so we won't need n_gfx_vcs (Gerd Hoffmann)
- making sure detached window's size same as original surface size (Daniel P. Berrangé)

Cc Daniel P. Berrangé <[email protected]>
Cc Markus Armbruster <[email protected]>
Cc Philippe Mathieu-Daudé <[email protected]>
Cc Paolo Bonzini <[email protected]>
Cc Gerd Hoffmann <[email protected]>
Cc Vivek Kasireddy <[email protected]>
---
 ui/gtk.c | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)
ui/gtk.c +12 -1
index 2a791dd2aa..e6878c3209 100644
@@ -1361,6 +1361,11 @@ static void gd_menu_untabify(GtkMenuItem *item, void *opaque)
 
         g_signal_connect(vc->window, "delete-event",
                          G_CALLBACK(gd_tab_window_close), vc);
+
+        gtk_window_set_default_size(GTK_WINDOW(vc->window),
+                                    surface_width(vc->gfx.ds),
+                                    surface_height(vc->gfx.ds));
+
         gtk_widget_show_all(vc->window);
 
         if (qemu_console_is_graphic(vc->gfx.dcl.con)) {
@@ -2311,6 +2316,7 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
     GtkDisplayState *s = g_malloc0(sizeof(*s));
     GdkDisplay *window_display;
     GtkIconTheme *theme;
+    int i;
     char *dir;
 
     if (!gtkinit) {
@@ -2381,7 +2387,12 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
     gtk_widget_set_sensitive(s->copy_item,
                              vc && vc->type == GD_VC_VTE);
 #endif
-
+    for (i = 1; i < s->nb_vcs; i++) {
+        if (vc->type == GD_VC_GFX &&
+            qemu_console_is_graphic(s->vc[i].gfx.dcl.con)) {
+            gtk_menu_item_activate(GTK_MENU_ITEM(s->untabify_item));
+        }
+    }
     if (opts->has_full_screen &&
         opts->full_screen) {
         gtk_menu_item_activate(GTK_MENU_ITEM(s->full_screen_item));
Signature · 1 line
2.30.2
#2 lore raw

Re: [PATCH v3 1/3] ui/gtk: detach VCs for additional guest displays

Quoted 10 lines · Dongwon Kim

Detaching any addtional guest displays in case multiple displays are assigned to the guest OS (e.g. max_outputs=n) so that all of them are visible upon lauching.

v2: - making sure type of VC is GD_VC_GFX before qemu_console_is_graphic
(Gerd Hoffman)
- vc[0] is always primary guest display so we won't need n_gfx_vcs (Gerd Hoffmann)
- making sure detached window's size same as original surface size (Daniel P. Berrangé)

Patch history ...

Quoted 8 lines
Cc Daniel P. Berrangé <[email protected]>
Cc Markus Armbruster <[email protected]>
Cc Philippe Mathieu-Daudé <[email protected]>
Cc Paolo Bonzini <[email protected]>
Cc Gerd Hoffmann <[email protected]>
Cc Vivek Kasireddy <[email protected]>

---

... goes here, so it doesn't end up in git. You can also keep it in the cover letter instead.

Quoted 2 lines
 ui/gtk.c | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)
#3 lore raw

PATCH v3 2/2 ui/gtk: a new array param monitor to specify the target displays

In reply to Dongwon Kim

New integer array parameter, 'monitor' is for specifying the target monitors where individual GTK windows are placed upon launching.

Monitor numbers in the array are associated with virtual consoles in the order of [VC0, VC1, VC2 ... VCn].

Every GTK window containing each VC will be placed in the region of corresponding monitors.

Usage: -display gtk,monitor.<id of VC>=<target monitor>,..

       ex)-display gtk,monitor.0=1,monitor.1=0

v3: - Revised commit message
- Rewrote desription of the new parameter (Markus Armbruster)
- Replaced unnecessary 'for' loop with 'if' condition (Markus Armbruster)

Cc Daniel P. Berrangé <[email protected]>
Cc Markus Armbruster <[email protected]>
Cc Philippe Mathieu-Daudé <[email protected]>
Cc Paolo Bonzini <[email protected]>
Cc Gerd Hoffmann <[email protected]>
Cc Vivek Kasireddy <[email protected]>
---
 qapi/ui.json    |  9 ++++++++-
 qemu-options.hx |  3 ++-
 ui/gtk.c        | 31 +++++++++++++++++++++++++++++--
 3 files changed, 39 insertions(+), 4 deletions(-)
qapi/ui.json +8 -1
index 413371d5e8..7b4c098bb4 100644
@@ -1195,12 +1195,19 @@
 #               assuming the guest will resize the display to match
 #               the window size then.  Otherwise it defaults to "off".
 #               Since 3.1
+# @monitor:     Array of numbers, each of which represents physical
+#               monitor where GTK window containing a given VC will be
+#               placed. Each monitor number in the array will be
+#               associated with a virtual-console starting from VC0.
+#
+#               since 7.1
 #
 # Since: 2.12
 ##
 { 'struct'  : 'DisplayGTK',
   'data'    : { '*grab-on-hover' : 'bool',
-                '*zoom-to-fit'   : 'bool'  } }
+                '*zoom-to-fit'   : 'bool',
+                '*monitor'       : ['uint16']  } }
 
 ##
 # @DisplayEGLHeadless:
qemu-options.hx +2 -1
index 377d22fbd8..aabdfb0636 100644
@@ -1938,7 +1938,8 @@ DEF("display", HAS_ARG, QEMU_OPTION_display,
 #endif
 #if defined(CONFIG_GTK)
     "-display gtk[,full-screen=on|off][,gl=on|off][,grab-on-hover=on|off]\n"
-    "            [,show-cursor=on|off][,window-close=on|off]\n"
+    "            [,monitor.<id of VC>=<monitor number>][,show-cursor=on|off]"
+    "            [,window-close=on|off]\n"
 #endif
 #if defined(CONFIG_VNC)
     "-display vnc=<display>[,<optargs>]\n"
ui/gtk.c +29 -2
index e6878c3209..935176e614 100644
@@ -2316,6 +2316,10 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
     GtkDisplayState *s = g_malloc0(sizeof(*s));
     GdkDisplay *window_display;
     GtkIconTheme *theme;
+    GtkWidget *win;
+    GdkRectangle dest;
+    uint16List *mon;
+    int n_mon;
     int i;
     char *dir;
 
@@ -2393,10 +2397,33 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
             gtk_menu_item_activate(GTK_MENU_ITEM(s->untabify_item));
         }
     }
-    if (opts->has_full_screen &&
-        opts->full_screen) {
+
+    if (opts->u.gtk.has_monitor) {
+        i = 0;
+        n_mon = gdk_display_get_n_monitors(window_display);
+        for (mon = opts->u.gtk.monitor; mon; mon = mon->next) {
+            if (mon->value < n_mon && i < s->nb_vcs) {
+                win = s->vc[i].window ? s->vc[i].window : s->window;
+                if (opts->has_full_screen && opts->full_screen) {
+                    gtk_window_fullscreen_on_monitor(
+                        GTK_WINDOW(win),
+                        gdk_display_get_default_screen(window_display),
+                        mon->value);
+                } else {
+                    gdk_monitor_get_geometry(
+                        gdk_display_get_monitor(window_display, mon->value),
+                        &dest);
+                    gtk_window_move(GTK_WINDOW(win),
+                                    dest.x, dest.y);
+                }
+                i++;
+            }
+        }
+    } else if (opts->has_full_screen &&
+               opts->full_screen) {
         gtk_menu_item_activate(GTK_MENU_ITEM(s->full_screen_item));
     }
+
     if (opts->u.gtk.has_grab_on_hover &&
         opts->u.gtk.grab_on_hover) {
         gtk_menu_item_activate(GTK_MENU_ITEM(s->grab_on_hover_item));
Signature · 1 line
2.20.1
#4 lore raw

Re: [PATCH v3 2/2] ui/gtk: a new array param monitor to specify the target displays

Quoted 9 lines · Dongwon Kim

New integer array parameter, 'monitor' is for specifying the target monitors where individual GTK windows are placed upon launching.

Monitor numbers in the array are associated with virtual consoles in the order of [VC0, VC1, VC2 ... VCn].

Every GTK window containing each VC will be placed in the region of corresponding monitors.

Quoted 7 lines

Usage: -display gtk,monitor.<id of VC>=<target monitor>,..

       ex)-display gtk,monitor.0=1,monitor.1=0

v3: - Revised commit message
- Rewrote desription of the new parameter (Markus Armbruster)
- Replaced unnecessary 'for' loop with 'if' condition (Markus Armbruster)

Again, patch history ...

Quoted 8 lines
Cc Daniel P. Berrangé <[email protected]>
Cc Markus Armbruster <[email protected]>
Cc Philippe Mathieu-Daudé <[email protected]>
Cc Paolo Bonzini <[email protected]>
Cc Gerd Hoffmann <[email protected]>
Cc Vivek Kasireddy <[email protected]>

---

... goes here.

Quoted 10 lines
 qapi/ui.json    |  9 ++++++++-
 qemu-options.hx |  3 ++-
 ui/gtk.c        | 31 +++++++++++++++++++++++++++++--
 3 files changed, 39 insertions(+), 4 deletions(-)
qapi/ui.json +0 -0
index 413371d5e8..7b4c098bb4 100644

qapi/ui.json line 1201

Quoted 7 lines
qapi/ui.json +4 -0
@@ -1195,12 +1195,19 @@
 #               assuming the guest will resize the display to match
 #               the window size then.  Otherwise it defaults to "off".
 #               Since 3.1
+# @monitor:     Array of numbers, each of which represents physical
+#               monitor where GTK window containing a given VC will be
+#               placed. Each monitor number in the array will be
+#               associated with a virtual-console starting from VC0.

Drop the hyphen in "virtual-console".

Is the term "virtual console" obvious? Gerd?

Quoted 62 lines
qapi/ui.json +4 -1
+#
+#               since 7.1
 #
 # Since: 2.12
 ##
 { 'struct'  : 'DisplayGTK',
   'data'    : { '*grab-on-hover' : 'bool',
-                '*zoom-to-fit'   : 'bool'  } }
+                '*zoom-to-fit'   : 'bool',
+                '*monitor'       : ['uint16']  } }
 
 ##
 # @DisplayEGLHeadless:
qemu-options.hx +2 -1
index 377d22fbd8..aabdfb0636 100644
@@ -1938,7 +1938,8 @@ DEF("display", HAS_ARG, QEMU_OPTION_display,
 #endif
 #if defined(CONFIG_GTK)
     "-display gtk[,full-screen=on|off][,gl=on|off][,grab-on-hover=on|off]\n"
-    "            [,show-cursor=on|off][,window-close=on|off]\n"
+    "            [,monitor.<id of VC>=<monitor number>][,show-cursor=on|off]"
+    "            [,window-close=on|off]\n"
 #endif
 #if defined(CONFIG_VNC)
     "-display vnc=<display>[,<optargs>]\n"
ui/gtk.c +18 -2
index e6878c3209..935176e614 100644
@@ -2316,6 +2316,10 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
     GtkDisplayState *s = g_malloc0(sizeof(*s));
     GdkDisplay *window_display;
     GtkIconTheme *theme;
+    GtkWidget *win;
+    GdkRectangle dest;
+    uint16List *mon;
+    int n_mon;
     int i;
     char *dir;
 
@@ -2393,10 +2397,33 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
             gtk_menu_item_activate(GTK_MENU_ITEM(s->untabify_item));
         }
     }
-    if (opts->has_full_screen &&
-        opts->full_screen) {
+
+    if (opts->u.gtk.has_monitor) {
+        i = 0;
+        n_mon = gdk_display_get_n_monitors(window_display);
+        for (mon = opts->u.gtk.monitor; mon; mon = mon->next) {
+            if (mon->value < n_mon && i < s->nb_vcs) {
+                win = s->vc[i].window ? s->vc[i].window : s->window;
+                if (opts->has_full_screen && opts->full_screen) {
+                    gtk_window_fullscreen_on_monitor(
+                        GTK_WINDOW(win),
+                        gdk_display_get_default_screen(window_display),
+                        mon->value);
+                } else {
+                    gdk_monitor_get_geometry(

ui/gtk.c static void gtk_display_init(DisplayState *ds, DisplayOptions *opts) · line 2423

Quoted 10 lines
ui/gtk.c +10 -0
+                        gdk_display_get_monitor(window_display, mon->value),
+                        &dest);
+                    gtk_window_move(GTK_WINDOW(win),
+                                    dest.x, dest.y);
+                }
+                i++;
+            }
+        }
+    } else if (opts->has_full_screen &&
+               opts->full_screen) {

I'd join these two lines, like

       } else if (opts->has_full_screen && opts->full_screen) {

or even exploit the fact that a opts->full_screen is false when absent

       } else if (opts->full_screen) {
Quoted 6 lines
ui/gtk.c +1 -0
         gtk_menu_item_activate(GTK_MENU_ITEM(s->full_screen_item));
     }
+
     if (opts->u.gtk.has_grab_on_hover &&
         opts->u.gtk.grab_on_hover) {
         gtk_menu_item_activate(GTK_MENU_ITEM(s->grab_on_hover_item));
#5 lore raw

Re: [PATCH v3 2/2] ui/gtk: a new array param monitor to specify the target displays

Hi,

Quoted 8 lines

qapi/ui.json line 1201

Quoted 4 lines
qapi/ui.json +4 -0
+# @monitor:     Array of numbers, each of which represents physical
+#               monitor where GTK window containing a given VC will be
+#               placed. Each monitor number in the array will be
+#               associated with a virtual-console starting from VC0.

Drop the hyphen in "virtual-console".

Is the term "virtual console" obvious? Gerd?

I think so, same term is used elsewhere too for the same concept.

take care,
Gerd

#6 lore raw

Re: [PATCH v3 2/2] ui/gtk: a new array param monitor to specify the target displays

Thanks, yeah, I will remove '-' and resubmitt the patch.

Quoted 16 lines · Gerd Hoffmann

Hi,

Quoted 8 lines

qapi/ui.json line 1201

Quoted 4 lines
qapi/ui.json +4 -0
+# @monitor:     Array of numbers, each of which represents physical
+#               monitor where GTK window containing a given VC will be
+#               placed. Each monitor number in the array will be
+#               associated with a virtual-console starting from VC0.

Drop the hyphen in "virtual-console".

Is the term "virtual console" obvious? Gerd?

I think so, same term is used elsewhere too for the same concept.

take care,
Gerd

#7 lore raw

Re: [PATCH v3 2/2] ui/gtk: a new array param monitor to specify the target displays

In reply to Markus Armbruster
Quoted 29 lines · Markus Armbruster
Quoted 9 lines · Dongwon Kim

New integer array parameter, 'monitor' is for specifying the target monitors where individual GTK windows are placed upon launching.

Monitor numbers in the array are associated with virtual consoles in the order of [VC0, VC1, VC2 ... VCn].

Every GTK window containing each VC will be placed in the region of corresponding monitors.

Quoted 7 lines

Usage: -display gtk,monitor.<id of VC>=<target monitor>,..

       ex)-display gtk,monitor.0=1,monitor.1=0

v3: - Revised commit message
- Rewrote desription of the new parameter (Markus Armbruster)
- Replaced unnecessary 'for' loop with 'if' condition (Markus Armbruster)

Again, patch history ...

Quoted 8 lines
Cc Daniel P. Berrangé <[email protected]>
Cc Markus Armbruster <[email protected]>
Cc Philippe Mathieu-Daudé <[email protected]>
Cc Paolo Bonzini <[email protected]>
Cc Gerd Hoffmann <[email protected]>
Cc Vivek Kasireddy <[email protected]>

---

Quoted 1 line

... goes here.

No problem moving down the version history but may I ask you if that is current rule? We don't want to include the history anymore in the git history?

And FYI, the cover letter has the whole history already. I guess I can simply remove the history from individual patches then?

Thanks!!

Quoted 21 lines
Quoted 11 lines
 qapi/ui.json    |  9 ++++++++-
 qemu-options.hx |  3 ++-
 ui/gtk.c        | 31 +++++++++++++++++++++++++++++--
 3 files changed, 39 insertions(+), 4 deletions(-)
qapi/ui.json +0 -0
index 413371d5e8..7b4c098bb4 100644

qapi/ui.json line 1201

Quoted 7 lines
qapi/ui.json +4 -0
@@ -1195,12 +1195,19 @@
 #               assuming the guest will resize the display to match
 #               the window size then.  Otherwise it defaults to "off".
 #               Since 3.1
+# @monitor:     Array of numbers, each of which represents physical
+#               monitor where GTK window containing a given VC will be
+#               placed. Each monitor number in the array will be
+#               associated with a virtual-console starting from VC0.

Drop the hyphen in "virtual-console".

Quoted 2 lines

Is the term "virtual console" obvious? Gerd?

I will do so.

Quoted 75 lines
Quoted 62 lines
qapi/ui.json +4 -1
+#
+#               since 7.1
 #
 # Since: 2.12
 ##
 { 'struct'  : 'DisplayGTK',
   'data'    : { '*grab-on-hover' : 'bool',
-                '*zoom-to-fit'   : 'bool'  } }
+                '*zoom-to-fit'   : 'bool',
+                '*monitor'       : ['uint16']  } }
 
 ##
 # @DisplayEGLHeadless:
qemu-options.hx +2 -1
index 377d22fbd8..aabdfb0636 100644
@@ -1938,7 +1938,8 @@ DEF("display", HAS_ARG, QEMU_OPTION_display,
 #endif
 #if defined(CONFIG_GTK)
     "-display gtk[,full-screen=on|off][,gl=on|off][,grab-on-hover=on|off]\n"
-    "            [,show-cursor=on|off][,window-close=on|off]\n"
+    "            [,monitor.<id of VC>=<monitor number>][,show-cursor=on|off]"
+    "            [,window-close=on|off]\n"
 #endif
 #if defined(CONFIG_VNC)
     "-display vnc=<display>[,<optargs>]\n"
ui/gtk.c +18 -2
index e6878c3209..935176e614 100644
@@ -2316,6 +2316,10 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
     GtkDisplayState *s = g_malloc0(sizeof(*s));
     GdkDisplay *window_display;
     GtkIconTheme *theme;
+    GtkWidget *win;
+    GdkRectangle dest;
+    uint16List *mon;
+    int n_mon;
     int i;
     char *dir;
 
@@ -2393,10 +2397,33 @@ static void gtk_display_init(DisplayState *ds, DisplayOptions *opts)
             gtk_menu_item_activate(GTK_MENU_ITEM(s->untabify_item));
         }
     }
-    if (opts->has_full_screen &&
-        opts->full_screen) {
+
+    if (opts->u.gtk.has_monitor) {
+        i = 0;
+        n_mon = gdk_display_get_n_monitors(window_display);
+        for (mon = opts->u.gtk.monitor; mon; mon = mon->next) {
+            if (mon->value < n_mon && i < s->nb_vcs) {
+                win = s->vc[i].window ? s->vc[i].window : s->window;
+                if (opts->has_full_screen && opts->full_screen) {
+                    gtk_window_fullscreen_on_monitor(
+                        GTK_WINDOW(win),
+                        gdk_display_get_default_screen(window_display),
+                        mon->value);
+                } else {
+                    gdk_monitor_get_geometry(

ui/gtk.c static void gtk_display_init(DisplayState *ds, DisplayOptions *opts) · line 2423

Quoted 10 lines
ui/gtk.c +10 -0
+                        gdk_display_get_monitor(window_display, mon->value),
+                        &dest);
+                    gtk_window_move(GTK_WINDOW(win),
+                                    dest.x, dest.y);
+                }
+                i++;
+            }
+        }
+    } else if (opts->has_full_screen &&
+               opts->full_screen) {

I'd join these two lines, like

Quoted 5 lines
       } else if (opts->has_full_screen && opts->full_screen) {

or even exploit the fact that a opts->full_screen is false when absent

       } else if (opts->full_screen) {

This is simpler. I will go with this.

Quoted 8 lines
Quoted 7 lines
ui/gtk.c +1 -0
         gtk_menu_item_activate(GTK_MENU_ITEM(s->full_screen_item));
     }
+
     if (opts->u.gtk.has_grab_on_hover &&
         opts->u.gtk.grab_on_hover) {
         gtk_menu_item_activate(GTK_MENU_ITEM(s->grab_on_hover_item));
#8 lore raw

Re: [PATCH v3 2/2] ui/gtk: a new array param monitor to specify the target displays

Quoted 31 lines · Dongwon Kim
Quoted 30 lines · Markus Armbruster
Quoted 9 lines · Dongwon Kim

New integer array parameter, 'monitor' is for specifying the target monitors where individual GTK windows are placed upon launching.

Monitor numbers in the array are associated with virtual consoles in the order of [VC0, VC1, VC2 ... VCn].

Every GTK window containing each VC will be placed in the region of corresponding monitors.

Quoted 7 lines

Usage: -display gtk,monitor.<id of VC>=<target monitor>,..

       ex)-display gtk,monitor.0=1,monitor.1=0

v3: - Revised commit message
- Rewrote desription of the new parameter (Markus Armbruster)
- Replaced unnecessary 'for' loop with 'if' condition (Markus Armbruster)

Again, patch history ...

Quoted 8 lines
Cc Daniel P. Berrangé <[email protected]>
Cc Markus Armbruster <[email protected]>
Cc Philippe Mathieu-Daudé <[email protected]>
Cc Paolo Bonzini <[email protected]>
Cc Gerd Hoffmann <[email protected]>
Cc Vivek Kasireddy <[email protected]>

---

Quoted 5 lines
Quoted 1 line

... goes here.

No problem moving down the version history but may I ask you if that is current rule? We don't want to include the history anymore in the git history?

Patch history is really valuable for reviewers, but once the patch is done, it's rarely interesting anymore, so we keep it out of Git.

Sometimes, bits of history are still useful to understand why the patch is done the way it is. Such bits should be worked into the commit message.

Don't:

v2: A replaced by B [J. Reviewer]

Do:

I initially tried A, but it turned out to be a bad idea because X, so I did B instead.

Makes sense?

Quoted 2 lines

And FYI, the cover letter has the whole history already. I guess I can simply remove the history from individual patches then?

I like to keep detailed history in the cover letter.

Others like to keep it in each patch.

Still others like to keep an overview in the cover letter and details in each patch.

All fine.

Quoted 23 lines

Thanks!!

Quoted 21 lines
Quoted 11 lines
 qapi/ui.json    |  9 ++++++++-
 qemu-options.hx |  3 ++-
 ui/gtk.c        | 31 +++++++++++++++++++++++++++++--
 3 files changed, 39 insertions(+), 4 deletions(-)
qapi/ui.json +0 -0
index 413371d5e8..7b4c098bb4 100644

qapi/ui.json line 1201

Quoted 7 lines
qapi/ui.json +4 -0
@@ -1195,12 +1195,19 @@
 #               assuming the guest will resize the display to match
 #               the window size then.  Otherwise it defaults to "off".
 #               Since 3.1
+# @monitor:     Array of numbers, each of which represents physical
+#               monitor where GTK window containing a given VC will be
+#               placed. Each monitor number in the array will be
+#               associated with a virtual-console starting from VC0.

Drop the hyphen in "virtual-console".

Quoted 4 lines
Quoted 2 lines

Is the term "virtual console" obvious? Gerd?

I will do so.

Replace it by space, of course.

[...]