* doc/tm.texi (TARGET_DELEGITIMIZE_ADDRESS): Document target hook.

From-SVN: r91713

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index b507d6d46d642765811bf2d174ea8c63dbae0738..13b1004b441015d318780262184d59da2017ac54 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2004-12-03  Roger Sayle  <roger@eyesopen.com>
+
+       * doc/tm.texi (TARGET_DELEGITIMIZE_ADDRESS): Document target hook.
+
 2004-12-03  Richard Henderson  <rth@redhat.com>
 
        * alias.c (component_uses_parent_alias_set): Rename from 

diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi
index 46a9adff1a1e1413dc991c128745879d85f250f9..97b4a0f0091569ac2f8ee19e5ae998bb76e83f63 100644 (file)
--- a/gcc/doc/tm.texi
+++ b/gcc/doc/tm.texi
@@ -5156,6 +5156,16 @@ an immediate operand on the target machine.  You can assume that
 anything @code{CONSTANT_P} is valid.
 @end defmac
 
+@deftypefn {Target Hook} rtx TARGET_DELEGITIMIZE_ADDRESS (rtx @var{x})
+This hook is used to undo the possibly obfuscating effects of the
+@code{LEGITIMIZE_ADDRESS} and @code{LEGITIMIZE_RELOAD_ADDRESS} target
+macros.  Some backend implementations of these macros wrap symbol
+references inside an @code{UNSPEC} rtx to represent PIC or similar
+addressing modes.  This target hook allows GCC's optimizers to understand
+the semantics of these opaque @code{UNSPEC}s by converting them back
+into their original form.
+@end deftypefn
+
 @deftypefn {Target Hook} bool TARGET_CANNOT_FORCE_CONST_MEM (rtx @var{x})
 This hook should return true if @var{x} is of a form that cannot (or
 should not) be spilled to the constant pool.  The default version of