From nobody Fri Nov 14 21:04:51 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=1760191981; cv=none; d=zohomail.com; s=zohoarc; b=JASgd741H2ziV8dzEI4sniE4kbRLWjVNNR2zNKYzq/uGKHhABD9FvgliAfoKGbwL6OyXLzEhPnniSCjmnqLGQLUcPUp01RvhnDbaa1O3KtiBHcOPt/k0iyugzu8jJidrY9/BIjveZhY+z3OrhjnNzmQGnX9ZpZ+7ZwvCQrHY7XA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1760191981; 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=B5ZWjewinXo/K/HjDQn5HAJq81hht3Ab5gMBLFTb9ZCEAw65c3lGKK5e5w1/ER3J/xtNNAPOpSdZ3MvLfKXyFySUCwkgdz39uKH3S5agnv26BEboFwMGRZTlRTQxksqe2VoIrIQM3s123T+UWNUrRmXWIB5LOmNDhy+UqJwy/zw= 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 17601919815179.599770013208058; Sat, 11 Oct 2025 07:13:01 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v7aEC-0005Hf-Op; Sat, 11 Oct 2025 10:05:44 -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 1v7aE9-0005FM-P4 for qemu-devel@nongnu.org; Sat, 11 Oct 2025 10:05:41 -0400 Received: from forwardcorp1a.mail.yandex.net ([178.154.239.72]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v7aDt-0005dK-Or for qemu-devel@nongnu.org; Sat, 11 Oct 2025 10:05:40 -0400 Received: from mail-nwsmtp-smtp-corp-main-83.vla.yp-c.yandex.net (mail-nwsmtp-smtp-corp-main-83.vla.yp-c.yandex.net [IPv6:2a02:6b8:c2d:7394:0:640:5a8a:0]) by forwardcorp1a.mail.yandex.net (Yandex) with ESMTPS id D2B27C017E; Sat, 11 Oct 2025 17:04:59 +0300 (MSK) Received: from vsementsov-lin.. (unknown [2a02:6bf:8080:a4b::1:3c]) by mail-nwsmtp-smtp-corp-main-83.vla.yp-c.yandex.net (smtpcorp/Yandex) with ESMTPSA id h4NOTl1FrqM0-I3EOdt05; Sat, 11 Oct 2025 17:04:59 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex-team.ru; s=default; t=1760191499; bh=op/F/a+q5XtB4ZnnC6MhqsiuvWj4SvJ8ypU7mVjAOp8=; h=Message-ID:Date:In-Reply-To:Cc:Subject:References:To:From; b=WmVP6kUZWIkCsxU+HrQe2JzUgHoYDA5tvdrph8pYlig6Kt3E92BL8cu9oPUQRP3tW WAFY5aN3JnkDHvu+X61Rqrk12aI2XvTov8m6P0qrIe29imq2gUXbio15w6eYbTc3qA 5duWm0of8P8bod5WdZ6S6SH1CBvE8HgDBAzYAfAk= Authentication-Results: mail-nwsmtp-smtp-corp-main-83.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 v2 29/33] qapi/ui.json: docs: width=70 and two spaces between sentences Date: Sat, 11 Oct 2025 17:04:35 +0300 Message-ID: <20251011140441.297246-30-vsementsov@yandex-team.ru> X-Mailer: git-send-email 2.48.1 In-Reply-To: <20251011140441.297246-1-vsementsov@yandex-team.ru> References: <20251011140441.297246-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=178.154.239.72; envelope-from=vsementsov@yandex-team.ru; helo=forwardcorp1a.mail.yandex.net X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, T_SPF_TEMPERROR=0.01 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: 1760191985469158500 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