[Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further

public inbox for gcc-bugs@sourceware.org
help / color / mirror / Atom feed

* [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further
@ 2023-10-04 17:01 jonathan.leffler at gmail dot com
  2023-10-04 19:35 ` [Bug c/111693] " pinskia at gcc dot gnu.org
                   ` (11 more replies)
  0 siblings, 12 replies; 13+ messages in thread
From: jonathan.leffler at gmail dot com @ 2023-10-04 17:01 UTC (permalink / raw)
  To: gcc-bugs

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

            Bug ID: 111693
           Summary: Online manual mentions -Wuse-after-free but does not
                    document it further
           Product: gcc
           Version: 13.2.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: c
          Assignee: unassigned at gcc dot gnu.org
          Reporter: jonathan.leffler at gmail dot com
  Target Milestone: ---

In the 13.2.0 documentation
(https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/Warning-Options.html), the list
of options enabled by "-Wall" includes "-Wuse-after-free=2", but there is no
further mention of the option on the page.

Similarly, in the 12.3.0 documentation
(https://gcc.gnu.org/onlinedocs/gcc-12.3.0/gcc/Warning-Options.html), the list
of options enabled by "-Wall" includes "-Wuse-after-free=3", but there is no
further mention of the option on the page.

It is not mentioned at all in earlier manuals, presumably because it wasn't
available in the earlier versions.

It would be helpful to know what the values 2 and 3 mean, and presumably what 1
and 0 mean too.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] Online manual mentions -Wuse-after-free but does not document it further
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
@ 2023-10-04 19:35 ` pinskia at gcc dot gnu.org
  2023-10-04 19:37 ` pinskia at gcc dot gnu.org
                   ` (10 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: pinskia at gcc dot gnu.org @ 2023-10-04 19:35 UTC (permalink / raw)
  To: gcc-bugs

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

--- Comment #1 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Documented here:
https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/C_002b_002b-Dialect-Options.html#index-Wuse-after-free

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] Online manual mentions -Wuse-after-free but does not document it further
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
  2023-10-04 19:35 ` [Bug c/111693] " pinskia at gcc dot gnu.org
@ 2023-10-04 19:37 ` pinskia at gcc dot gnu.org
  2023-10-04 19:37 ` pinskia at gcc dot gnu.org
                   ` (9 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: pinskia at gcc dot gnu.org @ 2023-10-04 19:37 UTC (permalink / raw)
  To: gcc-bugs

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

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

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |RESOLVED
         Resolution|---                         |INVALID

--- Comment #2 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Other warnings are documented on that page too.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] Online manual mentions -Wuse-after-free but does not document it further
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
  2023-10-04 19:35 ` [Bug c/111693] " pinskia at gcc dot gnu.org
  2023-10-04 19:37 ` pinskia at gcc dot gnu.org
@ 2023-10-04 19:37 ` pinskia at gcc dot gnu.org
  2023-10-04 19:58 ` jonathan.leffler at gmail dot com
                   ` (8 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: pinskia at gcc dot gnu.org @ 2023-10-04 19:37 UTC (permalink / raw)
  To: gcc-bugs

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

--- Comment #3 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
The easiest way to find documentation for an option is to look at the index
located at:
https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/Option-Index.html

And search for the option.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] Online manual mentions -Wuse-after-free but does not document it further
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (2 preceding siblings ...)
  2023-10-04 19:37 ` pinskia at gcc dot gnu.org
@ 2023-10-04 19:58 ` jonathan.leffler at gmail dot com
  2023-10-04 20:00 ` jonathan.leffler at gmail dot com
                   ` (7 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: jonathan.leffler at gmail dot com @ 2023-10-04 19:58 UTC (permalink / raw)
  To: gcc-bugs

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

--- Comment #4 from Jonathan Leffler <jonathan.leffler at gmail dot com> ---
The link
https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/C_002b_002b-Dialect-Options.html#index-Wuse-after-free
is to the "Options Controlling C++ Dialect".

I was using the C compiler, not the C++ compiler, so it is not at all obvious
that I should look at that page — in fact, that page is irrelevant to users of
the C compiler.

The information there should be either copied to the C "Warnings Options" page,
or linked to from the C page, where -Wuse-after-free is only mentioned and not
defined.

Incidentally, under "-Wuse-after-free=1" on the C++ page, there's a typo in:

whether or not the call resulted in an actual reallocatio of memory

The 'n' is missing from 'reallocation'.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] Online manual mentions -Wuse-after-free but does not document it further
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (3 preceding siblings ...)
  2023-10-04 19:58 ` jonathan.leffler at gmail dot com
@ 2023-10-04 20:00 ` jonathan.leffler at gmail dot com
  2023-10-04 20:02 ` jonathan.leffler at gmail dot com
                   ` (6 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: jonathan.leffler at gmail dot com @ 2023-10-04 20:00 UTC (permalink / raw)
  To: gcc-bugs

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

--- Comment #5 from Jonathan Leffler <jonathan.leffler at gmail dot com> ---
The link
https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/C_002b_002b-Dialect-Options.html#index-Wuse-after-free
is to the "Options Controlling C++ Dialect".

I was using the C compiler, not the C++ compiler, so it is not at all obvious
that I should look at that page — in fact, that page is irrelevant to users of
the C compiler.

The information there should be either copied to the C "Warnings Options" page,
or linked to from the C page, where -Wuse-after-free is only mentioned and not
defined.

Incidentally, under "-Wuse-after-free=1" on the C++ page, there's a typo in:

whether or not the call resulted in an actual reallocatio of memory

The 'n' is missing from 'reallocation'.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] Online manual mentions -Wuse-after-free but does not document it further
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (4 preceding siblings ...)
  2023-10-04 20:00 ` jonathan.leffler at gmail dot com
@ 2023-10-04 20:02 ` jonathan.leffler at gmail dot com
  2023-10-04 20:03 ` [Bug c/111693] -Wuse-after-free is documented in the wrong location pinskia at gcc dot gnu.org
                   ` (5 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: jonathan.leffler at gmail dot com @ 2023-10-04 20:02 UTC (permalink / raw)
  To: gcc-bugs

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

Jonathan Leffler <jonathan.leffler at gmail dot com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |UNCONFIRMED
         Resolution|INVALID                     |---

--- Comment #6 from Jonathan Leffler <jonathan.leffler at gmail dot com> ---
Apologies for the double comment — I got a "mid-air collision" message and
wasn't at all sure how to deal with that.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] -Wuse-after-free is documented in the wrong location
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (5 preceding siblings ...)
  2023-10-04 20:02 ` jonathan.leffler at gmail dot com
@ 2023-10-04 20:03 ` pinskia at gcc dot gnu.org
  2023-10-04 20:10 ` redi at gcc dot gnu.org
                   ` (4 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: pinskia at gcc dot gnu.org @ 2023-10-04 20:03 UTC (permalink / raw)
  To: gcc-bugs

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

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

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Last reconfirmed|                            |2023-10-04
            Summary|Online manual mentions      |-Wuse-after-free is
                   |-Wuse-after-free but does   |documented in the wrong
                   |not document it further     |location
           Keywords|                            |documentation
             Status|UNCONFIRMED                 |NEW
     Ever confirmed|0                           |1

--- Comment #7 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Oh yes -Wuse-after-free documentation should be moved. 

There are some others which are also misplaced (Wuseless-cast)

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] -Wuse-after-free is documented in the wrong location
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (6 preceding siblings ...)
  2023-10-04 20:03 ` [Bug c/111693] -Wuse-after-free is documented in the wrong location pinskia at gcc dot gnu.org
@ 2023-10-04 20:10 ` redi at gcc dot gnu.org
  2023-10-04 20:12 ` egallager at gcc dot gnu.org
                   ` (3 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: redi at gcc dot gnu.org @ 2023-10-04 20:10 UTC (permalink / raw)
  To: gcc-bugs

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

--- Comment #8 from Jonathan Wakely <redi at gcc dot gnu.org> ---
(In reply to Andrew Pinski from comment #3)
> The easiest way to find documentation for an option is to look at the index
> located at:
> https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/Option-Index.html
> 
> And search for the option.

You should also be able to find it in the option summary:

https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/Option-Summary.html

But it's not there.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] -Wuse-after-free is documented in the wrong location
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (7 preceding siblings ...)
  2023-10-04 20:10 ` redi at gcc dot gnu.org
@ 2023-10-04 20:12 ` egallager at gcc dot gnu.org
  2024-01-17  4:52 ` cvs-commit at gcc dot gnu.org
                   ` (2 subsequent siblings)
  11 siblings, 0 replies; 13+ messages in thread
From: egallager at gcc dot gnu.org @ 2023-10-04 20:12 UTC (permalink / raw)
  To: gcc-bugs

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

Eric Gallager <egallager at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |egallager at gcc dot gnu.org
           See Also|                            |https://gcc.gnu.org/bugzill
                   |                            |a/show_bug.cgi?id=71283

--- Comment #9 from Eric Gallager <egallager at gcc dot gnu.org> ---
related: bug 71283

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] -Wuse-after-free is documented in the wrong location
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (8 preceding siblings ...)
  2023-10-04 20:12 ` egallager at gcc dot gnu.org
@ 2024-01-17  4:52 ` cvs-commit at gcc dot gnu.org
  2024-01-17  4:54 ` sandra at gcc dot gnu.org
  2024-01-20 17:25 ` pinskia at gcc dot gnu.org
  11 siblings, 0 replies; 13+ messages in thread
From: cvs-commit at gcc dot gnu.org @ 2024-01-17  4:52 UTC (permalink / raw)
  To: gcc-bugs

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

--- Comment #10 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:25bb8a40abd91fccf9a59dd6518a7a283433dea3

commit r14-8173-g25bb8a40abd91fccf9a59dd6518a7a283433dea3
Author: Sandra Loosemore <sandra@codesourcery.com>
Date:   Wed Jan 17 04:41:52 2024 +0000

    Move docs for -Wuse-after-free and -Wuseless-cast [PR111693]

    These options were categorized as C++ options, but they apply to all
    C-family languages.

    gcc/ChangeLog
            PR c/111693
            * doc/invoke.texi (Option Summary): Move -Wuseless-cast
            from C++ Language Options to Warning Options.  Add entry for
            -Wuse-after-free.
            (C++ Dialect Options): Move -Wuse-after-free and -Wuseless-cast
            from here....
            (Warning Options): ...to here.  Minor copy-editing to fix typo
            and grammar.

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] -Wuse-after-free is documented in the wrong location
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (9 preceding siblings ...)
  2024-01-17  4:52 ` cvs-commit at gcc dot gnu.org
@ 2024-01-17  4:54 ` sandra at gcc dot gnu.org
  2024-01-20 17:25 ` pinskia at gcc dot gnu.org
  11 siblings, 0 replies; 13+ messages in thread
From: sandra at gcc dot gnu.org @ 2024-01-17  4:54 UTC (permalink / raw)
  To: gcc-bugs

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

sandra at gcc dot gnu.org changed:

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

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

^ permalink raw reply	[flat|nested] 13+ messages in thread

* [Bug c/111693] -Wuse-after-free is documented in the wrong location
  2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
                   ` (10 preceding siblings ...)
  2024-01-17  4:54 ` sandra at gcc dot gnu.org
@ 2024-01-20 17:25 ` pinskia at gcc dot gnu.org
  11 siblings, 0 replies; 13+ messages in thread
From: pinskia at gcc dot gnu.org @ 2024-01-20 17:25 UTC (permalink / raw)
  To: gcc-bugs

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

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

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|---                         |14.0

^ permalink raw reply	[flat|nested] 13+ messages in thread

end of thread, other threads:[~2024-01-20 17:25 UTC | newest]

Thread overview: 13+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-10-04 17:01 [Bug c/111693] New: Online manual mentions -Wuse-after-free but does not document it further jonathan.leffler at gmail dot com
2023-10-04 19:35 ` [Bug c/111693] " pinskia at gcc dot gnu.org
2023-10-04 19:37 ` pinskia at gcc dot gnu.org
2023-10-04 19:37 ` pinskia at gcc dot gnu.org
2023-10-04 19:58 ` jonathan.leffler at gmail dot com
2023-10-04 20:00 ` jonathan.leffler at gmail dot com
2023-10-04 20:02 ` jonathan.leffler at gmail dot com
2023-10-04 20:03 ` [Bug c/111693] -Wuse-after-free is documented in the wrong location pinskia at gcc dot gnu.org
2023-10-04 20:10 ` redi at gcc dot gnu.org
2023-10-04 20:12 ` egallager at gcc dot gnu.org
2024-01-17  4:52 ` cvs-commit at gcc dot gnu.org
2024-01-17  4:54 ` sandra at gcc dot gnu.org
2024-01-20 17:25 ` pinskia at gcc dot gnu.org

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).