From patchwork Fri Sep 3 09:03:38 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Alex_Benn=C3=A9e?= X-Patchwork-Id: 506486 Delivered-To: patch@linaro.org Received: by 2002:a02:8629:0:0:0:0:0 with SMTP id e38csp829134jai; Fri, 3 Sep 2021 02:17:02 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxOWGj5DHfYk3elJ6QO5rgMDocT0D8w8U3qWbz1/y5gqjMlbhIhU/YMShJPa++/5n8nkXy8 X-Received: by 2002:aa7:cc02:: with SMTP id q2mr2926299edt.154.1630660622491; Fri, 03 Sep 2021 02:17:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1630660622; cv=none; d=google.com; s=arc-20160816; b=HECL/dFGZsrE/v6hlBnw5yOCMwiVPVfKxR1MApeBZh1yKjGhUn59Q0nXxEh33aaRSa qX+1MpWti0HNIfBrTxcYjDUkFqxhueYc6HNSH5KYOfH85TgJXoUqvWxK2fNooVjcrdhH V1f6kDLQWRkST3CKCY9glrftPyqxJUGdV3fFdOQzs+L+P3kZ1yLgV+PTAttVthhe/pgE WVqx6S/ticAvYIKxhNR35ktKh6ibdUVNQ0D8cTCxVMmhtB9YEXfh2gJTs57zCy4EEO01 3w8cdY81fUiuxBasZEHuVRTjxTC2Fda8qe02xw8KR/eA8N8YFTWDaKo2STMmQAa5VOSj mz6w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:errors-to:sender:list-subscribe:list-help :list-post:list-archive:list-unsubscribe:list-id:precedence:cc :mime-version:references:in-reply-to:message-id:date:subject:to:from :delivered-to; bh=z7c3CQhXYMZaS6qp/bjoVLss0w/WAp6ZgK2nwF/t3WI=; b=LeZ4TojY6mZSawWDNdf7PhoeVXMPFuNBp2yc6aafHYKOxh1R29xIxh54o5oS+Dh/mL ohNLNg+1GwicDi9P/rNGlAYNUfPCmmFYLVfybkNoljPKKr2JuVyfkKwLyLQ9kviI2Ul6 ItqkbpZSL13kEH6fw+B8eVz2FBFZ/Q3JE9i6W6vUX/AnvZ5DltJmeIyc6vsg5InIxf+d UNvirDXx0GEYn+bZBlFq3V4aY+asXC4piH3cEWJ9YePxAlRk/vfSHgmQex7WRu+6isO/ 7Tdfcp5USvEqoLmQzLIjnDKI4JQiaeoxLqWzBVpoLtSoeUFt/Olq4zfR0hTkpSsOAySx RJ2Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of libvir-list-bounces@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com. [170.10.133.124]) by mx.google.com with ESMTPS id du4si5228441ejc.696.2021.09.03.02.17.02 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 03 Sep 2021 02:17:02 -0700 (PDT) Received-SPF: pass (google.com: domain of libvir-list-bounces@redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of libvir-list-bounces@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org 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-114-QnZWHQo6MkCuBQ-iL3wr2Q-1; Fri, 03 Sep 2021 05:16:59 -0400 X-MC-Unique: QnZWHQo6MkCuBQ-iL3wr2Q-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 8EE168145E5; Fri, 3 Sep 2021 09:16:53 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 5884A5D9F0; Fri, 3 Sep 2021 09:16:52 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id EBBA61809C81; Fri, 3 Sep 2021 09:16:49 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 1839CHKX001322 for ; Fri, 3 Sep 2021 05:12:17 -0400 Received: by smtp.corp.redhat.com (Postfix) id 4FC4F19B336; Fri, 3 Sep 2021 09:12:17 +0000 (UTC) Delivered-To: libvir-list@redhat.com Received: from mimecast-mx02.redhat.com (mimecast01.extmail.prod.ext.rdu2.redhat.com [10.11.55.17]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 4A0E819A753 for ; Fri, 3 Sep 2021 09:12:14 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-1.mimecast.com [207.211.31.81]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 9B459866DF4 for ; Fri, 3 Sep 2021 09:12:14 +0000 (UTC) Received: from mail-wm1-f48.google.com (mail-wm1-f48.google.com [209.85.128.48]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-437-t9KuCgJwMZKfWeTgNnM07g-1; Fri, 03 Sep 2021 05:12:13 -0400 X-MC-Unique: t9KuCgJwMZKfWeTgNnM07g-1 Received: by mail-wm1-f48.google.com with SMTP id k20-20020a05600c0b5400b002e87ad6956eso3106484wmr.1 for ; Fri, 03 Sep 2021 02:12:12 -0700 (PDT) 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=z7c3CQhXYMZaS6qp/bjoVLss0w/WAp6ZgK2nwF/t3WI=; b=NpouNY38fhWNlhOkpPrhAeXaYBNeotTTGQ745x3Wi4LW+tlHmITD1h1sM7PI4dsCwP vQi/h1PpUiciLvH6YxyruFVbCkM64CNgKszzGndoNl+dZEJFnOdqnMTAjS1pGV80E0fh NH4ozIUXXWKTKy+0+eFYUty65k1ycNgK1ELJzLY9R4lchk2zrdvqv1/U0ilwVhAicMZ/ 9tjC6PS3Q3uWpC95vAt4apqoQYMpcPs/tD/GHPSdMwyfp2YU5FEVxjXf1qdsH6ancIDI his5paUpid2VAsWIcsjYgV+sxS7pQrbn5EyQlMMuNAEX/TWxun3gJBuRUOEBtAl9GknK Xtvw== X-Gm-Message-State: AOAM532nMrbCEoY47oIyHhGAM+LDNdH1oLWvNVTgy9i5kvP5pxca2thH lKLpUhqlYZPeC/2Bx7JMXBlfVg== X-Received: by 2002:a7b:c94f:: with SMTP id i15mr2276916wml.58.1630660331738; Fri, 03 Sep 2021 02:12:11 -0700 (PDT) Received: from zen.linaroharston ([51.148.130.216]) by smtp.gmail.com with ESMTPSA id x11sm4117905wro.83.2021.09.03.02.12.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Sep 2021 02:12:10 -0700 (PDT) Received: from zen.lan (localhost [127.0.0.1]) by zen.linaroharston (Postfix) with ESMTP id 8E1141FFB7; Fri, 3 Sep 2021 10:03:41 +0100 (BST) From: =?utf-8?q?Alex_Benn=C3=A9e?= To: peter.maydell@linaro.org Subject: [PULL 21/22] docs/deprecated: deprecate passing plugin args through `arg=` Date: Fri, 3 Sep 2021 10:03:38 +0100 Message-Id: <20210903090339.1074887-22-alex.bennee@linaro.org> In-Reply-To: <20210903090339.1074887-1-alex.bennee@linaro.org> References: <20210903090339.1074887-1-alex.bennee@linaro.org> MIME-Version: 1.0 X-Mimecast-Impersonation-Protect: Policy=CLT - Impersonation Protection Definition; Similar Internal Domain=false; Similar Monitored External Domain=false; Custom External Domain=false; Mimecast External Domain=false; Newly Observed Domain=false; Internal User Name=false; Custom Display Name List=false; Reply-to Address Mismatch=false; Targeted Threat Dictionary=false; Mimecast Threat Dictionary=false; Custom Threat Dictionary=false X-Scanned-By: MIMEDefang 2.79 on 10.11.54.5 X-loop: libvir-list@redhat.com Cc: "reviewer:Incompatible changes" , Mahmoud Mandour , =?utf-8?q?Alex_Benn=C3=A9e?= , qemu-devel@nongnu.org X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com From: Mahmoud Mandour Signed-off-by: Mahmoud Mandour Message-Id: <20210802134414.52037-1-ma.mandourr@gmail.com> Reviewed-by: Alex Bennée [AJB: fixed up move of deprecated.rst] Signed-off-by: Alex Bennée -- 2.30.2 diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst index 1e1a5e96ad..6e88a84bba 100644 --- a/docs/about/deprecated.rst +++ b/docs/about/deprecated.rst @@ -139,6 +139,18 @@ The ``-no-quit`` is a synonym for ``-display ...,window-close=off`` which should be used instead. +Plugin argument passing through ``arg=`` (since 6.1) +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +Passing TCG plugins arguments through ``arg=`` is redundant is makes the +command-line less readable, especially when the argument itself consist of a +name and a value, e.g. ``-plugin plugin_name,arg="arg_name=arg_value"``. +Therefore, the usage of ``arg`` is redundant. Single-word arguments are treated +as short-form boolean values, and passed to plugins as ``arg_name=on``. +However, short-form booleans are deprecated and full explicit ``arg_name=on`` +form is preferred. + + QEMU Machine Protocol (QMP) commands ------------------------------------