https://gcc.gnu.org/g:97fe637c036622b4dd699af71c84902038c4794d
commit r16-5232-g97fe637c036622b4dd699af71c84902038c4794d Author: Marc Poulhiès <[email protected]> Date: Thu Oct 23 15:32:15 2025 +0200 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: --- gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst | 4 ++-- .../doc/gnat_ugn/building_executable_programs_with_gnat.rst | 6 +++--- gcc/ada/gnat_rm.texi | 4 ++-- gcc/ada/gnat_ugn.texi | 10 +++++----- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst index c5f4abc780c7..fe52317fb673 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 9893c5b77276..703607d28493 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 30dba8215a4c..112ad1394f29 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 478975739f12..97571bfb428c 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
