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

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

From-SVN: r27167

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 2c2feb6c9cdedaae0af38cde89e486db54184efe..34f612d36a550641c89f671ed177293ad2d7502e 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 16828160c324604319c75e426b46a742d8717e83..0e8cb983cde98cfb773595200ccedbe3658eb57f 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 8d597342a7261257b38efe8fed825e5705eb174d..4aecc14c93c61073781962a677da5a8cc2007aae 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}.