tm.texi (TARGET_RTX_COSTS): Document that instruction costs should be based on code...

	* doc/tm.texi (TARGET_RTX_COSTS): Document that instruction
	costs should be based on code size when optimizing for size.

From-SVN: r82025

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 3b616152160900c7de2848813bcf242fdc128a29..ca2069d13fab59757c217d881002b65b753964b7 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2004-05-19  Roger Sayle  <roger@eyesopen.com>
+
+       * doc/tm.texi (TARGET_RTX_COSTS): Document that instruction
+       costs should be based on code size when optimizing for size.
+
 2004-05-19  Paolo Bonzini  <bonzini@gnu.org>
 
        * fold-const.c: Remove non-printable character 160.

diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi
index 43543a811035281755527fa86d3216896aaf3866..67f4b7608a49ce444245c84341eaa6996ed3412e 100644 (file)
--- a/gcc/doc/tm.texi
+++ b/gcc/doc/tm.texi
@@ -5456,7 +5456,13 @@ instructions.
 
 On entry to the hook, @code{*@var{total}} contains a default estimate
 for the cost of the expression.  The hook should modify this value as
-necessary.
+necessary.  Traditionally, the default costs are @code{COSTS_N_INSNS (5)}
+for multiplications, @code{COSTS_N_INSNS (7)} for division and modulus
+operations, and @code{COSTS_N_INSNS (1)} for all other operations.
+
+When optimizing for code size, i.e@. when @code{optimize_size} is
+non-zero, this target hook should be used to estimate the relative
+size cost of an expression, again relative to @code{COSTS_N_INSNS}.
 
 The hook returns true when all subexpressions of @var{x} have been
 processed, and false when @code{rtx_cost} should recurse.