From patchwork Thu Mar 7 18:56:13 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Richard Henderson X-Patchwork-Id: 159914 Delivered-To: patch@linaro.org Received: by 2002:a02:5cc1:0:0:0:0:0 with SMTP id w62csp7802147jad; Thu, 7 Mar 2019 11:15:52 -0800 (PST) X-Google-Smtp-Source: APXvYqwFFKfBTjI1T0t7wVoU4sJnpY2EmBgJXT4cmiSboqDH08LeTAaA9t5/OjJNkDkJQkg99pD3 X-Received: by 2002:a81:62c4:: with SMTP id w187mr11324814ywb.106.1551986152305; Thu, 07 Mar 2019 11:15:52 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1551986152; cv=none; d=google.com; s=arc-20160816; b=uy4A3vi/GJDMRSpjxqyoaHq1wH5ojqBYjR/Tb0vi4ePe7vVTG3o9eGS4NbOSVXjQ2d p/RZ5jy6Pm+tmxe76t0nxCqRue5i2o0CBGYOGr5wv0NP1HQFCnzv3Slfss8PDsPS12rP 0mhCTdtSHOb1J2clhKV/9qLWsHq1LUct+M/iWX/1PlUCj9XDaOxjH9sizs67+pJhmb7A 2A4H+4xQsBmIaV3OLHUjmBajsmwcAi06E4kfo5+t+OqILwhKCRC2EiLk2W1nS3yjgnpM DwBVfILROKBP/KbLyN2uehwcfjioPb0jFFyp8zUgji05CrYQt0ye16mBOmu2zDMdOND1 p0cQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:references:in-reply-to :message-id:date:to:from:dkim-signature; bh=2rJysuN4kOcM861oITn+8gqeEuwCTb6zNf90hFLC10A=; b=qxazvDaqGxS2p1/QL4KlcFsYBlHTEWMQG0cwRClEastrFO8GTdSv7k3I39Oq9eSIt3 UOEauVPmp5Az3ffWU4z/fxwwghTZSEvcJLqFAytguaXI7n0/NKo+Owh5bvtNOEMMqmOm pq8HKAAGOBoPYmnQOskEVOffv46RrnMXkT4T/EDuAkcOUByEpFBzoR40XsQ7A9B3O1dm 9nGGAVAWS0d5nNEggLx7EliMnnWjM76N2RPktITigYSTpngMG88jYokguSJi9XXvN4E+ TN3DlvRx33lArapgjlAqljOTnRFCfvPmOS2/I/xvPHyKVWmvyeAeuNHrhVj56K4VFmKK V9kg== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=CF8ZRVOl; 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 k77si3218870ybk.468.2019.03.07.11.15.52 for (version=TLS1 cipher=AES128-SHA bits=128/128); Thu, 07 Mar 2019 11:15:52 -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=CF8ZRVOl; 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 ([127.0.0.1]:57852 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h1yUh-0000Un-PB for patch@linaro.org; Thu, 07 Mar 2019 14:15:51 -0500 Received: from eggs.gnu.org ([209.51.188.92]:36590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h1yBy-0001CJ-KF for qemu-devel@nongnu.org; Thu, 07 Mar 2019 13:56:31 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h1yBx-0002NT-PG for qemu-devel@nongnu.org; Thu, 07 Mar 2019 13:56:30 -0500 Received: from mail-pg1-x541.google.com ([2607:f8b0:4864:20::541]:33948) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h1yBx-0002MJ-HH for qemu-devel@nongnu.org; Thu, 07 Mar 2019 13:56:29 -0500 Received: by mail-pg1-x541.google.com with SMTP id i130so11979805pgd.1 for ; Thu, 07 Mar 2019 10:56:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references; bh=2rJysuN4kOcM861oITn+8gqeEuwCTb6zNf90hFLC10A=; b=CF8ZRVOlzQE7okwBZAEuw7VvlxKJJCdZWq+1vJGWseZnFIlyfXmDccsWLu3HRZTZBr rqL1U3lNt8QOlwpLM/YRxfrCMzJi8a2LeLCjnW9/w7tCScmkM9uZdqCIi8dv6VbEBlKR nVOgEICyK3AyGEYiqp2O/+sWoEswY/yUUs+C7YgDkGNaIEh6mt/Ax/V/+RoKG8+r8qlp SohIc7bfWCtVBpE7QcjCDs99LnxA5nKH347fyzP7bingBA/KTZK/QU33vy0KXlb2q0eW ORFlphJWU0zRniEVN8t33us80Kh+K6Mesv5DU13J+5hrhNNiOXnhwyQVOMp6jinySMzi +ugA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=2rJysuN4kOcM861oITn+8gqeEuwCTb6zNf90hFLC10A=; b=TUNAbH7eS6qT3dEUjPJBybb8JUlmvyNiZzcq8vQ881dvZk2Z8FUzo1SqooJxYDDB7h YefPhH0NUI7m0WfkP4+s/3MwHopg70DhZAs0CLpoWOeW9AujYJKL/flGzH52qh0caPKX Gn2YSvBggC1ymj6oyPvL8Xb7LOAHNtOmD+MKj8xqbS4Y00iafZH8u3LVNRXZnTnzei42 RIOYI+cvCOhFnETgkRTziwVaj7xJyYNo6+0FGJeLEr6aW4Lm5fyvTX6uNI6cU+VXupHX Cp4+MekKvXtRFqgT5S1K8C5HDv71LY9JBrA/OYKOg1i37CCj/FHtO7WgGIBF88pVPlBZ neOA== X-Gm-Message-State: APjAAAXSi/kwsqpciHumXhdHBO8pQfBdHanXed2xeG4BMsEvIyaCJYnU 7X18lX8LV71wNWkPklQtluWAzG3krCQ= X-Received: by 2002:a62:2008:: with SMTP id g8mr14005842pfg.121.1551984988152; Thu, 07 Mar 2019 10:56:28 -0800 (PST) Received: from cloudburst.twiddle.net (97-113-188-82.tukw.qwest.net. [97.113.188.82]) by smtp.gmail.com with ESMTPSA id g12sm8801973pgr.76.2019.03.07.10.56.27 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 07 Mar 2019 10:56:27 -0800 (PST) From: Richard Henderson To: qemu-devel@nongnu.org Date: Thu, 7 Mar 2019 10:56:13 -0800 Message-Id: <20190307185622.29026-4-richard.henderson@linaro.org> X-Mailer: git-send-email 2.17.2 In-Reply-To: <20190307185622.29026-1-richard.henderson@linaro.org> References: <20190307185622.29026-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::541 Subject: [Qemu-devel] [PATCH v3 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: , Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" Reviewed-by: Bastian Koppelmann Signed-off-by: Richard Henderson --- docs/devel/decodetree.rst | 7 +++++++ 1 file changed, 7 insertions(+) -- 2.17.2 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 arguments. If ``!extern`` is specified, the backing structure is assumed to have been already declared, typically via a second decoder. +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:: ®3 ra rb rc