From patchwork Thu Feb 28 05:24:27 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Richard Henderson X-Patchwork-Id: 159309 Delivered-To: patch@linaro.org Received: by 2002:a02:5cc1:0:0:0:0:0 with SMTP id w62csp229087jad; Wed, 27 Feb 2019 21:25:26 -0800 (PST) X-Google-Smtp-Source: APXvYqye+ZuiG2WZrRdErmTNw1xbAVxbAMl7nU2Cs/CYQyHfQVrA9c3WiLO9QL6ik4bipAVba9Ew X-Received: by 2002:a25:e6c7:: with SMTP id d190mr728748ybh.296.1551331526084; Wed, 27 Feb 2019 21:25:26 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1551331526; cv=none; d=google.com; s=arc-20160816; b=Q+mbNEKYI7lRu8aDngufXV8zCAKM1ag91vDB7J+dPoUL6kZzglN3zBy5pwYxpVgmug aqvOkHH0Wfc3CCbBJD5/CpSHQSXtnvOjZRh4Pl1fCxGzstiJSa+llYAsKZGlEKX3FCEi XNH1SkPrDC3MQhRPMkhK13cY9zbvokBpg7xB3k3K/ZTgg07gpXTUs2wx1KhxuJ0XywdR VtnzQUtTfsvw/RPnPofYO+QpF7y8J5WHI8fVbe0NQTMZR77ctyQCW94XgcmOVFJOnBfh fPdoajSk0yIDxlKwX80iASLNhWhQPsCviA3ZZtN5NCBkzw0/gk0UQduLCo8ESv2FvgM4 QBgA== 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:subject:references:in-reply-to :message-id:date:to:from:dkim-signature; bh=bhUfeH7Y88x0TUB0opJCJd9CwNlMyBnOlAFYaYt2ezU=; b=C70UwryX52bdAY9ArVVt3aGJkT+V+hO7+55jHS1QkQ6V2PJeFCLxxem0cNBuyvtt9n CJV3t0K33iaqdiN6cwaIe0wO3hHx9e3IKZhhQ+W4IfD01Hi+SkAYwoEq1w+0mI9q6DVE 7Trztx2slyuWa613NuThVNWqp8HxZeQWHOIUJyVR7R3rTsgnbSqtCPwB70YfyEkOpC8c JOTElqNLu2+ut4zoUJffaFhBuo2ecOvTW9zJEBcuOOK6lj0JhmbQz50yRGhsOdxRjboW bu61+99fD0G+5dl3miI18p2frY0IJYzVnkU0WduPDQ3AFUs8PskRhj66ZxmfKvrbhlHb 4V9g== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=AyPBiZQ5; 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 e64si34871ybe.164.2019.02.27.21.25.26 for (version=TLS1 cipher=AES128-SHA bits=128/128); Wed, 27 Feb 2019 21:25:26 -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=AyPBiZQ5; 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]:60547 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gzECD-0005h9-Fl for patch@linaro.org; Thu, 28 Feb 2019 00:25:25 -0500 Received: from eggs.gnu.org ([209.51.188.92]:59623) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gzEBg-0005g2-8Y for qemu-devel@nongnu.org; Thu, 28 Feb 2019 00:24:53 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gzEBe-0003mp-8c for qemu-devel@nongnu.org; Thu, 28 Feb 2019 00:24:52 -0500 Received: from mail-pl1-x644.google.com ([2607:f8b0:4864:20::644]:42295) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gzEBc-0003ie-74 for qemu-devel@nongnu.org; Thu, 28 Feb 2019 00:24:50 -0500 Received: by mail-pl1-x644.google.com with SMTP id v11so3735235plg.9 for ; Wed, 27 Feb 2019 21:24:40 -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; bh=bhUfeH7Y88x0TUB0opJCJd9CwNlMyBnOlAFYaYt2ezU=; b=AyPBiZQ5OMa9X3JAZ+zA3rsSq67zV0M0WORdQUs0YtFwXi9y8SJTio0JP2SrUGrOWt AqpsM6XzIzW2Z2+qtBpM2wXMcCjP4zbBtoc1jsOqu9tZaT/axUJYaUlMpCuMWwSYvS4d Dh5L+BgKcE8ssZSJTL/C4gG7ZWR5knKwvSfeqkjFEAkqh5Q4u6GjNHFC1BgbsAgyApAb 9odfq5uMxHHsHkFPRyTv8cmFJ95TioOtsceTH9mypyZoEpbZ8rgpBLL3CHeJt4eGcZnl ZzW/Wn9ZwZiIDzOE1RHeEalEosLYj/y++vT0hHTJBoD7FiJAla4eW6fNhp8P8eRflUSG I8MQ== 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=bhUfeH7Y88x0TUB0opJCJd9CwNlMyBnOlAFYaYt2ezU=; b=mo4B8kJaTBWLYinyKwfqgQAzBZ4vsUrodczW9/q7NvBnGTiltipTwQ3kq/8Mt3KtWr 1gGjmubyN8kAmMpoJqjXMJj7uju6wCnXzrYhUOVAgZmNBYi2B+Q2XxwMVtaKGqyU8VHF SkCn271oX0SpQhpp0bk0FHl4kiRQTedxT7oJusnd16g+WAf6hv8Q15X2CTjITtUozAUH O0ik70qVSfJlClC2nDj+v60WkmGcpfylItET0GdGK7EJvbVoYVtEDdqi90/y3SRbRLDN JQOhk3YNkZZuVoRW89gp5hTF1z+HoBztYKWbkqBG6DRXGLPpGdQymZXmajBj9/xeDnPy 97Bw== X-Gm-Message-State: AHQUAuYvXpEv/mScK+Rco0FFx3SakGHk2Epy8ZShPaNckfig7aFdvhEx pb+L37kD1UqQc3Ers9ZgTqhRTsSgc4U= X-Received: by 2002:a17:902:9a43:: with SMTP id x3mr6007751plv.173.1551331479260; Wed, 27 Feb 2019 21:24:39 -0800 (PST) Received: from cloudburst.dc.rr.com (cpe-72-132-251-149.dc.res.rr.com. [72.132.251.149]) by smtp.gmail.com with ESMTPSA id u13sm32758371pfa.169.2019.02.27.21.24.38 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 27 Feb 2019 21:24:38 -0800 (PST) From: Richard Henderson To: qemu-devel@nongnu.org Date: Wed, 27 Feb 2019 21:24:27 -0800 Message-Id: <20190228052432.32571-4-richard.henderson@linaro.org> X-Mailer: git-send-email 2.17.2 In-Reply-To: <20190228052432.32571-1-richard.henderson@linaro.org> References: <20190228052432.32571-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::644 Subject: [Qemu-devel] [PATCH v2 3/8] 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: kbastian@mail.uni-paderborn.de, f4bug@amsat.org Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" Cc: Bastian Koppelmann Signed-off-by: Richard Henderson --- docs/devel/decodetree.rst | 7 +++++++ 1 file changed, 7 insertions(+) -- 2.17.2 Reviewed-by: Bastian Koppelmann 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