From patchwork Sat Feb 15 11:41:32 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Markus Armbruster X-Patchwork-Id: 183545 Delivered-To: patch@linaro.org Received: by 2002:a92:1f12:0:0:0:0:0 with SMTP id i18csp2896196ile; Sat, 15 Feb 2020 03:45:04 -0800 (PST) X-Google-Smtp-Source: APXvYqzuzxkAJzwEkvZ9v+tVk85nDF2RKr/r+C9Te5YUHR9uShxQRfmeo6E2OoVIWRMTYDs8GXd7 X-Received: by 2002:ae9:e602:: with SMTP id z2mr6734974qkf.50.1581767104832; Sat, 15 Feb 2020 03:45:04 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1581767104; cv=none; d=google.com; s=arc-20160816; b=UhbEUNQZhb4gZdkzN+JNnPSJy3mWk6PsRRlFCm8QjNj2UR6HmnFNaX4G/7zriYJuu7 1t5nbSmpzw66c3z6EEJxOkEmNCt3tsHZZczzHXg1rpX+ZWD5BRoodgnpa+MokAcpUXvm 6W2YD+4bmbLQ5rmv3z4bMMKT4I+KNLWaLRxCIcoHcm7ZMWt4cxYWn55VX1p/Vb0LtQtk XdZNbf4Jx4QNDbYG4gcrG20QgnxzvDbjzYPpomVlgO4+XkqGy4CFqen8RkinUfzB63ax 7fRfJXTELee+jKZ7eLGvg0mAx2gcBhVWlhaGXuVj1dNMgJmc4maqTBFpvk7r9ARsXcYd cVOA== 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=bQVZIM30qVtywxVsKFvM36jgS73jo3ftZHSsOFgP4EY=; b=vjNlBUuJiZwPkQ6Qsj2Vx8uHe4eob/OrZMo21sVili6WvoF6PzsTZ6lo/EoZ5DTTIx 0KnvniQClsCPGvba2ebFY+eqeEomiNcyrqu1/7DkFsBMVGRoRJ9OLyJ4lp+eKVd2is5Y N4LFVzyt7PzmEyhl2RGXcdOkc26B9V04Pmb7G57rXhYT0SMnOLN96GCIWvsUbzQXBcZp DCre4FWZMfxWx1479ETyYMx94ANTIVc+87FvLsMPj1B2ZsPyJ98fFXNYegaJfHsv3/6m IvucjyURBK9wkeI0WDjphET9HLDUz7VkVqk7+wfYFHHsgU3+Z4h3LpY6ZA8hbzz3/jss tKTA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=O33frsGp; 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 n21si3886621qtp.21.2020.02.15.03.45.04 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 15 Feb 2020 03:45:04 -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=O33frsGp; 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]:50420 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j2vse-0002pG-8e for patch@linaro.org; Sat, 15 Feb 2020 06:45:04 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:49835) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j2vpU-0004dP-7n for qemu-devel@nongnu.org; Sat, 15 Feb 2020 06:41:49 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j2vpT-0006v6-4O for qemu-devel@nongnu.org; Sat, 15 Feb 2020 06:41:48 -0500 Received: from us-smtp-2.mimecast.com ([207.211.31.81]:34030 helo=us-smtp-delivery-1.mimecast.com) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1j2vpS-0006v1-W9 for qemu-devel@nongnu.org; Sat, 15 Feb 2020 06:41:47 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1581766906; 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=bQVZIM30qVtywxVsKFvM36jgS73jo3ftZHSsOFgP4EY=; b=O33frsGpnJD7L65tEFHt4zelPKjSqbfWpLKyrCiUoJAimCf94psZbdmIveFSzqx3sceDmX wcSxCVDL7CeDBcxBNaoUKdBDpz3u+iVWU3ckjhr9pfublWwOPeZV597x4DwC3UvcLnOfF7 Ksw052NDQYFZHdR1MgjjekMMWGFk3vQ= 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-343-US52eF4dOxKTXQnuyNpHOQ-1; Sat, 15 Feb 2020 06:41:41 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 87FDF800D4E; Sat, 15 Feb 2020 11:41:40 +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 D44AA5C12E; Sat, 15 Feb 2020 11:41:37 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 559161136368; Sat, 15 Feb 2020 12:41:33 +0100 (CET) From: Markus Armbruster To: qemu-devel@nongnu.org Subject: [PULL 17/18] qapi/migration.json: Replace _this_ with *this* Date: Sat, 15 Feb 2020 12:41:32 +0100 Message-Id: <20200215114133.15097-18-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.15 X-MC-Unique: US52eF4dOxKTXQnuyNpHOQ-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.81 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 , =?utf-8?q?Philippe_Mathieu-D?= =?utf-8?b?YXVkw6k=?= Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" From: Peter Maydell The MigrationInfo::setup-time documentation is the only place where we use _this_ inline markup for emphasis, commonly rendered in italics. We would like to switch the doc comments to rST format, but rST doesn't recognize that markup and emits literal underscores. Switch to *this* instead. Changes markup to strong emphasis with Texinfo, commonly rendered as bold. With rST, it will go right back to emphasis / italics. rST also uses **this** for strong (commonly rendered bold) where Texinfo uses *this*. We have one place in the doc comments which uses strong/bold markup, in qapi/introspect.json: Note: the QAPI schema is also used to help define *internal* When we switch to rST that will be rendered as emphasis / italics. Markus (who wrote that) thinks that using emphasis / italics there is an improvement, so we leave that markup alone. Signed-off-by: Peter Maydell Reviewed-by: Markus Armbruster Message-Id: <20200213175647.17628-18-peter.maydell@linaro.org> Reviewed-by: Philippe Mathieu-Daudé [Commit message tweaked] Signed-off-by: Markus Armbruster --- qapi/migration.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) -- 2.21.1 diff --git a/qapi/migration.json b/qapi/migration.json index 11033b7a8e..52f3429969 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -178,8 +178,8 @@ # expected downtime in milliseconds for the guest in last walk # of the dirty bitmap. (since 1.3) # -# @setup-time: amount of setup time in milliseconds _before_ the -# iterations begin but _after_ the QMP command is issued. This is designed +# @setup-time: amount of setup time in milliseconds *before* the +# iterations begin but *after* the QMP command is issued. This is designed # to provide an accounting of any activities (such as RDMA pinning) which # may be expensive, but do not actually occur during the iterative # migration rounds themselves. (since 1.6)