From nobody Sun Nov 9 23:00:26 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zoho.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=linaro.org Return-Path: Received: from lists.gnu.org (209.51.188.17 [209.51.188.17]) by mx.zohomail.com with SMTPS id 1552414550467696.9257373781973; Tue, 12 Mar 2019 11:15:50 -0700 (PDT) Received: from localhost ([127.0.0.1]:57181 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h3lwE-0005WE-90 for importer@patchew.org; Tue, 12 Mar 2019 14:15:42 -0400 Received: from eggs.gnu.org ([209.51.188.92]:50688) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h3l3O-0005OA-Q0 for qemu-devel@nongnu.org; Tue, 12 Mar 2019 13:19:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h3koX-00019J-Tc for qemu-devel@nongnu.org; Tue, 12 Mar 2019 13:03:42 -0400 Received: from mail-pf1-x431.google.com ([2607:f8b0:4864:20::431]:44044) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h3koX-00018d-Kk for qemu-devel@nongnu.org; Tue, 12 Mar 2019 13:03:41 -0400 Received: by mail-pf1-x431.google.com with SMTP id a3so2248936pff.11 for ; Tue, 12 Mar 2019 10:03:41 -0700 (PDT) Received: from cloudburst.twiddle.net (97-113-188-82.tukw.qwest.net. [97.113.188.82]) by smtp.gmail.com with ESMTPSA id v22sm17514265pfa.49.2019.03.12.10.03.38 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 12 Mar 2019 10:03:39 -0700 (PDT) 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; bh=2rJysuN4kOcM861oITn+8gqeEuwCTb6zNf90hFLC10A=; b=P0/WRJYEhx5kprOn9I19vl7u+Ulwf9EnDATaTZKr6L57d4f5qxYOfPV+I5imE5B3/j viUAQhGzb0BBSEQdM8ukUoAcsSHlDyiCWdxEQiJGPwxAKJD9+7UPIzZAdRCwBRBTdKU/ 1BllBy1a6RLDVSuw/Oy20xW69MDpLpbdRZ/GFuAf0JBrkVAHt8+PUI3gQ73Dp3iLloii BQvd0PsClS1/gufx4xMLp35EcRZ9+7vYkraxK/M6v4x6b7Eh+p65VcpRnWalkgBkC7hS wi9IEhf6dX8v126jq/w9HZGs+S+0V0KlA2cxJg3x9UwUzcpFDJmnR1FLTRw2ExlM2fPZ 4rEQ== 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; bh=2rJysuN4kOcM861oITn+8gqeEuwCTb6zNf90hFLC10A=; b=P499Kjfc2npcWu1hqQ6vjZo/OBRV0msQi2Vj6qTlI2Y1FdC8LVxyCFMb/dCeVntK2I Pl9yeSpPbNikWGLLeiaGc96AM9an+ebTobiXb3x0k2GosMKo6uguwm9g9jAVDayC7Ctp der+dafPwbs4XKzqgStPsS2XK3psBAnIf6jxn1jWCXw8rn3N4ruYYo82p+mcBOWSe/gQ h+yi9YAtNpUDUBe9TTtTWMHmqq6klRcAGU6VEDr6oGq2OdLfdx6Tqd5O8w745OAB/a31 BQwIWT1FwQT7FS/VD1lxxxlLJujhEV8QAYcZA3QuqSDl2y8te6L1YfjqBMqJhgUW82nI Ftng== X-Gm-Message-State: APjAAAUfoubNuzDBWjYrBJCBGiKqJAnsKedyH0/NS1B8+c+2B9EzNH5/ 48pYlO+lQn0u748+ME3EsE9BuEWHEKY= X-Google-Smtp-Source: APXvYqzkZtYH+pIKv8lbBiyn6w4LAkrm07sVx7t5GAa16qc4FQB0lSC7adQN7kLzUiYhNMV9hOm1Xg== X-Received: by 2002:a62:ee0e:: with SMTP id e14mr39749171pfi.201.1552410220161; Tue, 12 Mar 2019 10:03:40 -0700 (PDT) From: Richard Henderson To: qemu-devel@nongnu.org Date: Tue, 12 Mar 2019 10:03:25 -0700 Message-Id: <20190312170334.14005-4-richard.henderson@linaro.org> X-Mailer: git-send-email 2.17.2 In-Reply-To: <20190312170334.14005-1-richard.henderson@linaro.org> References: <20190312170334.14005-1-richard.henderson@linaro.org> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::431 Subject: [Qemu-devel] [PULL 03/12] decodetree: Document the usefulness of argument sets X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: peter.maydell@linaro.org Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Reviewed-by: Bastian Koppelmann Signed-off-by: Richard Henderson --- docs/devel/decodetree.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/devel/decodetree.rst b/docs/devel/decodetree.rst index d9be30b2db..62cb7f687c 100644 --- a/docs/devel/decodetree.rst +++ b/docs/devel/decodetree.rst @@ -69,6 +69,13 @@ with each of the fields being one of the member argument= s. If ``!extern`` is specified, the backing structure is assumed to have been already declared, typically via a second decoder. =20 +Argument sets are useful when one wants to define helper functions +for the translator functions that can perform operations on a common +set of arguments. This can ensure, for instance, that the ``AND`` +pattern and the ``OR`` pattern put their operands into the same named +structure, so that a common ``gen_logic_insn`` may be able to handle +the operations common between the two. + Argument set examples:: =20 ®3 ra rb rc --=20 2.17.2