[Bug other/110847] New: Inaccurate GCC documentation about -Wtsan and -Wxor-used-as-pow warnings

[Bug other/110847] New: Inaccurate GCC documentation about -Wtsan and -Wxor-used-as-pow warnings

[rogerio.souza at gmail dot com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110847

            Bug ID: 110847
           Summary: Inaccurate GCC documentation about -Wtsan and
                    -Wxor-used-as-pow warnings
           Product: gcc
           Version: unknown
               URL: https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.htm
                    l
            Status: UNCONFIRMED
          Keywords: documentation
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: rogerio.souza at gmail dot com
  Target Milestone: ---

On GCC online docs warnings page
(https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html) there is the
following explanation:

"You can request many specific warnings with options beginning with ‘-W’, for
example -Wimplicit to request warnings on implicit declarations. Each of these
specific warning options also has a negative form beginning ‘-Wno-’ to turn off
warnings; for example, -Wno-implicit. >>>This manual lists only one of the two
forms, whichever is not the default<<<"

However both -Wtsan and -Wxor-used-as-pow are listed as if they weren't on by
default, but have the "This warning is enabled by default" text on their
description. If the text above states that the documentation lists only one of
the two forms, whichever is not the default, then it might be missleading.

Regards,
Rogerio

[Bug middle-end/110847] [13/14 Regression] Inaccurate GCC documentation about -Wtsan and -Wxor-used-as-pow warnings

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110847

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Summary|Inaccurate GCC              |[13/14 Regression]
                   |documentation about -Wtsan  |Inaccurate GCC
                   |and -Wxor-used-as-pow       |documentation about -Wtsan
                   |warnings                    |and -Wxor-used-as-pow
                   |                            |warnings
   Target Milestone|---                         |13.3
             Status|UNCONFIRMED                 |NEW
                 CC|                            |dmalcolm at gcc dot gnu.org,
                   |                            |mliska at suse dot cz
   Last reconfirmed|                            |2023-07-28
     Ever confirmed|0                           |1

--- Comment #1 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Confirmed, yes they should just document the -Wno- option rather than -W
option.

-Wtsan  was added with r11-6112-g8833eab4461b .


-Wxor-used-as-pow was added with r13-2386-gbedfca647a9e .

[Bug middle-end/110847] [13/14 Regression] Inaccurate GCC documentation about -Wtsan and -Wxor-used-as-pow warnings

[cvs-commit at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110847

--- Comment #2 from GCC Commits <cvs-commit at gcc dot gnu.org> ---
The master branch has been updated by Sandra Loosemore <sandra@gcc.gnu.org>:

https://gcc.gnu.org/g:9a5e8f9d112adb0fdd0931f72a023cd77c09dd8c

commit r14-8200-g9a5e8f9d112adb0fdd0931f72a023cd77c09dd8c
Author: Sandra Loosemore <sandra@codesourcery.com>
Date:   Thu Jan 18 02:29:30 2024 +0000

    Document negative forms of -Wtsan and -Wxor-used-as-pow [PR110847]

    These warnings are enabled by default, thus the manual should document the
    -no form instead of the positive form.

    gcc/ChangeLog
            PR middle-end/110847
            * doc/invoke.texi (Option Summary): Document negative forms of
            -Wtsan and -Wxor-used-as-pow.
            (Warning Options): Likewise.

[Bug middle-end/110847] [13/14 Regression] Inaccurate GCC documentation about -Wtsan and -Wxor-used-as-pow warnings

[sandra at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110847

sandra at gcc dot gnu.org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |FIXED

--- Comment #3 from sandra at gcc dot gnu.org ---
Fixed.