public inbox for gcc-cvs-wwwdocs@sourceware.org
help / color / mirror / Atom feed
* gcc-wwwdocs branch master updated. 2e5b610bc77329bb2e1fdd3dff1efcd08b99b830
@ 2019-12-03 8:42 burnus
0 siblings, 0 replies; only message in thread
From: burnus @ 2019-12-03 8:42 UTC (permalink / raw)
To: gcc-cvs-wwwdocs
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 6228 bytes --]
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gcc-wwwdocs".
The branch, master has been updated
via 2e5b610bc77329bb2e1fdd3dff1efcd08b99b830 (commit)
from 77d900eae547f79868f34f5879ebaacf9c6cf07d (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 2e5b610bc77329bb2e1fdd3dff1efcd08b99b830
Author: Tobias Burnus <tobias@codesourcery.com>
Date: Tue Dec 3 09:40:54 2019 +0100
Add porting-to for GCC 10
* htdocs/gcc-10/changes.html: Uncomment links to porting-to
file and general documentation.
* htdocs/gcc-10/porting_to.html: New; add Fortran
argument-mismatch entry.
diff --git a/htdocs/gcc-10/changes.html b/htdocs/gcc-10/changes.html
index 5cca097..6e45c8f 100644
--- a/htdocs/gcc-10/changes.html
+++ b/htdocs/gcc-10/changes.html
@@ -17,11 +17,11 @@
<p>
This page is a "brief" summary of some of the huge number of improvements
in GCC 10.
-<!--
+
You may also want to check out our
<a href="porting_to.html">Porting to GCC 10</a> page and the
<a href="../onlinedocs/index.html#current">full GCC documentation</a>.
--->
+
</p>
<p>Note: GCC 10 has not been released yet, so this document is
diff --git a/htdocs/gcc-10/porting_to.html b/htdocs/gcc-10/porting_to.html
new file mode 100644
index 0000000..2c40419
--- /dev/null
+++ b/htdocs/gcc-10/porting_to.html
@@ -0,0 +1,134 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Porting to GCC 10</title>
+<link rel="stylesheet" type="text/css" href="https://gcc.gnu.org/gcc.css" />
+</head>
+
+<body>
+<h1>Porting to GCC 10</h1>
+
+<p>
+The GCC 10 release series differs from previous GCC releases in
+<a href="changes.html">a number of ways</a>. Some of these are a result
+of bug fixing, and some old behaviors have been intentionally changed
+to support new standards, or relaxed in standards-conforming ways to
+facilitate compilation or run-time performance.
+</p>
+
+<p>
+Some of these changes are user visible and can cause grief when
+porting to GCC 10. This document is an effort to identify common issues
+and provide solutions. Let us know if you have suggestions for improvements!
+</p>
+
+
+<!--
+<h2 id="cpp">Preprocessor issues</h2>
+-->
+
+<!--
+<h2 id="c">C language issues</h2>
+-->
+
+<h2 id="fortran">Fortran language issues</h2>
+
+<h3 id="argument-mismatch">Argument mismatches</h3>
+
+<p>
+GCC 10 now rejects argument mismatches occurring in the same source file.
+Those are not permitted by the Fortran standard and in general have the
+potential to generate invalid code. However, the Fortran standard does permit
+passing an array element or a scalar string (of default character kind or of
+<code>c_char</code> kind) as actual argument to an array dummy argument.
+(For the exact wording, see the Fortran standard on argument association;
+in particular, Fortran 2018, Sect. 15.5.2.4, Para. 4.)
+</p>
+
+<p>
+Depending on their nature, argument mismatches have the potential to cause the
+generation of invalid code and, hence, should be investigated. The most common
+reason that code fails due to newly enforced check is the following: instead of
+using an array element as actual argument, a scalar is used; one solution is to
+replace the scalar by a size-one array. (This should be passed as a whole as
+there is no point in passing it as array element.) Additionally, check that the
+code indeed only accesses this single element. — Other mismatches occur more
+rarely but usually indicate more serious bugs where a wrong result is likely
+(at least for some target-platform and optimization combination).
+</p>
+
+<p>
+If short-term fixing of those issues is not feasible, the compiler flag
+<code>-fallow-argument-mismatch</code> (implied by <code>-std=legacy</code>)
+downgrades the error to a warning.
+</p>
+
+<p>
+Example: Assume a subroutine which takes an assumed-size or explicit-size array
+and the array size as another argument, such as
+</p>
+
+<pre><code>
+ subroutine sub_assumed(array, n)
+ real array(*)
+ integer n
+ …
+ end
+
+ subroutine another_explicit(array, n)
+ integer n
+ real array(n)
+ …
+ end
+</code></pre>
+
+<p>
+An invalid but comparably common use is to pass scalar to such procedures:
+</p>
+
+<pre><code>
+ real var
+ …
+ call sub_assumed(var, 1)
+</pre></code>
+
+<p>
+This can be fixed in several ways. The simplest and most localized one is the
+following; the scalar is replaced by an array. In the second subroutine, it
+is assumed that the argument is both read from and written to. In the third
+procedure, a single number is passed, which is assumed to be only accessed for
+reading. (Note: By adding the brackets, a Fortran 66 or 77 compiler can no
+longer compile it.)
+
+<pre><code>
+ subroutine caller()
+ real var<span class="red">(1)</span>
+ …
+ call sub_assumed(var, 1)
+ end
+
+ subroutine caller_arg(var)
+ real var
+ real <span class="red">var2(1)</span>
+ …
+ <span class="red">var2(1)</span>var2(1) = var
+ call sub_assumed(var<span class="red">2</span>, 1)
+ <span class="red">var = var2(1)</span>
+ end
+
+ subroutine caller_readonly(var)
+ …
+<em>! Before: var = func(42.0, 1)</em>
+ var = func(<span class="red">[</span>42.0<span class="red">]</span>, 1)
+</code></pre>
+
+<!--
+<h2 id="cxx">C++ language issues</h2>
+-->
+
+<h2 id="links">Links</h2>
+
+</body>
+</html>
-----------------------------------------------------------------------
Summary of changes:
htdocs/gcc-10/changes.html | 4 +-
htdocs/gcc-10/porting_to.html | 134 +++++++++++++++++++++++++++++++++++++++++
2 files changed, 136 insertions(+), 2 deletions(-)
create mode 100644 htdocs/gcc-10/porting_to.html
hooks/post-receive
--
gcc-wwwdocs
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2019-12-03 8:42 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-12-03 8:42 gcc-wwwdocs branch master updated. 2e5b610bc77329bb2e1fdd3dff1efcd08b99b830 burnus
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).