diff options
| author | Basile Starynkevitch <basile@starynkevitch.net> | 2010-11-24 13:45:10 +0000 |
|---|---|---|
| committer | Basile Starynkevitch <bstarynk@gcc.gnu.org> | 2010-11-24 13:45:10 +0000 |
| commit | ae758cb2fdb948ea76ea8896d3f9115fbb60b315 (patch) | |
| tree | 1baadd4f36341436e314f9a0ec588d43acf764fb | |
| parent | 7cd23050596840cc1e81b43a9a57134f810678ac (diff) | |
| download | gcc-ae758cb2fdb948ea76ea8896d3f9115fbb60b315.zip gcc-ae758cb2fdb948ea76ea8896d3f9115fbb60b315.tar.gz gcc-ae758cb2fdb948ea76ea8896d3f9115fbb60b315.tar.bz2 | |
invoke.texi (Options for Debugging Your Program or GCC): Explain static numbering of dump files.
2010-11-24 Basile Starynkevitch <basile@starynkevitch.net>
* doc/invoke.texi (Options for Debugging Your Program or GCC):
Explain static numbering of dump files.
From-SVN: r167114
| -rw-r--r-- | gcc/ChangeLog | 5 | ||||
| -rw-r--r-- | gcc/doc/invoke.texi | 14 |
2 files changed, 14 insertions, 5 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 5b63be3..cc0549c 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2010-11-24 Basile Starynkevitch <basile@starynkevitch.net> + + * doc/invoke.texi (Options for Debugging Your Program or GCC): + Explain static numbering of dump files. + 2010-11-24 Joseph Myers <joseph@codesourcery.com> * common.opt (user_vect_verbosity_level): New Variable entry. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index c2ffea8..b68d1dc 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -4968,11 +4968,15 @@ 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. @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. +created in the directory of the output file. 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. Debug dumps can be enabled with a @option{-fdump-rtl} switch or some @option{-d} option @var{letters}. Here are the possible |