From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 48) id 1CE73385DC04; Thu, 16 Apr 2020 17:33:11 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1CE73385DC04 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1587058391; bh=m87exne6P9AqQm0Gp6BdhQmgJMoLtqEzF4v0h4QMpVM=; h=From:To:Subject:Date:From; b=Rrm3JikNTp61rK8sZn5QVOt+IcSiOUZroI+1o8lPiyBmynsSHhbVkBsY2kdlsPkNO /i10ezI0GEmMdTXf5RtD2lq4ia9aM3auvQ3SI+dgKMyYfTWuaXYQHkSIHrUWp1MBSD NsCF/+YveoPtB4+QDI2ki7PIrWUKD9aEt9knjvt8= From: "cgw at alum dot mit.edu" To: gcc-bugs@gcc.gnu.org Subject: [Bug libfortran/94625] New: documentation of _gfortran_set_options does not match implementation Date: Thu, 16 Apr 2020 17:33:10 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: gcc X-Bugzilla-Component: libfortran X-Bugzilla-Version: 9.3.0 X-Bugzilla-Keywords: X-Bugzilla-Severity: normal X-Bugzilla-Who: cgw at alum dot mit.edu X-Bugzilla-Status: UNCONFIRMED X-Bugzilla-Resolution: X-Bugzilla-Priority: P3 X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org X-Bugzilla-Target-Milestone: --- X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version bug_status bug_severity priority component assigned_to reporter target_milestone Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: gcc-bugs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-bugs mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Apr 2020 17:33:11 -0000 https://gcc.gnu.org/bugzilla/show_bug.cgi?id=3D94625 Bug ID: 94625 Summary: documentation of _gfortran_set_options does not match implementation Product: gcc Version: 9.3.0 Status: UNCONFIRMED Severity: normal Priority: P3 Component: libfortran Assignee: unassigned at gcc dot gnu.org Reporter: cgw at alum dot mit.edu Target Milestone: --- In gcc/fortran/gfortran.texi the documentation for _libgfortran_set_options describes the OPTIONS argument as follows: OPTION[0] Allowed standard; can give run-time errors if e.g. an input-output edit descriptor is invalid in a given standard. Possible values are (bitwise or-ed) 'GFC_STD_F77' (1), 'GFC_STD_F95_OBS' (2), 'GFC_STD_F95_DEL' (4), 'GFC_STD_F95' (8), 'GFC_STD_F2003' (16), 'GFC_STD_GNU' (32), 'GFC_STD_LEGACY' (64), 'GFC_STD_F2008' (128), 'GFC_STD_F2008_OBS' (256), 'GFC_STD_F2008_TS' (512), 'GFC_STD_F2018' (1024), 'GFC_STD_F2018_OBS' (2048), and 'GFC_STD=3DF2018_DEL' (4096). Default: 'GFC_STD_F95_OBS | GFC_STD_F95_DEL | GFC_STD_F95 | GFC_STD_F2003 | GFC_STD_F2008 | GFC_STD_F2008_TS | GFC_STD_F2008_OBS | GFC_STD_F77 | GFC_STD_F2018 | GFC_STD_F2018_OBS | GFC_STD_F2018_DEL | GFC_STD_GNU | GFC_STD_LEGACY'. OPTION[1] Standard-warning flag; prints a warning to standard error. Default: 'GFC_STD_F95_DEL | GFC_STD_LEGACY'. OPTION[2] If non zero, enable pedantic checking. Default: off. OPTION[3] Unused. OPTION[4] If non zero, enable backtracing on run-time errors. Default: off. (Default in the compiler: on.) Note: Installs a signal handler and requires command-line initialization using '_gfortran_set_args'. OPTION[5] If non zero, supports signed zeros. Default: enabled. OPTION[6] Enables run-time checking. Possible values are (bitwise or-ed): GFC_RTCHECK_BOUNDS (1), GFC_RTCHECK_ARRAY_TEMPS (2), GFC_RTCHECK_RECURSION (4), GFC_RTCHECK_DO (16), GFC_RTCHECK_POINTER (32). Default: disabled. OPTION[7] Unused. OPTION[8] Show a warning when invoking 'STOP' and 'ERROR STOP' if a floating-point exception occurred. Possible values are (bitwise or-ed) 'GFC_FPE_INVALID' (1), 'GFC_FPE_DENORMAL' (2), 'GFC_FPE_ZERO' (4), 'GFC_FPE_OVERFLOW' (8), 'GFC_FPE_UNDERFLOW' (16), 'GFC_FPE_INEXACT' (32). Default: None (0). (Default in the compiler: 'GFC_FPE_INVALID | GFC_FPE_DENORMAL | GFC_FPE_ZERO | GFC_FPE_OVERFLOW | GFC_FPE_UNDERFLOW'.) Unless I'm misunderstanding, _libgfortran_set_options is the public name fo= r a function defined as set_options in libgfortran/runtime/compile_options.c void set_options (int num, int options[]) { if (num >=3D 1) compile_options.warn_std =3D options[0]; if (num >=3D 2) compile_options.allow_std =3D options[1]; if (num >=3D 3) compile_options.pedantic =3D options[2]; if (num >=3D 4) compile_options.backtrace =3D options[3]; if (num >=3D 5) compile_options.sign_zero =3D options[4]; if (num >=3D 6) compile_options.bounds_check =3D options[5]; if (num >=3D 7) compile_options.fpe_summary =3D options[6]; Note that the the first two options - `warn` and `allow` - seem to be rever= sed, and unused elements 3 and 7 seem to have been removed, as also borne out by libgfortran/ChangeLog-2016: * runtime/compile_options.c (set_options): Remove unused elements.=