From patchwork Tue Mar 12 17:03:25 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Richard Henderson X-Patchwork-Id: 160175 Delivered-To: patch@linaro.org Received: by 2002:a02:5cc1:0:0:0:0:0 with SMTP id w62csp13413231jad; Tue, 12 Mar 2019 11:16:30 -0700 (PDT) X-Google-Smtp-Source: APXvYqyz648+PWrTB0p7VNgOS+Tc+/MJdrAdRf/InyofnioVXwJGUQREnlICkf65DagD5cmSaBvH X-Received: by 2002:a25:750b:: with SMTP id q11mr32095381ybc.195.1552414590176; Tue, 12 Mar 2019 11:16:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1552414590; cv=none; d=google.com; s=arc-20160816; b=MzizqsvCkjNbdr0XVJGCSTNNsGK/BfdR7r4y024RToBWabqX4qY4dz6jupi5IOAmlK cTv9CDaQMosNoWlj8rplbczVP5yVyC1efhqvI7ZVVye4QJe3PwedT0uI3fWpqcXczFVD x2RnuuE1+fW+X0WokdlAjWTAaAocJOrOK/ca79nNTmQxwEK1ZTq6Ts0MW2fZ7IKeTlUx XG7/F2TwvLlRaAV1F1adIlGEBT4TmhyW9a5Mzb7Lxh2UCm0YDTf81zFI3rvyPLrZO92f UkUEh5UE5q2U8ixzPWl1UdA0YVM+V6Ua3rjyXcVcZdaSJLf97zZuLvg0lslO4EEEGLcM 3F6g== 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=2rJysuN4kOcM861oITn+8gqeEuwCTb6zNf90hFLC10A=; b=Hs0Qr6NmTCEpZxYJbAcYtdqOBrrjAxHoS0pdU5XG1uYWCtnC/h8QUwiueKE6JLKQEm ocPKFjSh93pr62fKIAXS0Y9IvvcuWQ4yYmtYHrmQoxMhazSPZ4KP9Q6v+knscpnOPPTE a0JM/6hLjnHdub+4CmFoYNs1UZCIMi0ZWcHYO/9pnHtKK46PHzqOWEz2tLwuUJdlK+VE +UO3n3w7JXMUcsDiEF4m0G+2w+Z4Yw7d2UMI3KE4wHJXtMrmvPriBos40OE3x2I5NdKf fVqDara0f2PYmFNkoihtohc49Es7Qs+i61ASdKGhuATtI4puJY9hf8BphH1i24mk444B yCCA== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b="P0/WRJYE"; 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 k4si5494155ywk.160.2019.03.12.11.16.30 for (version=TLS1 cipher=AES128-SHA bits=128/128); Tue, 12 Mar 2019 11:16:30 -0700 (PDT) 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="P0/WRJYE"; 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]:57181 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h3lwz-0005WE-IQ for patch@linaro.org; Tue, 12 Mar 2019 14:16:29 -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) 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-Received: by 2002:a62:ee0e:: with SMTP id e14mr39749171pfi.201.1552410220161; Tue, 12 Mar 2019 10:03:40 -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) 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+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