Re: [Qemu-devel] [PATCH] help: Update help to reflect that GTK is the default

[Markus Armbruster]

Paolo Bonzini <address@hidden> writes:

> On 27/07/2016 18:21, Colin Lord wrote:
>> Updates the messages displayed in the help option to reflect that GTK is
>> the default display, not SDL.
>> ---
>>  qemu-options.hx | 16 ++++++++++++----
>>  1 file changed, 12 insertions(+), 4 deletions(-)
>> 
>> diff --git a/qemu-options.hx b/qemu-options.hx
>> index 8e0d9a5..5bec1d3 100644
>> --- a/qemu-options.hx
>> +++ b/qemu-options.hx
>> @@ -967,7 +967,7 @@ DEF("nographic", 0, QEMU_OPTION_nographic,
>>  STEXI
>>  @item -nographic
>>  @findex -nographic
>> -Normally, QEMU uses SDL to display the VGA output. With this option,
>> +Normally, QEMU uses GTK to display the VGA output. With this option,
>
> IIRC SDL is the default if GTK is not enabled.  So perhaps "uses GTK or
> SDL"?
>
> Since you are at it, replace "the VGA output" with "output (such as
> graphics, console, and the QEMU monitor)"
>
>>  you can totally disable graphical output so that QEMU is a simple
>>  command line application. The emulated serial port is redirected on
>>  the console and muxed with the monitor (unless redirected elsewhere
>> @@ -977,12 +977,12 @@ the console and monitor.
>>  ETEXI
>>  
>>  DEF("curses", 0, QEMU_OPTION_curses,
>> -    "-curses         use a curses/ncurses interface instead of SDL\n",
>> +    "-curses         use a curses/ncurses interface instead of GTK\n",
>
> Remove "instead of GTK" altogether?
>
>>      QEMU_ARCH_ALL)
>>  STEXI
>>  @item -curses
>>  @findex -curses
>> -Normally, QEMU uses SDL to display the VGA output.  With this option,
>> +Normally, QEMU uses GTK to display the VGA output.  With this option,
>
> Same as above ("GTK or SDL").
>
>>  QEMU can display the VGA output when in text mode using a
>>  curses/ncurses interface.  Nothing is displayed in graphical mode.
>>  ETEXI
>> @@ -1034,6 +1034,14 @@ STEXI
>>  Enable SDL.
>>  ETEXI
>>  
>> +DEF("gtk", 0, QEMU_OPTION_gtk,
>> +    "-gtk            enable GTK (default)\n", QEMU_ARCH_ALL)
>> +STEXI
>> address@hidden -gtk
>> address@hidden -gtk
>> +Enable GTK.
>> +ETEXI
>
> We try to avoid adding new "-foo" options.  All of them invariably end
> up requiring some sort of suboption, which is why we have "-display" now.
>
>>  DEF("spice", HAS_ARG, QEMU_OPTION_spice,
>>      "-spice [port=port][,tls-port=secured-port][,x509-dir=<dir>]\n"
>>      "       [,x509-key-file=<file>][,x509-key-password=<file>]\n"
>> @@ -1228,7 +1236,7 @@ DEF("vnc", HAS_ARG, QEMU_OPTION_vnc ,
>>  STEXI
>>  @item -vnc @var{display}[,@var{option}[,@var{option}[,...]]]
>>  @findex -vnc
>> -Normally, QEMU uses SDL to display the VGA output.  With this option,
>> +Normally, QEMU uses GTK to display the VGA output.  With this option,
>
> Same as above ("GTK or SDL").
>
> Thanks,
>
> Paolo
>
>>  you can have QEMU listen on VNC display @var{display} and redirect the VGA
>>  display over the VNC session.  It is very useful to enable the usb
>>  tablet device when using this option (option @option{-usbdevice

Please have a look at 

From: Robert Ho <address@hidden>
Subject: [PATCH v2 1/1] Reorganize help output of '-display' option
Date: Tue, 26 Jul 2016 18:17:11 +0800
Message-Id: <address@hidden>