diff options
author | James Greenhalgh <james.greenhalgh@arm.com> | 2015-10-30 15:46:01 +0000 |
---|---|---|
committer | James Greenhalgh <jgreenhalgh@gcc.gnu.org> | 2015-10-30 15:46:01 +0000 |
commit | ecc5691d0f92cf557611a34feafee9ee58b7e337 (patch) | |
tree | 79b11c40362ce4bda0c01876a4a81f0cb6015f69 | |
parent | aecdf6d919b4f769478212ff7cf5bd6a264ddf5a (diff) | |
download | gcc-ecc5691d0f92cf557611a34feafee9ee58b7e337.zip gcc-ecc5691d0f92cf557611a34feafee9ee58b7e337.tar.gz gcc-ecc5691d0f92cf557611a34feafee9ee58b7e337.tar.bz2 |
Re: [Docs] Reword the documentation for -fdump-rtl-
gcc/
* doc/invoke.texi (fdump-rtl-@var{pass}): Clarify relationship
between pass numbering and execution order.
From-SVN: r229584
-rw-r--r-- | gcc/ChangeLog | 5 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 22 |
2 files changed, 17 insertions, 10 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index c7e7fe1..4f1b882 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2015-10-30 James Greenhalgh <james.greenhalgh@arm.com> + + * doc/invoke.texi (fdump-rtl-@var{pass}): Clarify relationship + between pass numbering and execution order. + 2015-10-30 Kyrylo Tkachov <kyrylo.tkachov@arm.com> * config/arm/arm.c (cortex_a9_sched_adjust_cost): Use reg_set_p to diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 70dc5d0..4fc7d88 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -6666,17 +6666,19 @@ Says to make debugging dumps during compilation at times specified by @var{letters}. This is used for debugging the RTL-based passes of the compiler. The file names for most of the dumps are made by appending a pass number and a word to the @var{dumpname}, and the files are -created in the directory of the output file. In case of +created in the directory of the output file. In case of @option{=@var{filename}} option, the dump is output on the given file -instead of the pass numbered dump files. Note that the pass number is -computed statically as passes get registered into the pass manager. -Thus the numbering is not related to the dynamic order of execution of -passes. In particular, a pass installed by a plugin could have a -number over 200 even if it executed quite early. @var{dumpname} is -generated from the name of the output file, if explicitly specified -and it is not an executable, otherwise it is the basename of the -source file. These switches may have different effects when -@option{-E} is used for preprocessing. +instead of the pass numbered dump files. Note that the pass number is +assigned as passes are registered into the pass manager. Most passes +are registered in the order that they will execute and for these passes +the number corresponds to the pass execution order. However, passes +registered by plugins, passes specific to compilation targets, or +passes that are otherwise registered after all the other passes are +numbered higher than a pass named "final", even if they are executed +earlier. @var{dumpname} is generated from the name of the output +file if explicitly specified and not an executable, otherwise it is +the basename of the source file. These switches may have different +effects when @option{-E} is used for preprocessing. Debug dumps can be enabled with a @option{-fdump-rtl} switch or some @option{-d} option @var{letters}. Here are the possible |