* gcc.texi (Passes): Document branch-shortening.

	* invoke.texi (Debugging Options): Document the fact that `-dp'
	outputs length information for instructions.

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@27167 138bc75d-0d04-0410-961f-82ee72b054a4

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 2c2feb6..34f612d 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,9 @@
+Wed May 26 09:40:02 1999  Mark Mitchell  <mark@codesourcery.com>
+
+       * gcc.texi (Passes): Document branch-shortening.
+       * invoke.texi (Debugging Options): Document the fact that `-dp'
+       outputs length information for instructions.
+
 Wed May 26 08:49:31 1999  Nick Clifton  <nickc@cygnus.com>
 
        * flow.c: Revert previous delta.

diff --git a/gcc/gcc.texi b/gcc/gcc.texi
index 1682816..0e8cb98 100644 (file)
--- a/gcc/gcc.texi
+++ b/gcc/gcc.texi
@@ -3563,6 +3563,15 @@ The option @samp{-dd} causes a debugging dump of the RTL code after
 this pass.  This dump file's name is made by appending @samp{.dbr}
 to the input file name.
 
+@cindex branch shortening
+@item
+Branch shortening.  On many RISC machines, branch instructions have a
+limited range.  Thus, longer sequences of instructions must be used for 
+long branches.  In this pass, the compiler figures out what how far each
+instruction will be from each other instruction, and therefore whether
+the usual instructions, or the longer sequences, must be used for each
+branch. 
+
 @cindex register-to-stack conversion
 @item
 Conversion from usage of some hard registers to usage of a register

diff --git a/gcc/invoke.texi b/gcc/invoke.texi
index 8d59734..4aecc14 100644 (file)
--- a/gcc/invoke.texi
+++ b/gcc/invoke.texi
@@ -2088,7 +2088,8 @@ Print statistics on memory usage, at the end of the run, to
 standard error.
 @item p
 Annotate the assembler output with a comment indicating which
-pattern and alternative was used.
+pattern and alternative was used.  The length of each instruction is
+also printed.
 @item x
 Just generate RTL for a function instead of compiling it.  Usually used
 with @samp{r}.