Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html)

[Gaius Mulley <gaiusmod2@gmail.com>]

Gerald Pfeifer <gerald@pfeifer.com> writes:

> 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?
>

Thanks for spotting this - agreed.

> 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

Ah yes thank you for the advice - here is an improved proposed patch
containing:

	* htdocs/frontends.html: An update to say the front end is now in
	the development trunk.
	* htdocs/gcc-13/changes.html: A description of which dialects are
	supported and the user level front end changes so far.
	* htdocs/index.html: Proposed news entry.
	* htdocs/onlinedocs/index.html: PDF, PS and HTML documentation
	links.

regards,
Gaius


diff --git a/htdocs/frontends.html b/htdocs/frontends.html
index 12af359b..75be4658 100644
--- a/htdocs/frontends.html
+++ b/htdocs/frontends.html
@@ -41,10 +41,10 @@ has a back end that generates assembler directly, using the GCC back end.</li>
 (at an early stage of development).</li>
 
 <li><a href="http://www.nongnu.org/gm2/">GNU Modula-2</a> implements
-the PIM2, PIM3, PIM4 and ISO dialects of the language.  The compiler
-is fully operational with GCC 10 and GCC 11 (on
-GNU/Linux x86 systems).  Work is in progress to move the front end to
-the GCC trunk.  The front end is mostly written in Modula-2 and it
+the ISO/IEC 10514-1, PIM2, PIM3 and PIM4 dialects of the language.
+The compiler is operational with GCC 10, GCC 11 GCC 12 (on
+GNU/Linux x86 systems).  The front end is now in the GCC development
+trunk (GCC 13).  The front end is mostly written in Modula-2 and it
 includes a bootstrap tool which translates Modula-2 into C/C++.</li>
 
 <li>Modula-3 (for links see <a
diff --git a/htdocs/gcc-13/changes.html b/htdocs/gcc-13/changes.html
index 9ecd115c..20453c92 100644
--- a/htdocs/gcc-13/changes.html
+++ b/htdocs/gcc-13/changes.html
@@ -283,6 +283,18 @@ a work-in-progress.</p>
 
 <!-- <h3 id="go">Go</h3> -->
 
+<h3 id="modula2">Modula-2</h3>
+<ul>
+  <li>Support for the language Modula-2 has been added.  This includes
+    support for the ISO/IEC 10514-1, PIM2, PIM3, PIM4 dialects
+    together with a complete set of ISO/IEC 10514-1 and PIM
+    libraries.</li>
+  <li>The <code><* noreturn *></code> attribute is supported
+    with the <code>-Wreturn-type</code>
+    <a href="https://gcc.gnu.org/onlinedocs/m2/Compiler-options.html">
+      option</a>.</li>
+</ul>
+
 <!-- .................................................................. -->
 <!-- <h2 id="jit">libgccjit</h2> -->
 
diff --git a/htdocs/index.html b/htdocs/index.html
index 80730c06..3d03ef46 100644
--- a/htdocs/index.html
+++ b/htdocs/index.html
@@ -61,6 +61,11 @@ mission statement</a>.</p>
   has been contributed to Compiler Explorer (aka godbolt.org) by Marc
   Poulhiès</dd>
 
+<dt><span><a href="gcc-13/changes.html#modula2">Modula-2 front end added</a></span>
+  <span class="date">[2022-12-14]</span></dt>
+<dd>The Modula-2 programming language front end has been added to GCC.
+  This front end was contributed by Gaius Mulley.</dd>
+
 <dt><span><a href="https://gcc.gnu.org/wiki/cauldron2022">GNU Tools Cauldron 2022</a></span>
     <span class="date">[2022-09-02]</span></dt>
     <dd>Prague, Czech Republic and online, September 16-18 2022</dd>
diff --git a/htdocs/onlinedocs/index.html b/htdocs/onlinedocs/index.html
index 343ff9f5..27a8a505 100644
--- a/htdocs/onlinedocs/index.html
+++ b/htdocs/onlinedocs/index.html
@@ -1647,6 +1647,12 @@ existing release.</p>
            href="https://gcc.gnu.org/onlinedocs/gdc.ps.gz">PostScript</a> or <a
            href="https://gcc.gnu.org/onlinedocs/gdc-html.tar.gz">an
            HTML tarball</a>)</li>
+    <li><a href="https://gcc.gnu.org/onlinedocs/m2/">GNU M2 Manual</a> (<a
+           href="https://gcc.gnu.org/onlinedocs/m2.pdf">also in
+           PDF</a> or <a
+           href="https://gcc.gnu.org/onlinedocs/m2.ps.gz">PostScript</a> or <a
+           href="https://gcc.gnu.org/onlinedocs/m2-html.tar.gz">an
+           HTML tarball</a>)</li>
     <li><a href="https://gcc.gnu.org/onlinedocs/libgomp/">GNU Offloading and
            Multi Processing Runtime Library Manual</a> (<a
            href="https://gcc.gnu.org/onlinedocs/libgomp.pdf">also in