From nobody Fri Nov 14 21:05:00 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=yandex-team.ru ARC-Seal: i=1; a=rsa-sha256; t=1760192120; cv=none; d=zohomail.com; s=zohoarc; b=ELfLgcbjeKwHbAOFHuPYASjLQW0dq231duNA9ag2yLE1V9nWqpSDRyQ6MNSyVmsNJ1u3rCot7y0c/G8Q9pe+RtHkqCcRo2twCC/2z4ZqS/O66UUeIDG28woIuWx92flFrTwtAHif9GC7r7Ygbn2ZLe+DlIfwaJ6BYc7xXfgOosQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760192120; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; b=h/Dg5S/+p7Z6k8gDyftySajtCRXdJnarapc8ty9gBWs+Mvvs28HRtdnLgx62Pa1OHrSQjcVQfFr3+DO1rd7J6Fy2BNO+ajnB8KH/JnVgx3XP6l9/iYzHNznpsaJVCrWU0eo3njgUAJpyWDcrHF+UxYJpldQU62PsP6dWXx7vaW0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1760192120411407.52511648281427; Sat, 11 Oct 2025 07:15:20 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7a8X-0006Xp-8o; Sat, 11 Oct 2025 09:59:54 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a87-0006PA-8x for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:28 -0400 Received: from forwardcorp1a.mail.yandex.net ([2a02:6b8:c0e:500:1:45:d181:df01]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7a7k-0004np-SN for qemu-devel@nongnu.org; Sat, 11 Oct 2025 09:59:26 -0400 Received: from mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net (mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net [IPv6:2a02:6b8:c1f:3a87:0:640:845c:0]) by forwardcorp1a.mail.yandex.net (Yandex) with ESMTPS id A7FABC0198; Sat, 11 Oct 2025 16:58:25 +0300 (MSK) Received: from vsementsov-lin.. (unknown [2a02:6bf:8080:a4b::1:3c]) by mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net (smtpcorp/Yandex) with ESMTPSA id uvMPBZ1FEOs0-2nADVqBZ; Sat, 11 Oct 2025 16:58:25 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191105; bh=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=AX/qoVWMes11zaoUystNEGsACoHuRuwkD+J1CtlRiq89qC0woiyCugOPxVg0b46KU ptET/fsj6z+7yEZSeWbPQubToz9OMClbXnYU56X8al0xM9vF2lm9OWoewMrsNqa4Lw dcwDUVX1s66LGuy1v1078ZsBDQ/rWVv6qXGf0PVQ= Authentication-Results: mail-nwsmtp-smtp-corp-main-69.vla.yp-c.yandex.net; dkim=pass header.i=@yandex-team.ru From: Vladimir Sementsov-Ogievskiy To: armbru@redhat.com Cc: qemu-devel@nongnu.org, vsementsov@yandex-team.ru, eblake@redhat.com, =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= Subject: [PATCH 29/33] qapi/ui.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 16:57:37 +0300 Message-ID: <20251011135754.294521-57-vsementsov@yandex-team.ru> X-Mailer: git-send-email 2.48.1 In-Reply-To: <20251011135754.294521-1-vsementsov@yandex-team.ru> References: <20251011135754.294521-1-vsementsov@yandex-team.ru> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a02:6b8:c0e:500:1:45:d181:df01; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @yandex-team.ru) X-ZM-MESSAGEID: 1760192122478154100 Content-Type: text/plain; charset="utf-8" Signed-off-by: Vladimir Sementsov-Ogievskiy --- qapi/ui.json | 108 ++++++++++++++++++++++++++++++++------------------- 1 file changed, 67 insertions(+), 41 deletions(-) diff --git a/qapi/ui.json b/qapi/ui.json index 1b2f4a4769..ab64c6372a 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -87,8 +87,8 @@ # # .. qmp-example:: # -# -> { "execute": "set_password", "arguments": { "protocol": "vnc", -# "password": "secret" = } } +# -> { "execute": "set_password", +# "arguments": { "protocol": "vnc", "password": "secret" } } # <- { "return": {} } ## { 'command': 'set_password', 'boxed': true, 'data': 'SetPasswordOptions' } @@ -149,8 +149,8 @@ # # .. qmp-example:: # -# -> { "execute": "expire_password", "arguments": { "protocol": "vnc", -# "time": "+60" } } +# -> { "execute": "expire_password", +# "arguments": { "protocol": "vnc", "time": "+60" } } # <- { "return": {} } ## { 'command': 'expire_password', 'boxed': true, 'data': 'ExpirePasswordOpti= ons' } @@ -381,11 +381,14 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 388707}, +# <- { "timestamp": { "seconds": 1290688046, +# "microseconds": 388707}, # "event": "SPICE_CONNECTED", # "data": { -# "server": { "port": "5920", "family": "ipv4", "host": "127.0.= 0.1"}, -# "client": {"port": "52873", "family": "ipv4", "host": "127.0.= 0.1"} +# "server": { "port": "5920", "family": "ipv4", +# "host": "127.0.0.1" }, +# "client": { "port": "52873", "family": "ipv4", +# "host": "127.0.0.1" } # }} ## { 'event': 'SPICE_CONNECTED', @@ -407,13 +410,16 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 417172}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 417172}, # "event": "SPICE_INITIALIZED", # "data": {"server": {"auth": "spice", "port": "5921", # "family": "ipv4", "host": "127.0.0.1"}, -# "client": {"port": "49004", "family": "ipv4", "channel= -type": 3, -# "connection-id": 1804289383, "host": "127.0= .0.1", -# "channel-id": 0, "tls": true} +# "client": { "port": "49004", "family": "ipv4", +# "channel-type": 3, +# "connection-id": 1804289383, +# "host": "127.0.0.1", +# "channel-id": 0, "tls": true} # }} ## { 'event': 'SPICE_INITIALIZED', @@ -434,11 +440,14 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 388707}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 388707}, # "event": "SPICE_DISCONNECTED", # "data": { -# "server": { "port": "5920", "family": "ipv4", "host": "127.0.= 0.1"}, -# "client": {"port": "52873", "family": "ipv4", "host": "127.0.= 0.1"} +# "server": { "port": "5920", "family": "ipv4", +# "host": "127.0.0.1"}, +# "client": { "port": "52873", "family": "ipv4", +# "host": "127.0.0.1"} # }} ## { 'event': 'SPICE_DISCONNECTED', @@ -455,7 +464,8 @@ # # .. qmp-example:: # -# <- { "timestamp": {"seconds": 1290688046, "microseconds": 417172}, +# <- { "timestamp": {"seconds": 1290688046, +# "microseconds": 417172}, # "event": "SPICE_MIGRATE_COMPLETED" } ## { 'event': 'SPICE_MIGRATE_COMPLETED', @@ -727,11 +737,14 @@ # # <- { "event": "VNC_CONNECTED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, # "service": "5901", "host": "0.0.0.0" }, # "client": { "family": "ipv4", "service": "58425", -# "host": "127.0.0.1", "websocket": false } }, -# "timestamp": { "seconds": 1262976601, "microseconds": 975795 } } +# "host": "127.0.0.1", +# "websocket": false } }, +# "timestamp": { "seconds": 1262976601, +# "microseconds": 975795 } } ## { 'event': 'VNC_CONNECTED', 'data': { 'server': 'VncServerInfo', @@ -754,11 +767,15 @@ # # <- { "event": "VNC_INITIALIZED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, # "service": "5901", "host": "0.0.0.0"}, -# "client": { "family": "ipv4", "service": "46089", "websoc= ket": false, -# "host": "127.0.0.1", "sasl_username": "luiz" = } }, -# "timestamp": { "seconds": 1263475302, "microseconds": 150772 }= } +# "client": { "family": "ipv4", "service": "46089", +# "websocket": false, +# "host": "127.0.0.1", +# "sasl_username": "luiz" } }, +# "timestamp": { "seconds": 1263475302, +# "microseconds": 150772 } } ## { 'event': 'VNC_INITIALIZED', 'data': { 'server': 'VncServerInfo', @@ -780,11 +797,14 @@ # # <- { "event": "VNC_DISCONNECTED", # "data": { -# "server": { "auth": "sasl", "family": "ipv4", "websocket"= : false, -# "service": "5901", "host": "0.0.0.0" }, -# "client": { "family": "ipv4", "service": "58425", "websoc= ket": false, -# "host": "127.0.0.1", "sasl_username": "luiz" = } }, -# "timestamp": { "seconds": 1262976601, "microseconds": 975795 } } +# "server": { "auth": "sasl", "family": "ipv4", +# "websocket": false, "service": "5901", +# "host": "0.0.0.0" }, +# "client": { "family": "ipv4", "service": "58425", +# "websocket": false, "host": "127.0.0.1", +# "sasl_username": "luiz" } }, +# "timestamp": { "seconds": 1262976601, +# "microseconds": 975795 } } ## { 'event': 'VNC_DISCONNECTED', 'data': { 'server': 'VncServerInfo', @@ -1023,10 +1043,10 @@ # # Send keys to guest. # -# @keys: An array of `KeyValue` elements. All @KeyValues in this array -# are simultaneously sent to the guest. A `KeyValue`.number value -# is sent directly to the guest, while `KeyValue`.qcode must be a -# valid `QKeyCode` value +# @keys: An array of `KeyValue` elements. All @KeyValues in this +# array are simultaneously sent to the guest. A `KeyValue`.number +# value is sent directly to the guest, while `KeyValue`.qcode must +# be a valid `QKeyCode` value # # @hold-time: time to delay key up events, milliseconds. Defaults to # 100 @@ -1039,9 +1059,10 @@ # .. qmp-example:: # # -> { "execute": "send-key", -# "arguments": { "keys": [ { "type": "qcode", "data": "ctrl" }, -# { "type": "qcode", "data": "alt" }, -# { "type": "qcode", "data": "delete" } = ] } } +# "arguments": { "keys": [ +# { "type": "qcode", "data": "ctrl" }, +# { "type": "qcode", "data": "alt" }, +# { "type": "qcode", "data": "delete" } ] } } # <- { "return": {} } ## { 'command': 'send-key', @@ -1278,13 +1299,15 @@ # -> { "execute": "input-send-event", # "arguments": { "device": "video0", # "events": [ { "type": "btn", -# "data" : { "down": true, "button": "left" } } ] }= } +# "data" : { "down": true, +# "button": "left" } } ] } } # <- { "return": {} } # # -> { "execute": "input-send-event", # "arguments": { "device": "video0", # "events": [ { "type": "btn", -# "data" : { "down": false, "button": "left" } } ] = } } +# "data" : { "down": false, +# "button": "left" } } ] } } # <- { "return": {} } # # .. qmp-example:: @@ -1305,8 +1328,10 @@ # # -> { "execute": "input-send-event" , # "arguments": { "events": [ -# { "type": "abs", "data" : { "axis": "x", "value" : 20= 000 } }, -# { "type": "abs", "data" : { "axis": "y", "value" : 40= 0 } } ] } } +# { "type": "abs", +# "data" : { "axis": "x", "value" : 20000 } }, +# { "type": "abs", +# "data" : { "axis": "y", "value" : 400 } } ] } } # <- { "return": {} } ## { 'command': 'input-send-event', @@ -1335,10 +1360,11 @@ # @show-menubar: Display the main window menubar. Defaults to "on". # (Since 8.0) # -# @keep-aspect-ratio: Keep width/height aspect ratio of guest content when -# resizing host window. Defaults to "on". (Since 10.1) +# @keep-aspect-ratio: Keep width/height aspect ratio of guest content +# when resizing host window. Defaults to "on". (Since 10.1) # -# @scale: Set preferred scale of the display. Defaults to 1.0. (Since 10= .1) +# @scale: Set preferred scale of the display. Defaults to 1.0. +# (Since 10.1) # # Since: 2.12 ## --=20 2.48.1