From patchwork Sat Feb 15 11:41:28 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Markus Armbruster X-Patchwork-Id: 183550 Delivered-To: patch@linaro.org Received: by 2002:a92:1f12:0:0:0:0:0 with SMTP id i18csp2899290ile; Sat, 15 Feb 2020 03:49:43 -0800 (PST) X-Google-Smtp-Source: APXvYqypVlfW/GTMBufcmepW43SVcMy4SlxI0XhpRN0OYy+rh51oKndAMbY/91DKb9UDFPfbjGOC X-Received: by 2002:a05:620a:988:: with SMTP id x8mr6331142qkx.466.1581767383890; Sat, 15 Feb 2020 03:49:43 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1581767383; cv=none; d=google.com; s=arc-20160816; b=Ruepb0T0XgmlF8DmisWI0Xo1BnkBnraO4BUwn1Iqsq/fAHVIyNiVIiiZ6CoP98RaTY WQjAxfllu7vc9op8EhKR/jA6I2PM7v9MMW1ilfsxm2Nl1flEC3uIhuMCUiNgbFoOBpND c/V5F5cqhCoVkATYG7gSe8axfSApFn2KBxy23wadXOQQDva5Ajp0eLJGsBVkuwdPkhWa ZjXfUZZiQ9iHTBshGAVe3fvBwhsFntN88QMhDnxtQzA/DL83XMEBQaFbonF0E4+jlseb yU1zr/4oy2PMgMG0xaHpQYiem75pxXz5Klyao0jntLxrCiKf8Kpt+II50XUMToqskZCT 28jw== 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=wtnEPYynrWU+bMWdGCx2jW0GtVOeOZ4Ars9PSwUa4pY=; b=rQ7S+npZ3q9rFEbw4f4uE58yq6Q9SvJEclwDSCHCteujCicFQ84n32Y+IBerHuN13E hZrKss0Uz7FlKWeVIUEoO/a0gZxxnWT+iJjaHp0z1dCZeRiXSClA9VdJvwqzo8Marlce G+Tc8RUnLF8RRcraIoAobGwuyWI8DVn0HQ0x4sq60CqAiY1+RRMvVUs7P2MOTy+PQvVZ scqRWewEyuHb8m28bQ+DpAshi2jI1Fr7+Nzmo4sqdwxNYiOGE1DINTlTKAczaK0SD0Ay EdJZ5uBfUt1N5peoJpiMcTheIF19xDTpqFmhaaYCIPZ72/PITYl0jvZGBgXdsNbHd1gH MWeA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b="bNL/uHBn"; 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=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id d190si4434194qkb.265.2020.02.15.03.49.43 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 15 Feb 2020 03:49:43 -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=pass header.i=@redhat.com header.s=mimecast20190719 header.b="bNL/uHBn"; 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=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: from localhost ([::1]:50484 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j2vx9-0001Zl-Fw for patch@linaro.org; Sat, 15 Feb 2020 06:49:43 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:49755) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j2vpR-0004Vw-5L for qemu-devel@nongnu.org; Sat, 15 Feb 2020 06:41:46 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j2vpQ-0006tK-0B for qemu-devel@nongnu.org; Sat, 15 Feb 2020 06:41:45 -0500 Received: from us-smtp-delivery-1.mimecast.com ([207.211.31.120]:57648 helo=us-smtp-1.mimecast.com) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1j2vpP-0006sw-Qt for qemu-devel@nongnu.org; Sat, 15 Feb 2020 06:41:43 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1581766903; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=wtnEPYynrWU+bMWdGCx2jW0GtVOeOZ4Ars9PSwUa4pY=; b=bNL/uHBnGsW1mSVThx7owdiUNP/7thIyCVJOIJ5AK2+wC+sLvJ/+30HizQMa4EP6kEwa4M EISFRIsJCxfdQGpE8qcjZgZK6smIKGAKAtzr44/Se5aXpDOg+9B1kqrgr4zcVWoO7DxLbZ duuRo+ewtllVCn5OJfEqEoR1EpdGVns= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-207-GLrNkpH5M_miRfSHhSEhTw-1; Sat, 15 Feb 2020 06:41:39 -0500 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id DFDB7107ACC7; Sat, 15 Feb 2020 11:41:37 +0000 (UTC) Received: from blackfin.pond.sub.org (ovpn-117-234.ams2.redhat.com [10.36.117.234]) by smtp.corp.redhat.com (Postfix) with ESMTPS id B002E60BE1; Sat, 15 Feb 2020 11:41:37 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 4870F1136361; Sat, 15 Feb 2020 12:41:33 +0100 (CET) From: Markus Armbruster To: qemu-devel@nongnu.org Subject: [PULL 13/18] qapi/ui.json: Put input-send-event body text in the right place Date: Sat, 15 Feb 2020 12:41:28 +0100 Message-Id: <20200215114133.15097-14-armbru@redhat.com> In-Reply-To: <20200215114133.15097-1-armbru@redhat.com> References: <20200215114133.15097-1-armbru@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-MC-Unique: GLrNkpH5M_miRfSHhSEhTw-1 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 207.211.31.120 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: Peter Maydell Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" From: Peter Maydell 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 Reviewed-by: Markus Armbruster Message-Id: <20200213175647.17628-12-peter.maydell@linaro.org> Signed-off-by: Markus Armbruster --- qapi/ui.json | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) -- 2.21.1 diff --git a/qapi/ui.json b/qapi/ui.json index ba873e1e29..e8b8b708c7 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