diff mbox series

docs: Document -fdump-tree-<pass>-alias

Message ID aTKt3czGg3h8Kn7H@localhost.localdomain
State New
Headers
Series docs: Document -fdump-tree-<pass>-alias |

Commit Message

Filip Kastl Dec. 5, 2025, 10:03 a.m. UTC 
  Describe the -alias option for the -fdump-tree flag.

gcc/ChangeLog:

	* doc/invoke.texi: Document -fdump-tree-<pass>-alias.

Signed-off-by: Filip Kastl <fkastl@suse.cz>
---
 gcc/doc/invoke.texi | 4 ++++
 1 file changed, 4 insertions(+)

Comments

Jakub Jelinek Dec. 5, 2025, 10:25 a.m. UTC | #1 
On Fri, Dec 05, 2025 at 11:03:09AM +0100, Filip Kastl wrote:
> Describe the -alias option for the -fdump-tree flag.
> 
> gcc/ChangeLog:
> 
> 	* doc/invoke.texi: Document -fdump-tree-<pass>-alias.

alias does a lot more than that.
It also dumps the pt_solutions/alignment/misalignment for
pointer SSA_NAMEs, global ranges for integral/floating point SSA_NAMEs,
and use/clobber pt_solutions for calls.

	Jakub
Filip Kastl Dec. 5, 2025, 10:58 a.m. UTC | #2 
On Fri 2025-12-05 11:25:18, Jakub Jelinek wrote:
> On Fri, Dec 05, 2025 at 11:03:09AM +0100, Filip Kastl wrote:
> > Describe the -alias option for the -fdump-tree flag.
> > 
> > gcc/ChangeLog:
> > 
> > 	* doc/invoke.texi: Document -fdump-tree-<pass>-alias.
> 
> alias does a lot more than that.
> It also dumps the pt_solutions/alignment/misalignment for
> pointer SSA_NAMEs, global ranges for integral/floating point SSA_NAMEs,
> and use/clobber pt_solutions for calls.
> 
> 	Jakub
> 

Ah, right.  Thanks!  I even used it for some of those things and then forgot
about it.  I'll investigate -alias some more and write a complete description.

Filip
Andrew Pinski Dec. 5, 2025, 9:59 p.m. UTC | #3 
On Fri, Dec 5, 2025 at 3:06 AM Filip Kastl <fkastl@suse.cz> wrote:
>
> On Fri 2025-12-05 11:25:18, Jakub Jelinek wrote:
> > On Fri, Dec 05, 2025 at 11:03:09AM +0100, Filip Kastl wrote:
> > > Describe the -alias option for the -fdump-tree flag.
> > >
> > > gcc/ChangeLog:
> > >
> > >     * doc/invoke.texi: Document -fdump-tree-<pass>-alias.
> >
> > alias does a lot more than that.
> > It also dumps the pt_solutions/alignment/misalignment for
> > pointer SSA_NAMEs, global ranges for integral/floating point SSA_NAMEs,
> > and use/clobber pt_solutions for calls.
> >
> >       Jakub
> >
>
> Ah, right.  Thanks!  I even used it for some of those things and then forgot
> about it.  I'll investigate -alias some more and write a complete description.

Also this is part of PR 114892. There are others (still not documented).

Thanks,
Andrew Pinski

>
> Filip
diff mbox series

Patch

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index a6d2b54cc7f..b20566fc6e3 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -21641,6 +21641,10 @@  certain passes).
 @item folding
 Enable dumping information about match-and-simplify (match.pd) patterns,
 when they are applied.
+@item alias
+Enable dumping dependence clique information (the base and clique numbers).
+Will only get dumped if it is available. Therefore this option may not do
+anything when dumping earlier passes.
 @item all
 Turn on all options, except @option{raw}, @option{slim}, @option{verbose}
 and @option{lineno}.