On 10/29/2015 09:52 AM, James Greenhalgh wrote:
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 76fdc31..148f063 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -6665,17 +6665,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
+will be registered in the order that they will execute and so often the
s/will be registered/are registered/
+number will correspond to the pass execution order. However, passes
s/will correspond/corresponds/
+registered by plugins, which are specific to compilation targets, or
+which are otherwise registered after all the other passes, will be
This is ambiguous. Do you mean
"passes registered by plugins (which are specific to compilation targets
or otherwise registered after all the other passes)"
or
"passes registered by plugins, passes specific to compilation targets,
or passes that are otherwise registered after all the other passes"
??
In either case, also please s/, will be/ are/.
+numbered higher than a pass named "final", even if they were executed
s/were/are/
+earlier. @var{dumpname} is generated from the name of the output
+file, if explicitly specified and it is not an executable, otherwise it
file if it is 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
-Sandra the nit-picky
