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

gcc/ChangeLog

+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.

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

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}.