From: Marc Poulhiès Date: Thu, 23 Oct 2025 13:32:15 +0000 (+0200) Subject: ada: Fix documentation on Junk names X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=97fe637c036622b4dd699af71c84902038c4794d;p=thirdparty%2Fgcc.git ada: Fix documentation on Junk names After the last change on the list of junk names, the documentation was not modified. gcc/ada/ChangeLog: * doc/gnat_rm/implementation_defined_pragmas.rst: Update the list of junk names. * doc/gnat_ugn/building_executable_programs_with_gnat.rst: Likewise. * gnat_rm.texi: Regenerate. * gnat_ugn.texi: Regenerate. --- diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst index c5f4abc780c..fe52317fb67 100644 --- a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst +++ b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst @@ -7343,7 +7343,7 @@ units and unreferenced entities within these units. For the variable case, warnings are never given for unreferenced variables whose name contains one of the substrings -``DISCARD, DUMMY, IGNORE, JUNK, UNUSED`` in any casing. Such names +``DISCARD, DUMMY, IGNORE, JUNK, UNUSE, TMP, TEMP`` in any casing. Such names are typically to be used in cases where such warnings are expected. Thus it is never necessary to use ``pragma Unreferenced`` for such variables, though it is harmless to do so. @@ -7476,7 +7476,7 @@ that it might be. For the variable case, warnings are never given for unreferenced variables whose name contains one of the substrings -``DISCARD, DUMMY, IGNORE, JUNK, UNUSED`` in any casing. Such names +``DISCARD, DUMMY, IGNORE, JUNK, UNUSE, TMP, TEMP`` in any casing. Such names are typically to be used in cases where such warnings are expected. Thus it is never necessary to use ``pragma Unused`` for such variables, though it is harmless to do so. diff --git a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst index 9893c5b7727..703607d2849 100644 --- a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst +++ b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst @@ -2740,9 +2740,9 @@ of the kinds of warnings that are generated. * Unreferenced or unmodified variables. Note that a special exemption applies to variables which contain any of the substrings - ``DISCARD, DUMMY, IGNORE, JUNK, UNUSED``, in any casing. Such variables - are considered likely to be intentionally used in a situation where - otherwise a warning would be given, so warnings of this kind are + ``DISCARD, DUMMY, IGNORE, JUNK, UNUSE, TMP, TEMP`` in any casing. Such + variables are considered likely to be intentionally used in a situation + where otherwise a warning would be given, so warnings of this kind are always suppressed for such variables. * Address overlays that could clobber memory diff --git a/gcc/ada/gnat_rm.texi b/gcc/ada/gnat_rm.texi index 30dba8215a4..112ad1394f2 100644 --- a/gcc/ada/gnat_rm.texi +++ b/gcc/ada/gnat_rm.texi @@ -8974,7 +8974,7 @@ units and unreferenced entities within these units. For the variable case, warnings are never given for unreferenced variables whose name contains one of the substrings -@code{DISCARD, DUMMY, IGNORE, JUNK, UNUSED} in any casing. Such names +@code{DISCARD, DUMMY, IGNORE, JUNK, UNUSE, TMP, TEMP} in any casing. Such names are typically to be used in cases where such warnings are expected. Thus it is never necessary to use @code{pragma Unreferenced} for such variables, though it is harmless to do so. @@ -9105,7 +9105,7 @@ that it might be. For the variable case, warnings are never given for unreferenced variables whose name contains one of the substrings -@code{DISCARD, DUMMY, IGNORE, JUNK, UNUSED} in any casing. Such names +@code{DISCARD, DUMMY, IGNORE, JUNK, UNUSE, TMP, TEMP} in any casing. Such names are typically to be used in cases where such warnings are expected. Thus it is never necessary to use @code{pragma Unused} for such variables, though it is harmless to do so. diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi index 478975739f1..97571bfb428 100644 --- a/gcc/ada/gnat_ugn.texi +++ b/gcc/ada/gnat_ugn.texi @@ -19,7 +19,7 @@ @copying @quotation -GNAT User's Guide for Native Platforms , Oct 31, 2025 +GNAT User's Guide for Native Platforms , Nov 13, 2025 AdaCore @@ -10788,9 +10788,9 @@ Values known to be out of range at compile time @item Unreferenced or unmodified variables. Note that a special exemption applies to variables which contain any of the substrings -@code{DISCARD, DUMMY, IGNORE, JUNK, UNUSED}, in any casing. Such variables -are considered likely to be intentionally used in a situation where -otherwise a warning would be given, so warnings of this kind are +@code{DISCARD, DUMMY, IGNORE, JUNK, UNUSE, TMP, TEMP} in any casing. Such +variables are considered likely to be intentionally used in a situation +where otherwise a warning would be given, so warnings of this kind are always suppressed for such variables. @item @@ -30333,8 +30333,8 @@ to permit their use in free software. @printindex ge -@anchor{d2}@w{ } @anchor{gnat_ugn/gnat_utility_programs switches-related-to-project-files}@w{ } +@anchor{d2}@w{ } @c %**end of body @bye