From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-lf1-x12b.google.com (mail-lf1-x12b.google.com [IPv6:2a00:1450:4864:20::12b]) by sourceware.org (Postfix) with ESMTPS id E105E3858CDB for ; Mon, 6 Feb 2023 07:10:52 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E105E3858CDB Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-lf1-x12b.google.com with SMTP id bi36so16301337lfb.8 for ; Sun, 05 Feb 2023 23:10:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=7dMe6oFE+PG3I9yhFCBENaiZ/m4eEGsuVB0O5Hjny4Q=; b=elEKYHsDJuRymzLoVL7ud21+3RS5D/RIP2HFGTFTu04YB8l+VQGoF9tJte3m/xJu7H s9bJpoCdxvgmv948ite7PNL0+o3SNCGVPmZwRWvDTIyYgc+v5A5mO7xPLuYm39i94WNy VPm/sM65f0yjk/GhBycfuM729Ji/30uivoi7irCCVGUNBUnMNJEPHwFV4trlTpQ2cXue FqF/aGFwLzfLPuS5NWG3WZ0UMNm8nTkiEP7QLtVuf3AYJqHRoxqjaT3a0ySLKYAT53oW Mnuu0kDimrba52+KCInriGfvHo9aoaK4v+8bcnB4LGbmsoUALOw7+l0TCE+34WiXifvN OPWQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=7dMe6oFE+PG3I9yhFCBENaiZ/m4eEGsuVB0O5Hjny4Q=; b=wU6DnC4sIixPUbjYJvzBt5/gL5LkWhAZGdeN3Hdpkfz4t/bMT+8rxF9IexPjpi4kbS VLSzA/Zl02Y2RbwcpYznPvESCIl1LRkcS5yR+hF2gHlVWP1n4w5I+PfJMpGBRV5j2Njy RkwLeEPW0AW8bX3rk5tDFN+Fl/kJicBK6svu6a/DTmsqJcxoeClB5O5Z1bKDdh4J2cg1 EOxxXGtXE5MSZO0vVR1T6RPiPnGHwyfrRe2RIoMW9ozZXfFcu5wu0HSLNL49znINEa1L qVy2BdLqHyTOBU1ZwBfyEQdxlXJuc4IyLNPjHJmuNLo1RyceEfp8u+23ahLQiXNG1dFM miGw== X-Gm-Message-State: AO0yUKXhjo/I1vc6QkX+CoQJinNbQbfOInS0Od4k3GRvGk2WEIweFbKg 2Zw0N6lRbnhk080Vdo2LHBGnj66T4iB03ZLv4rs= X-Google-Smtp-Source: AK7set9+y1PRigsiUPM4H+H2sb/7Rde9oKJOAXlUZpeFbGFULRx/mA0zjYT1IN1yVIbn2aMe8EDBF443J4BiYeuPC9E= X-Received: by 2002:ac2:5505:0:b0:4cb:6bcb:de45 with SMTP id j5-20020ac25505000000b004cb6bcbde45mr3478326lfk.272.1675667451067; Sun, 05 Feb 2023 23:10:51 -0800 (PST) MIME-Version: 1.0 References: <000f01d938d8$00cdf7d0$0269e770$@nextmovesoftware.com> In-Reply-To: <000f01d938d8$00cdf7d0$0269e770$@nextmovesoftware.com> From: Richard Biener Date: Mon, 6 Feb 2023 08:10:37 +0100 Message-ID: Subject: Re: [DOC PATCH] Document the VEC_PERM_EXPR tree code (and minor clean-ups). To: Roger Sayle , Richard Sandiford Cc: GCC Patches Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-1.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On Sat, Feb 4, 2023 at 9:35 PM Roger Sayle wrote: > > > This patch (primarily) documents the VEC_PERM_EXPR tree code in > generic.texi. For ease of review, it is provided below as a pair > of diffs. The first contains just the new text added to describe > VEC_PERM_EXPR, the second tidies up this part of the documentation > by sorting the tree codes into alphabetical order, and providing > consistent section naming/capitalization, so changing this section > from "Vectors" to "Vector Expressions" (matching the nearby > "Unary and Binary Expressions"). > > Tested with make pdf and make html on x86_64-pc-linux-gnu. > The reviewer(s) can decide whether to approve just the new content, > or the content+clean-up. Ok for mainline? +@item VEC_PERM_EXPR +This node represents a vector permute/blend operation. The three operands +must be vectors of the same number of elements. The first and second +operands must be vectors of the same type as the entire expression, this was recently relaxed for the case of constant permutes in which case the first and second operands only have to have the same element type as the result. See tree-cfg.cc:verify_gimple_assign_ternary. The following description will become a bit more awkward here and for rhs1/rhs2 with different number of elements the modulo interpretation doesn't hold - I believe we require in-bounds elements for constant permutes. Richard can probably clarify things here. Thanks, Richard. > > > 2023-02-04 Roger Sayle > > gcc/ChangeLog > * doc/generic.texi : Standardize capitalization > of section titles from "Expression trees". > : Likewise standardize capitalization > from "Language-dependent trees". > : Capitalized from "Constant Expressions". > : Standardized section name from "Vectors". > Document VEC_PERM_EXPR tree code. Sort tree codes alphabetically. > > > Thanks in advance, > Roger > -- >