From patchwork Thu Feb 13 17:56:35 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Maydell X-Patchwork-Id: 183413 Delivered-To: patch@linaro.org Received: by 2002:a92:1f12:0:0:0:0:0 with SMTP id i18csp828899ile; Thu, 13 Feb 2020 10:05:32 -0800 (PST) X-Google-Smtp-Source: APXvYqyD5rykirWiHLKqjG2UAxIM/AYNhvH+gNsSJo/3jXpZGgO/zLGoLrxMVmR0jpoMz/7t8zUA X-Received: by 2002:a05:620a:9cc:: with SMTP id y12mr16668817qky.446.1581617132678; Thu, 13 Feb 2020 10:05:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1581617132; cv=none; d=google.com; s=arc-20160816; b=K605kt4yBxmpN0vfpmA/MbH5wkX2Zrgf4MSCx6NiioaZgsV5Zsr0gHQJZSxUFzMQ21 MBGyC55NP2RrPW91ea+NpHHej1m/q8x672o1uWEdM5T2SBrBTARIrb4hFzFVZMiUtkAM ng4t6olfomH+p/gcT5fawJrkNGFV5MFgpvNdxOg8JBgAnp5OaeJDMoV5dkVXb5RZDycb UJobF3gA3wXKPn25cKWsajhlvAOHXRGS80H2XmHAa06xS1/2XesX5VaU6cmutSZfmfot DOag0OOqT+tugvCyQHrW6yidglvkYKA5lWWayT0FOI+w21bP5aUm/uwIHHyVIE/XFWix 5LnA== 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=qPc42rOU+K2bcRl791RJcPWPfU6tbDmR/D/lgmu3rFs=; b=ABX7YLEcNmaHMfWmlS7+gobPl6vP/6a5uMNB8zWCc/Mu3YInDO67iCYvxa6VPXYRyP cZgydIzB1xRZFK5a0tYRuDcm30FAsG+1gk1fduM1IS3yS7dWrOHZi5yx7HpwBV1zU1Ec EMaAOH8FGTWOho8IhS9opL8TT6E/JDn3Xj4CuDSehK5y96gpAVKznrrtlRiuPwXkAqpN 3nCJaWTKhUts1BXpECcA28u2uxDNOEdSY3TZkrAbXwM8MCrAoMBVZ2F1eW2iRiTNLTL2 i2+okEKYWXyX4hXJ2rMdiOsyv96rvgIWzSXcIAfcTtnW2FdRtk3iRzYeA1A2uW6i7GV0 cL1Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=RHX3VCgO; 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 q15si1243725qvr.24.2020.02.13.10.05.32 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 13 Feb 2020 10:05:32 -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=RHX3VCgO; 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]:57284 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j2Irk-0003gE-6U for patch@linaro.org; Thu, 13 Feb 2020 13:05:32 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:34256) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j2Ijq-0000ix-5j for qemu-devel@nongnu.org; Thu, 13 Feb 2020 12:57:23 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j2Ijn-0002zk-SB for qemu-devel@nongnu.org; Thu, 13 Feb 2020 12:57:22 -0500 Received: from mail-wr1-x435.google.com ([2a00:1450:4864:20::435]:34410) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j2Ijn-0002vL-Ko for qemu-devel@nongnu.org; Thu, 13 Feb 2020 12:57:19 -0500 Received: by mail-wr1-x435.google.com with SMTP id n10so5872493wrm.1 for ; Thu, 13 Feb 2020 09:57:18 -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=qPc42rOU+K2bcRl791RJcPWPfU6tbDmR/D/lgmu3rFs=; b=RHX3VCgOjhNyk18lXE7UVhLw16go464p5KsFIKlYMwjq1hdnSq+sZrfjB7qj1bBE1e vyeWsf2H0UpvFFUItljZt0eoxGLMqwiJ4YR6Lv00VTnwNa/l36j1+ReKwA7cNBP4qLXM 5EEiqCLWsk03i5qG0wjlOIuYde5GaBYD50CBtlskHGa89aR9wyIT+EKRBRvgN3MhS/yQ FgyZqC2qVWeryZ+laHJOsMy5znWBlGxO0+E4KWt6I6J8NK+N/OuIsFtwnAjqqe4OK7nz FouCCI0LlOAlVAi38BeOHyrpQHpvcKtK3EzCwaHSwT9qPiGPpin30WUh3/p0uDJVhz2h Lq2g== 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=qPc42rOU+K2bcRl791RJcPWPfU6tbDmR/D/lgmu3rFs=; b=SKb5DaHrQGMtG9OF3Kf5j5pr/iORdTLE8eQnOd4Rv2ypMecfE07wgit4DL9i33Q6aj BTgAssXJ/qXt1W6panRiena57JSOLsXOfMPrkCG/brpMPJTpjqgGX/AsmkalRKhGRplX cBPRTkFp2ToTO+PzteBSAus5DEDjRYUednqk3IfJUN9GCppJ+TUdbnfQnTSrrMNUJAID XhubEuG9t5C9thG3oV8jQN6COabLVzF8cyAzeGdmRXzDqlVcsWUegvIjp2VV9JP1KDQt X3MQGtHw1fdPMH76dQp5ZYO7Qc8RlOViRbEAAD9vKCl6IQWR2ScwPgwkTUW6itPYerx6 jJwA== X-Gm-Message-State: APjAAAWcY5h9efKiAcIO8aTZ8is21hr92moBzjHgHi8xB5ojLW6AC+hL 68+0iPA99T6m0JWJv+VPH+BXqd5OqOE= X-Received: by 2002:adf:f606:: with SMTP id t6mr22828970wrp.304.1581616635653; Thu, 13 Feb 2020 09:57:15 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id p26sm3692913wmc.24.2020.02.13.09.57.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 13 Feb 2020 09:57:15 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PATCH v2 18/30] qapi: Delete all the "foo: dropped in n.n" notes Date: Thu, 13 Feb 2020 17:56:35 +0000 Message-Id: <20200213175647.17628-19-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200213175647.17628-1-peter.maydell@linaro.org> References: <20200213175647.17628-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::435 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" A handful of QAPI doc comments include lines like "ppcemb: dropped in 3.1". The doc comment parser will just put these into whatever the preceding section was; sometimes that's "Notes", and sometimes it's some random other section, as with "NetClientDriver" where the "'dump': dropped in 2.12" line ends up in the "Since:" section. This tends to render wrongly, more so in the upcoming rST generator, but sometimes even in the texinfo, as in the case of QKeyCode: ac_bookmarks since 2.10 altgr, altgr_r: dropped in 2.10 We now have a better place to tell users about deprecated and deleted functionality -- qemu-deprecated.texi. So just remove all these "dropped in" remarks entirely. Signed-off-by: Peter Maydell --- Perhaps qemu-deprecated.texi should be updated -- Markus said he'd look into that. So this patch is to some extent a placeholder to get these broken bits of doc comment out of the way. --- qapi/machine.json | 2 -- qapi/net.json | 4 ---- qapi/ui.json | 1 - 3 files changed, 7 deletions(-) -- 2.20.1 Reviewed-by: Markus Armbruster diff --git a/qapi/machine.json b/qapi/machine.json index 704b2b0fe31..6c11e3cf3a4 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -20,8 +20,6 @@ # prefix to produce the corresponding QEMU executable name. This # is true even for "qemu-system-x86_64". # -# ppcemb: dropped in 3.1 -# # Since: 3.0 ## { 'enum' : 'SysEmuTarget', diff --git a/qapi/net.json b/qapi/net.json index 80dcf0df06e..1cb9a7d782b 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -446,8 +446,6 @@ # Available netdev drivers. # # Since: 2.7 -# -# 'dump': dropped in 2.12 ## { 'enum': 'NetClientDriver', 'data': [ 'none', 'nic', 'user', 'tap', 'l2tpv3', 'socket', 'vde', @@ -493,8 +491,6 @@ # @opts: device type specific properties (legacy) # # Since: 1.2 -# -# 'vlan': dropped in 3.0 ## { 'struct': 'NetLegacy', 'data': { diff --git a/qapi/ui.json b/qapi/ui.json index 89126da395b..e16e98a060d 100644 --- a/qapi/ui.json +++ b/qapi/ui.json @@ -779,7 +779,6 @@ # @ac_forward: since 2.10 # @ac_refresh: since 2.10 # @ac_bookmarks: since 2.10 -# altgr, altgr_r: dropped in 2.10 # # @muhenkan: since 2.12 # @katakanahiragana: since 2.12