On 04/26/2018 11:12 AM, Nathan Sidwell wrote:
Index: doc/invoke.texi
===================================================================
--- doc/invoke.texi (revision 259680)
+++ doc/invoke.texi (working copy)
@@ -13368,9 +13368,10 @@ Says to make debugging dumps during comp
@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
-@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
+created in the directory of the output file. Using a
+@option{=@var{filename}} suffix overrides this default scheme. You
+can specify @code{stdout} or @code{-} to refer to standard output, and
+@code{stderr} for standard error. 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
Hmmm, I'm not crazy about putting this material in the middle of a
discussion about how the compiler comes up with its default dump file
names. How about splitting the existing paragraph into 3:
- The 2 introductory sentences explaining what the option does.
- The default dump file name description.
- How to override it.
-Sandra
