From patchwork Mon Nov 1 23:59:13 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 46939 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 507C03858C27 for ; Tue, 2 Nov 2021 00:01:58 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from esa4.mentor.iphmx.com (esa4.mentor.iphmx.com [68.232.137.252]) by sourceware.org (Postfix) with ESMTPS id AE1133858038; Mon, 1 Nov 2021 23:59:32 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org AE1133858038 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com IronPort-SDR: qqWNb58SqVsUUGKHcErt2T79PuaaZw7RjgmQGvFRHlI9U2usXyxPNF0aBvcK4s1796qv9uUT0h 96bNjjyuSBWZP1I7GQaj/oW9uGJ/AcpxwS0uHRhCbyS23EjMBuFqKYvA198Pa8M2cjW1TNw/Jz ewV8hReETmis02BMfscxeeCc21K3xtItVSVxt4PkvOWKomMSDCor4q0XLE+0qupDLdp2dyVa+p 5LfYnOmCk0tCoy/h0k3yjqU7aMUCkTMo4kpMgmz2++9M2L+uFZCM13aEWvI7ffKFkHU3ErF0VM JpI1RgN4S7Z9Ur+2iF/PvPPR X-IronPort-AV: E=Sophos;i="5.87,201,1631606400"; d="scan'208";a="67939510" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa4.mentor.iphmx.com with ESMTP; 01 Nov 2021 15:59:31 -0800 IronPort-SDR: hbiEpXBzqk04Iw7wgnR/doiUA+Ykqy71B1/b5mwpfJ+DtBGlt41x0+NdYRJZ73wKDLxhjAZrFi Rxnz33yU5kwXb5msPEbuIajtIIiNssOy/TvVqnYlEJ/PA7gYlp9vA9UDFMTdSsauTXIj8Iokm9 YbTWPOa6SH6Gaymq7mwrqCdWL0+kwvFZNjHuLw0ln53pvOwMHp5p7d2hZDDHF2lp2sbpMWIQ9K 2B03s7k7PxrzBw4Er5yVWY7WeudMAXKWXL6CpIUXkTShaZdRZJLU6T9VaXaxTNRFE/L+/xvHyR w3I= From: Sandra Loosemore To: , Subject: [PATCH 4/5] Fortran manual: Update miscellaneous references to old standard versions. Date: Mon, 1 Nov 2021 17:59:13 -0600 Message-ID: <20211101235914.112424-1-sandra@codesourcery.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-ClientProxiedBy: SVR-ORW-MBX-07.mgc.mentorg.com (147.34.90.207) To svr-orw-mbx-03.mgc.mentorg.com (147.34.90.203) X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, GIT_PATCH_0, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Sender: "Gcc-patches" 2021-11-01 Sandra Loosemore gcc/fortran/ * intrinsic.texi (Introduction to Intrinsics): Genericize references to standard versions. * invoke.texi (-fall-intrinsics): Likewise. (-fmax-identifier-length=): Likewise. --- gcc/fortran/intrinsic.texi | 15 ++++++--------- gcc/fortran/invoke.texi | 4 ++-- 2 files changed, 8 insertions(+), 11 deletions(-) diff --git a/gcc/fortran/intrinsic.texi b/gcc/fortran/intrinsic.texi index 6f7008a..9201c38 100644 --- a/gcc/fortran/intrinsic.texi +++ b/gcc/fortran/intrinsic.texi @@ -329,14 +329,11 @@ Some basic guidelines for editing this document: @node Introduction to Intrinsics @section Introduction to intrinsic procedures -The intrinsic procedures provided by GNU Fortran include all of the -intrinsic procedures required by the Fortran 95 standard, a set of -intrinsic procedures for backwards compatibility with G77, and a -selection of intrinsic procedures from the Fortran 2003 and Fortran 2008 -standards. Any conflict between a description here and a description in -either the Fortran 95 standard, the Fortran 2003 standard or the Fortran -2008 standard is unintentional, and the standard(s) should be considered -authoritative. +The intrinsic procedures provided by GNU Fortran include procedures required +by the Fortran 95 and later supported standards, and a set of intrinsic +procedures for backwards compatibility with G77. Any conflict between +a description here and a description in the Fortran standards is +unintentional, and the standard(s) should be considered authoritative. The enumeration of the @code{KIND} type parameter is processor defined in the Fortran 95 standard. GNU Fortran defines the default integer type and @@ -355,7 +352,7 @@ Many of the intrinsic procedures take one or more optional arguments. This document follows the convention used in the Fortran 95 standard, and denotes such arguments by square brackets. -GNU Fortran offers the @option{-std=f95} and @option{-std=gnu} options, +GNU Fortran offers the @option{-std=} command-line option, which can be used to restrict the set of intrinsic procedures to a given standard. By default, @command{gfortran} sets the @option{-std=gnu} option, and so all intrinsic procedures described here are accepted. There diff --git a/gcc/fortran/invoke.texi b/gcc/fortran/invoke.texi index 3533e86..e9fb792 100644 --- a/gcc/fortran/invoke.texi +++ b/gcc/fortran/invoke.texi @@ -227,7 +227,7 @@ form is determined by the file extension. @item -fall-intrinsics @opindex @code{fall-intrinsics} This option causes all intrinsic procedures (including the GNU-specific -extensions) to be accepted. This can be useful with @option{-std=f95} to +extensions) to be accepted. This can be useful with @option{-std=} to force standard-compliance but get access to the full range of intrinsics available with @command{gfortran}. As a consequence, @option{-Wintrinsics-std} will be ignored and no user-defined procedure with the same name as any @@ -397,7 +397,7 @@ lines in the source file. The default value is 132. @item -fmax-identifier-length=@var{n} @opindex @code{fmax-identifier-length=}@var{n} Specify the maximum allowed identifier length. Typical values are -31 (Fortran 95) and 63 (Fortran 2003 and Fortran 2008). +31 (Fortran 95) and 63 (Fortran 2003 and later). @item -fimplicit-none @opindex @code{fimplicit-none} From patchwork Mon Nov 1 23:59:14 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 46940 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 3FD143858039 for ; Tue, 2 Nov 2021 00:02:36 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from esa4.mentor.iphmx.com (esa4.mentor.iphmx.com [68.232.137.252]) by sourceware.org (Postfix) with ESMTPS id 979B83858038; Mon, 1 Nov 2021 23:59:34 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 979B83858038 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com IronPort-SDR: 9pnPBROFyx9BjoUfLB16xyiSh2eAgd4AkaTi8Bu3/HCYc8ZK0nF04QaseSQcSi2mJWFAICAqEl /Ik9ihm8Ep5L29u7L7nD9NOaYL/RskfAzmHNisb7AHTX7vEAo7ONfSbEqahDGOJHnM83K79NiR t85RwCFQCtZYeawaAjEOS2Sy0hGmp5glfM7MO47wF6MRjsu1d5s/z1a6GhR6iiwZcNwfw3BSU7 XGRGAJCurEI2/ChXWNlwcCDlgfElqON2p3qg2GNI/EyFCY79dqSxP+wCbVJm+0jOAq1Y1gDEsL Cf5zJ34yoJ+u3BjTUfA7Hux3 X-IronPort-AV: E=Sophos;i="5.87,201,1631606400"; d="scan'208";a="67939511" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa4.mentor.iphmx.com with ESMTP; 01 Nov 2021 15:59:33 -0800 IronPort-SDR: tB+2EBCKmrgLWoH/igNWsw57Je6gPgZBugXfDRFP49Ni90hWT4SHonegzVW3jUtCwE8IBuo6Y6 lb5eUK4U6vxwvifHimdHsPFFLll9xBZ/2wjygZZx6XCQe7gmzIun5o8oIkG+BuasfCJ9LxAmx0 1JCuzsat7quvvN3JWD1jNzxdUk/98deXmSfMK7DAI2aak7Bm4JZG/HpDGr69j0v6O8TPgu0Pfz tiNXxiHrnDCfcC9200z1MhkGTiNY7Nrj+Ov6Rm9C7Nb2cxyaVOyoKQSLx2cWL5QSUOo1fN2Qgb bLA= From: Sandra Loosemore To: , Subject: [PATCH 5/5] Fortran manual: Remove old docs for never-implemented extensions. Date: Mon, 1 Nov 2021 17:59:14 -0600 Message-ID: <20211101235914.112424-2-sandra@codesourcery.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211101235914.112424-1-sandra@codesourcery.com> References: <20211101235914.112424-1-sandra@codesourcery.com> MIME-Version: 1.0 X-ClientProxiedBy: SVR-ORW-MBX-07.mgc.mentorg.com (147.34.90.207) To svr-orw-mbx-03.mgc.mentorg.com (147.34.90.203) X-Spam-Status: No, score=-9.5 required=5.0 tests=BAYES_00, GIT_PATCH_0, HEADER_FROM_DIFFERENT_DOMAINS, KAM_ASCII_DIVIDERS, KAM_DMARC_STATUS, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Sender: "Gcc-patches" 2021-11-01 Sandra Loosemore gcc/fortran/ * gfortran.texi (Projects): Add bullet for helping with incomplete standards compliance. (Proposed Extensions): Delete section. --- gcc/fortran/gfortran.texi | 92 ++++------------------------------------------- 1 file changed, 7 insertions(+), 85 deletions(-) diff --git a/gcc/fortran/gfortran.texi b/gcc/fortran/gfortran.texi index e231e74..f3a961e 100644 --- a/gcc/fortran/gfortran.texi +++ b/gcc/fortran/gfortran.texi @@ -5397,7 +5397,6 @@ but they are also things doable by someone who is willing and able. @menu * Contributors:: * Projects:: -* Proposed Extensions:: @end menu @@ -5491,91 +5490,14 @@ isolating them. Going through the bugzilla database at add more information (for example, for which version does the testcase work, for which versions does it fail?) is also very helpful. -@end table - - -@node Proposed Extensions -@section Proposed Extensions - -Here's a list of proposed extensions for the GNU Fortran compiler, in no particular -order. Most of these are necessary to be fully compatible with -existing Fortran compilers, but they are not part of the official -J3 Fortran 95 standard. - -@subsection Compiler extensions: -@itemize @bullet -@item -User-specified alignment rules for structures. - -@item -Automatically extend single precision constants to double. - -@item -Compile code that conserves memory by dynamically allocating common and -module storage either on stack or heap. - -@item -Compile flag to generate code for array conformance checking (suggest -CC). - -@item -User control of symbol names (underscores, etc). - -@item -Compile setting for maximum size of stack frame size before spilling -parts to static or heap. - -@item -Flag to force local variables into static space. - -@item -Flag to force local variables onto stack. -@end itemize - - -@subsection Environment Options -@itemize @bullet -@item -Pluggable library modules for random numbers, linear algebra. -LA should use BLAS calling conventions. +@item Missing features +For a larger project, consider working on the missing features required for +Fortran language standards compliance (@pxref{Standards}), or contributing +to the implementation of extensions such as OpenMP (@pxref{OpenMP}) or +OpenACC (@pxref{OpenACC}) that are under active development. Again, +contributing test cases for these features is useful too! -@item -Environment variables controlling actions on arithmetic exceptions like -overflow, underflow, precision loss---Generate NaN, abort, default. -action. - -@item -Set precision for fp units that support it (i387). - -@item -Variable for setting fp rounding mode. - -@item -Variable to fill uninitialized variables with a user-defined bit -pattern. - -@item -Environment variable controlling filename that is opened for that unit -number. - -@item -Environment variable to clear/trash memory being freed. - -@item -Environment variable to control tracing of allocations and frees. - -@item -Environment variable to display allocated memory at normal program end. - -@item -Environment variable for filename for * IO-unit. - -@item -Environment variable for temporary file directory. - -@item -Environment variable forcing standard output to be line buffered (Unix). - -@end itemize +@end table @c ---------------------------------------------------------------------