* [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) @ 2023-02-03 14:52 Gaius Mulley 2023-02-03 15:28 ` Jakub Jelinek 2023-02-03 19:18 ` Gerald Pfeifer 0 siblings, 2 replies; 9+ messages in thread From: Gaius Mulley @ 2023-02-03 14:52 UTC (permalink / raw) To: gcc-patches; +Cc: richard.guenther, gerald Hello, 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. [I'm just about to git push fixes so that modula-2 builds html, info and pdf documentation into the standard directories.] regards, Gaius diff --git a/htdocs/gcc-13/changes.html b/htdocs/gcc-13/changes.html index 9ecd115c..fa13369f 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. 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> + <li><a href="https://gcc.gnu.org/onlinedocs/m2/Compiler-options.html"> + Compiler options</a>.</li> + <li>The <code><* noreturn *></code> attribute is supported.</li> + <li>Linking has been redesigned.</li> +</ul> + <!-- .................................................................. --> <!-- <h2 id="jit">libgccjit</h2> --> 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 ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-02-03 14:52 [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) Gaius Mulley @ 2023-02-03 15:28 ` Jakub Jelinek 2023-02-03 19:18 ` Gerald Pfeifer 1 sibling, 0 replies; 9+ messages in thread From: Jakub Jelinek @ 2023-02-03 15:28 UTC (permalink / raw) To: Gaius Mulley; +Cc: gcc-patches, richard.guenther, gerald On Fri, Feb 03, 2023 at 02:52:43PM +0000, Gaius Mulley via Gcc-patches wrote: > > Hello, > > 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. > > [I'm just about to git push fixes so that modula-2 builds html, info and > pdf documentation into the standard directories.] IMHO it should go also into the News section on the gcc.gnu.org page. If you look into https://gcc.gnu.org/news.html which contains older news, it contains also e.g. D addition entry. Jakub ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-02-03 14:52 [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) Gaius Mulley 2023-02-03 15:28 ` Jakub Jelinek @ 2023-02-03 19:18 ` Gerald Pfeifer 2023-02-06 11:05 ` Gaius Mulley 1 sibling, 1 reply; 9+ messages in thread From: Gerald Pfeifer @ 2023-02-03 19:18 UTC (permalink / raw) To: Gaius Mulley; +Cc: gcc-patches, Richard Guenther 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 ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-02-03 19:18 ` Gerald Pfeifer @ 2023-02-06 11:05 ` Gaius Mulley 2023-03-04 7:14 ` Gerald Pfeifer 0 siblings, 1 reply; 9+ messages in thread From: Gaius Mulley @ 2023-02-06 11:05 UTC (permalink / raw) To: Gerald Pfeifer; +Cc: gcc-patches, Richard Guenther, Jakub Jelinek 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 ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-02-06 11:05 ` Gaius Mulley @ 2023-03-04 7:14 ` Gerald Pfeifer 2023-03-06 11:40 ` Gaius Mulley 2023-03-15 22:51 ` Gerald Pfeifer 0 siblings, 2 replies; 9+ messages in thread From: Gerald Pfeifer @ 2023-03-04 7:14 UTC (permalink / raw) To: Gaius Mulley; +Cc: gcc-patches, Richard Guenther, Jakub Jelinek Hi Gaius, apologies, I thought you had pushed the updated patch and only now realized it's not in yet. Please look into the few bits below and then go ahead and push. On Mon, 6 Feb 2023, Gaius Mulley wrote: > * htdocs/frontends.html: An update to say the front end is now in > the development trunk. Here we'd usually simply say * frontends: The Modula-2 front end is now on the development trunk. skiping "An update to say", or at least "An update to" and the "htdocs/" port (and adding which front end). > * htdocs/gcc-13/changes.html: A description of which dialects are > supported and the user level front end changes so far. * gcc-13: Note which Modula-2 dialects are... > * htdocs/index.html: Proposed news entry. * index: Announce Modula-2 inclusion (or something like that). > * htdocs/onlinedocs/index.html: PDF, PS and HTML documentation > links. * onlinedocs: Add links to Modula-2 documentation > +The compiler is operational with GCC 10, GCC 11 GCC 12 (on ...GCC 11, and GCC 12... > +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> How about "It is mostly written in Modula-2 and includes..." to avoid repetition of "the front end"? Thank you, Gerald ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-03-04 7:14 ` Gerald Pfeifer @ 2023-03-06 11:40 ` Gaius Mulley 2023-03-15 22:51 ` Gerald Pfeifer 1 sibling, 0 replies; 9+ messages in thread From: Gaius Mulley @ 2023-03-06 11:40 UTC (permalink / raw) To: Gerald Pfeifer; +Cc: gcc-patches, Richard Guenther, Jakub Jelinek Gerald Pfeifer <gerald@pfeifer.com> writes: > Hi Gaius, > > apologies, I thought you had pushed the updated patch and only now > realized it's not in yet. > > Please look into the few bits below and then go ahead and push. > > On Mon, 6 Feb 2023, Gaius Mulley wrote: >> * htdocs/frontends.html: An update to say the front end is now in >> the development trunk. > > Here we'd usually simply say > > * frontends: The Modula-2 front end is now on the > development trunk. > > skiping "An update to say", or at least "An update to" and the "htdocs/" > port (and adding which front end). > >> * htdocs/gcc-13/changes.html: A description of which dialects are >> supported and the user level front end changes so far. > > * gcc-13: Note which Modula-2 dialects are... > >> * htdocs/index.html: Proposed news entry. > > * index: Announce Modula-2 inclusion > > (or something like that). > >> * htdocs/onlinedocs/index.html: PDF, PS and HTML documentation >> links. > * onlinedocs: Add links to Modula-2 documentation > > >> +The compiler is operational with GCC 10, GCC 11 GCC 12 (on > > ...GCC 11, and GCC 12... > >> +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> > > How about "It is mostly written in Modula-2 and includes..." to avoid > repetition of "the front end"? > > > Thank you, > Gerald Hi Gerald, no problem at all and many thanks for the advice. I'll push the changes shortly, regards, Gaius ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-03-04 7:14 ` Gerald Pfeifer 2023-03-06 11:40 ` Gaius Mulley @ 2023-03-15 22:51 ` Gerald Pfeifer 2023-03-16 4:40 ` Gaius Mulley 1 sibling, 1 reply; 9+ messages in thread From: Gerald Pfeifer @ 2023-03-15 22:51 UTC (permalink / raw) To: Gaius Mulley; +Cc: gcc-patches, Richard Guenther, Jakub Jelinek The patch is now in, alas all the GNU M2 manual links now point to non-existant locations. Does maintainer-scripts/update_web_docs_git require an update to cover Modula-2 and actually build the manual we are now linking to (or rather trying to)? Gerald ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-03-15 22:51 ` Gerald Pfeifer @ 2023-03-16 4:40 ` Gaius Mulley 2023-03-16 23:22 ` Gerald Pfeifer 0 siblings, 1 reply; 9+ messages in thread From: Gaius Mulley @ 2023-03-16 4:40 UTC (permalink / raw) To: Gerald Pfeifer; +Cc: gcc-patches, Richard Guenther, Jakub Jelinek Gerald Pfeifer <gerald@pfeifer.com> writes: > The patch is now in, alas all the GNU M2 manual links now point to > non-existant locations. > > Does maintainer-scripts/update_web_docs_git require an update to cover > Modula-2 and actually build the manual we are now linking to (or rather > trying to)? > > Gerald Apologies I was going to ask about these links. I've updated the m2 subtree with target documentation independent sections. Attached is a proposed patch for maintainer-scripts/update_web_docs_git feel free to apply or adapt in any way. regards, Gaius --->o--->o--->o--->o--->o--->o--->o--->o--->o--->o--->o--->o--->o--->o Add modula-2 documentation to be built Update the online documentation build script to include modula-2. maintainer-scripts/ChangeLog: * update_web_docs_git (MANUALS): Add gm2. Add include path for m2 target independent sections. diff --git a/maintainer-scripts/update_web_docs_git b/maintainer-scripts/update_web_docs_git index 1c6a993cafd..c678fc29155 100755 --- a/maintainer-scripts/update_web_docs_git +++ b/maintainer-scripts/update_web_docs_git @@ -24,6 +24,7 @@ MANUALS="cpp gdc gfortran gfc-internals + gm2 gnat_ugn gnat-style gnat_rm @@ -169,6 +170,9 @@ for file in $MANUALS; do includes="-I ${includedir} -I `dirname ${filename}`" if [ "$file" = "gnat_ugn" ]; then includes="$includes -I gcc/gcc/ada -I gcc/gcc/ada/doc/gnat_ugn" + elif [ "$file" = "gm2" ]; then + includes="$includes -I gcc/gcc/m2/target-independent" + includes="$includes -I gcc/gcc/m2/target-independent/m2" fi makeinfo --html --css-ref $CSS $includes -o ${file} ${filename} tar cf ${file}-html.tar ${file}/*.html ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) 2023-03-16 4:40 ` Gaius Mulley @ 2023-03-16 23:22 ` Gerald Pfeifer 0 siblings, 0 replies; 9+ messages in thread From: Gerald Pfeifer @ 2023-03-16 23:22 UTC (permalink / raw) To: Gaius Mulley; +Cc: gcc-patches, Richard Guenther, Jakub Jelinek On Thu, 16 Mar 2023, Gaius Mulley wrote: >> Does maintainer-scripts/update_web_docs_git require an update to cover >> Modula-2 and actually build the manual we are now linking to > Apologies I was going to ask about these links. I've updated the m2 > subtree with target documentation independent sections. Attached is a > proposed patch for maintainer-scripts/update_web_docs_git feel free to > apply or adapt in any way. I sorted the special casing alphabetically and pushed the updated patch below. Then I updated the script on gcc.gnu.org and did a testrun. Indeed Modula 2 manuals are now available below https://gcc.gnu.org/onlinedocs/ just the links from that page are off (referring to m2 instead of gm2). I'll fix that next. Gerald commit fa4d0ab533cc2bc9cb6f512b3d4bd0bbc01ee797 Author: Gaius Mulley <gaiusmod2@gmail.com> Date: Fri Mar 17 00:08:20 2023 +0100 maintainer-scripts: Add Modula-2 manual to update_web_docs_git maintainer-scripts/ChangeLog: * update_web_docs_git (MANUALS): Add gm2. Add include path for gm2 manual. diff --git a/maintainer-scripts/update_web_docs_git b/maintainer-scripts/update_web_docs_git index 1c6a993cafd..4bb4897bf35 100755 --- a/maintainer-scripts/update_web_docs_git +++ b/maintainer-scripts/update_web_docs_git @@ -24,6 +24,7 @@ MANUALS="cpp gdc gfortran gfc-internals + gm2 gnat_ugn gnat-style gnat_rm @@ -167,7 +168,10 @@ for file in $MANUALS; do filename=`find . -name ${file}.texi` if [ "${filename}" ]; then includes="-I ${includedir} -I `dirname ${filename}`" - if [ "$file" = "gnat_ugn" ]; then + if [ "$file" = "gm2" ]; then + includes="$includes -I gcc/gcc/m2/target-independent" + includes="$includes -I gcc/gcc/m2/target-independent/m2" + elif [ "$file" = "gnat_ugn" ]; then includes="$includes -I gcc/gcc/ada -I gcc/gcc/ada/doc/gnat_ugn" fi makeinfo --html --css-ref $CSS $includes -o ${file} ${filename} ^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2023-03-16 23:22 UTC | newest] Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2023-02-03 14:52 [wwwdocs] document modula-2 in gcc-13/changes.html (and index.html) Gaius Mulley 2023-02-03 15:28 ` Jakub Jelinek 2023-02-03 19:18 ` Gerald Pfeifer 2023-02-06 11:05 ` Gaius Mulley 2023-03-04 7:14 ` Gerald Pfeifer 2023-03-06 11:40 ` Gaius Mulley 2023-03-15 22:51 ` Gerald Pfeifer 2023-03-16 4:40 ` Gaius Mulley 2023-03-16 23:22 ` Gerald Pfeifer
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).