From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <SRS0=iI1D=57=pfeifer.com=gerald@sourceware.org>
Received: from hamza.pair.com (hamza.pair.com [209.68.5.143])
	by sourceware.org (Postfix) with ESMTPS id 96CE23858D20
	for <gcc-patches@gcc.gnu.org>; Fri,  3 Feb 2023 19:19:00 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 96CE23858D20
Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=pfeifer.com
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=pfeifer.com
Received: from hamza.pair.com (localhost [127.0.0.1])
	by hamza.pair.com (Postfix) with ESMTP id 1596B33EE4;
	Fri,  3 Feb 2023 14:19:00 -0500 (EST)
Received: from [192.168.49.186] (unknown [94.107.234.206])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256)
	(No client certificate requested)
	by hamza.pair.com (Postfix) with ESMTPSA id 770C833EE3;
	Fri,  3 Feb 2023 14:18:59 -0500 (EST)
Date: Fri, 3 Feb 2023 20:18:57 +0100 (CET)
From: Gerald Pfeifer <gerald@pfeifer.com>
To: Gaius Mulley <gaiusmod2@gmail.com>
cc: gcc-patches@gcc.gnu.org, Richard Guenther <richard.guenther@gmail.com>
Subject: Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and
 index.html)
In-Reply-To: <87lelels1w.fsf@debian>
Message-ID: <8bb9f1fc-95e8-ebe4-3d87-b3ec28c99add@pfeifer.com>
References: <87lelels1w.fsf@debian>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
X-Scanned-By: mailmunge 3.10 on 209.68.5.143
X-Spam-Status: No, score=-3.6 required=5.0 tests=BAYES_00,KAM_DMARC_STATUS,KAM_SHORT,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: <gcc-patches.gcc.gnu.org>

On Fri, 3 Feb 2023, Gaius Mulley wrote:
> The following patch provides a summary of the modula-2 front end
> and also contains links to the online modula-2 documentation in
> index.html.

> +<h3 id="modula2">Modula-2</h3>
> +<ul>
> +  <li>Support for the language Modula-2 has been added.  The dialects
> +  supported are PIM2, PIM3, PIM4 and ISO/IEC 10514-1.  Also included
> +  are a complete set of ISO/IEC 10514-1 libraries and PIM
> +    libraries.</li>

I wonder whether we can this a bit more active. 

Maybe something like "This includes support for the ... dialects, a 
complete set of ...and ..."?

> +  <li><a href="https://gcc.gnu.org/onlinedocs/m2/Compiler-options.html">
> +      Compiler options</a>.</li>

Maybe put this in parenthesis since it's not an update as such and more 
relatives to the previous item?

> +  <li>Linking has been redesigned.</li>

What are we saying here? I.e., what is the change we are announcing? As a 
user, what might I notice? Why do I care?


The above are questions to possibly improve this for our users. Please 
adjust as you see fit, or push as is, if you prefer.


On a somewhat related note: This is definitely big enough to warrant an 
entry in the News section on our main page. :-)  Do you want to propose
something?

Gerald