From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <SRS0=zs2y=7E=mentor.com=Sandra_Loosemore@sourceware.org>
Received: from esa2.mentor.iphmx.com (esa2.mentor.iphmx.com [68.232.141.98])
	by sourceware.org (Postfix) with ESMTPS id AE76F3858D1E
	for <gcc-patches@gcc.gnu.org>; Sun, 12 Mar 2023 01:37:07 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org AE76F3858D1E
Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com
X-IronPort-AV: E=Sophos;i="5.98,253,1673942400"; 
   d="scan'208";a="101255703"
Received: from orw-gwy-02-in.mentorg.com ([192.94.38.167])
  by esa2.mentor.iphmx.com with ESMTP; 11 Mar 2023 17:37:04 -0800
IronPort-SDR: d+6GLeN8MDAHYMBQbiL2wQIJcy8bvFhjUhmkzHD5dx0/TS8V9348euhIEhLUfZ6iVQO7WlGTYd
 0kYxQGBdI6xhdeTBV0W9jt4duCIwHHKtAqpX+yOIFOBG5/SYlHvlvLzHZQ4IJ6WH1+f/Pu3+0g
 +AE6WdCAf1MutXihYrKqR38kyG6QLZEZPewawqxhRu7S8fNT5fBXQyoQEjwAiSYz1aD29xyzf4
 nWCaq+GUEhBgicCsTuca2CyJskPgvzbr7AtYrIQ5qwO37WNP/NewNLJFAo3LtNasWGJM+Tcdeo
 2CM=
Message-ID: <81c02a97-bfca-08bd-b23b-d4f28c99824a@codesourcery.com>
Date: Sat, 11 Mar 2023 18:37:02 -0700
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.7.1
Subject: Re: [DOC PATCH] Document the VEC_PERM_EXPR tree code (and minor
 clean-ups).
Content-Language: en-US
To: Roger Sayle <roger@nextmovesoftware.com>, 'GCC Patches'
	<gcc-patches@gcc.gnu.org>
References: <000f01d938d8$00cdf7d0$0269e770$@nextmovesoftware.com>
From: Sandra Loosemore <sandra@codesourcery.com>
In-Reply-To: <000f01d938d8$00cdf7d0$0269e770$@nextmovesoftware.com>
Content-Type: text/plain; charset="UTF-8"; format=flowed
Content-Transfer-Encoding: 7bit
X-ClientProxiedBy: svr-orw-mbx-15.mgc.mentorg.com (147.34.90.215) To
 svr-orw-mbx-13.mgc.mentorg.com (147.34.90.213)
X-Spam-Status: No, score=-3.8 required=5.0 tests=BAYES_00,HEADER_FROM_DIFFERENT_DOMAINS,KAM_DMARC_STATUS,NICE_REPLY_A,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=no autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org
List-Id: <gcc-patches.gcc.gnu.org>

On 2/4/23 13:33, 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?
> 
> 
> 2023-02-04  Roger Sayle  <roger@nextmovesoftware.com>
> 
> gcc/ChangeLog
> 	* doc/generic.texi <Expression Trees>: Standardize capitalization
> 	of section titles from "Expression trees".
> 	<Language-dependent Trees>: Likewise standardize capitalization
> 	from "Language-dependent trees".
> 	<Constant expressions>: Capitalized from "Constant Expressions".
> 	<Vector Expressions>: Standardized section name from "Vectors".
> 	Document VEC_PERM_EXPR tree code.  Sort tree codes alphabetically.

Trying to catch up on old mail here....

IIUC the proposed VEC_PERM_EXPR wording was rejected on technical 
grounds.  I confess I know nothing about this, so I can't usefully 
suggest alternate wording myself.  :-(

The other changes look OK except that the correct capitalization would 
be "Language-Dependent Trees".

-Sandra