From: Mark Mitchell <mark@codesourcery.com>
Date: Wed, 26 May 1999 09:38:33 +0000 (+0000)
Subject: gcc.texi (Passes): Document branch-shortening.
X-Git-Tag: releases/libgcj-2.95.0~361
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f20b5577f8d9aeada63329b028d91769c7df4884;p=thirdparty%2Fgcc.git

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 2c2feb6c9cde..34f612d36a55 100644
--- 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 16828160c324..0e8cb983cde9 100644
--- 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 8d597342a726..4aecc14c93c6 100644
--- 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}.