From: Mark Mitchell <mark@codesourcery.com>
Date: Tue, 2 Mar 2004 17:02:13 +0000 (+0000)
Subject: c-tree.texi (DECL_ASSEMBLER_NAME): Mention that using this macro results in memory... 
X-Git-Tag: releases/gcc-4.0.0~9687
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=bdc2893ce826f67f466aa0f5b214ddfd4b312222;p=thirdparty%2Fgcc.git

c-tree.texi (DECL_ASSEMBLER_NAME): Mention that using this macro results in memory allocation.

	* doc/c-tree.texi (DECL_ASSEMBLER_NAME): Mention that using this
	macro results in memory allocation.

From-SVN: r78767
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 0a6a908ce64c..2df466298fec 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2004-03-02  Mark Mitchell  <mark@codesourcery.com>
+
+	* doc/c-tree.texi (DECL_ASSEMBLER_NAME): Mention that using this
+	macro results in memory allocation.
+
 2004-03-02  David O'Brien  <obrien@FreeBSD.org>
 
 	* config/freebsd-spec.h (FBSD_DYNAMIC_LINKER): Add.
diff --git a/gcc/doc/c-tree.texi b/gcc/doc/c-tree.texi
index d1afe655c761..8cd059e3e5c3 100644
--- a/gcc/doc/c-tree.texi
+++ b/gcc/doc/c-tree.texi
@@ -1105,6 +1105,13 @@ platform, it is the responsibility of the back end to perform those
 modifications.  (Of course, the back end should not modify
 @code{DECL_ASSEMBLER_NAME} itself.)
 
+Using @code{DECL_ASSEMBLER_NAME} will cause additional memory to be
+allocated (for the mangled name of the entity) so it should be used
+only when emitting assembly code.  It should not be used within the
+optimizers to determine whether or not two declarations are the same,
+even though some of the existing optimizers do use it in that way.
+These uses will be removed over time.
+
 @item DECL_EXTERNAL
 This predicate holds if the function is undefined.