From patchwork Thu Feb 6 17:30:22 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Maydell X-Patchwork-Id: 183115 Delivered-To: patch@linaro.org Received: by 2002:a92:1f12:0:0:0:0:0 with SMTP id i18csp1840767ile; Thu, 6 Feb 2020 09:41:07 -0800 (PST) X-Google-Smtp-Source: APXvYqwv5S4iWwonIE/x1+7d8q9zM0eNbU3rVKuu/1yRlKmPrfDnJ58fqXIQgQf3U0HoPTjgUrV5 X-Received: by 2002:a05:620a:1650:: with SMTP id c16mr3644728qko.346.1581010867112; Thu, 06 Feb 2020 09:41:07 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1581010867; cv=none; d=google.com; s=arc-20160816; b=reQ0i7c0dGk2O+rcXixhj+I+6TGQaI1C/BBip1eFCivF4qPS3X/I0rgNYO/TcmTJsz YYqMBPuZc4Thf16XoaT/EwXb0dZexTSiJZmK4fekXtN0ZD8UlmqxLfm3r0OftYf7jm2V kUYHy6gyq6dAGeLgjdAysNfSTTGkTGxNj4+lQc9juZo7fLykeWbYfjCwtcCQSqOuB2NF SN86hhRn7g9oEKUTplDhLSt4jGJwPBi9fdUSzZ/M87qrXW6XBlvwFmTH9nsUx9hMyjYn 459aKChIo86bXw6rkkquYtCpCNK4tJx7oXpMzvN9pnTYf1iGqOtlGsmbk6L2VwBlfOfo RIpw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:cc:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:to:from :dkim-signature; bh=5mUsQje4Vxn3HIOn4m+YirZWxx0e2UfwIWtWTCNnLRg=; b=iAAv88UoX8/05tVKlMT4RRzzpli+USdZ1Fvzeei1rt8Vn1LXvJvsZKd0ZNSXR9HKvz qo3Olff1DUoCaXtgbAwJVqWU9gaO/FMPUk4gb+T+UmQ/xV3/KnXjkNWrLLMmLX7Mj7gb L0yWMCM9+gGJRiHmAsAZGndBCF3pmQIHxBy9TSi9DKEoUuGmhpsOe0zCT7Ex+J4tgfo8 pK2NI3ThDzwuu7JFDU+vL0/xBmyMB26MG8g8qdt+HW5aHEW5UMWP2m2HxFi8kkRbj1nX C3oELjnbbC8WxIamVMyj1EKyqVmOmrYCK7eMi+Zf+ZCZBT32OdwsVQ/EvzyEQ15Z6Fia br1A== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=rG28sFKt; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id p5si1923906qkg.349.2020.02.06.09.41.07 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 06 Feb 2020 09:41:07 -0800 (PST) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=rG28sFKt; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([::1]:43548 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1izl9G-0005LZ-K4 for patch@linaro.org; Thu, 06 Feb 2020 12:41:06 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:43426) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1izkzo-0006fZ-4a for qemu-devel@nongnu.org; Thu, 06 Feb 2020 12:31:22 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1izkzl-0005gr-9z for qemu-devel@nongnu.org; Thu, 06 Feb 2020 12:31:18 -0500 Received: from mail-wm1-x32a.google.com ([2a00:1450:4864:20::32a]:38357) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1izkzl-0005d1-2O for qemu-devel@nongnu.org; Thu, 06 Feb 2020 12:31:17 -0500 Received: by mail-wm1-x32a.google.com with SMTP id a9so991717wmj.3 for ; Thu, 06 Feb 2020 09:31:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=5mUsQje4Vxn3HIOn4m+YirZWxx0e2UfwIWtWTCNnLRg=; b=rG28sFKteKvDW4C56gkPydRex38f6gwl7bRyHnqhUSQwUPImCALIN5j+ya7sRPfBdu SkCGgUmNtfWSgvfJngqJ6cQShrXQxzcPU0OztWTctjFILlszYgdbtW0exLXg2BqmBhdw RrKGIWKWGzd7uWIecdua1gRcClg99GmCgvyzgNZeoTLoSRrgmMEIB7+tADSRzMlkF50H biBWSqkOlziwl1cySXALBnNZtfl+wgtQGiJyhYFWe2u+hYzNM0tOun2YlkcP7pFibIFR WnE3vFVUG0Gg733Os3OWSFvFYWWUT+yKgZieQol/K6AyjvKyMDs2RFKWDlxeFbFI1zi3 D+Kg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=5mUsQje4Vxn3HIOn4m+YirZWxx0e2UfwIWtWTCNnLRg=; b=HRNOJo7ObggtSXkwdTmudvoRObtIrFU2aDj445TI4WiD8x7rpT75Zkgal2a2mWOt6f z50CC8LXk11s5YFHhZ+VWC9WvY0xTMjPMN+zGjwczBAId156z0tGpx/SCkZyAkRR4Afc Psg8y8Z7xglPuP8bwgEeQJGVTnyg9H3Y5lNBWxgnlZXkK4OMz+xJ2bHl4g6o1O1ByvPd KEfAhRyZHNK1mlAyUB9lvaMwwVuC5ARSb3wZo54AWtMvfU8lIk1X7DpmaCW8HgkGSIib QgStVhn5eaP7WL1fNynMMU6mAjz3qtyYXGMcyUgbXNsNNcvJAuPHWYSkE3TPbTnqeqZN 1T8A== X-Gm-Message-State: APjAAAVtvjGHbT1bSVm/oe5du0QPRspcquytijhiArI9MJKXvsz2TvWZ GLyUs+wxw35nZjp+eRr7gWNHeP4KlXo= X-Received: by 2002:a7b:c152:: with SMTP id z18mr5662343wmi.70.1581010275290; Thu, 06 Feb 2020 09:31:15 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id w15sm5204214wrs.80.2020.02.06.09.31.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Feb 2020 09:31:11 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PATCH 11/29] qapi/ui.json: Put input-send-event body text in the right place Date: Thu, 6 Feb 2020 17:30:22 +0000 Message-Id: <20200206173040.17337-12-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200206173040.17337-1-peter.maydell@linaro.org> References: <20200206173040.17337-1-peter.maydell@linaro.org> MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::32a X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: =?utf-8?q?Daniel_P=2E_Berrang=C3=A9?= , Markus Armbruster , Michael Roth , Stefan Hajnoczi , John Snow Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" In the doc comment for input-send-event, there is a multi-line chunk of text ("The @device...take precedence") which is intended to be the main body text describing the event. However it has been placed after the arguments and Returns: section, which means that the parser actually thinks that this text is part of the "Returns" section text. Move the body text up to the top so that the parser correctly classifies it as body. Signed-off-by: Peter Maydell --- qapi/ui.json | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) -- 2.20.1 Reviewed-by: Markus Armbruster diff --git a/qapi/ui.json b/qapi/ui.json index aced267a1e4..94a07318f55 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -949,13 +949,6 @@ # # Send input event(s) to guest. # -# @device: display device to send event(s) to. -# @head: head to send event(s) to, in case the -# display device supports multiple scanouts. -# @events: List of InputEvent union. -# -# Returns: Nothing on success. -# # The @device and @head parameters can be used to send the input event # to specific input devices in case (a) multiple input devices of the # same kind are added to the virtual machine and (b) you have @@ -967,6 +960,13 @@ # are admissible, but devices with input routing config take # precedence. # +# @device: display device to send event(s) to. +# @head: head to send event(s) to, in case the +# display device supports multiple scanouts. +# @events: List of InputEvent union. +# +# Returns: Nothing on success. +# # Since: 2.6 # # Note: The consoles are visible in the qom tree, under