extend.texi (Constructing Calls): Add warning about the limitations of the functions.

	* doc/extend.texi (Constructing Calls): Add warning about
	the limitations of the functions.

From-SVN: r74314

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index efe009217e60e6ebd9f98a1b227bbcb25d75d847..61904c94a9738df6f41a8fd0d04fff8c19deb882 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2003-12-05  Eric Botcazou  <ebotcazou@libertysurf.fr>
+
+       * doc/extend.texi (Constructing Calls): Add warning about
+       the limitations of the functions.
+
 2003-12-05  Eric Botcazou  <ebotcazou@libertysurf.fr>
 
        PR middle-end/11151

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 7825a12376de2c18ff94e57e431b7cdfe67852ba..535616ba633a2320335bc5828e0d8385b62b8766 100644 (file)
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -884,6 +884,11 @@ and later return that value, without knowing what data type
 the function tried to return (as long as your caller expects
 that data type).
 
+However, these built-in functions may interact badly with some
+sophisticated features or other extensions of the language.  It
+is, therefore, not recommended to use them outside very simple
+functions acting as mere forwarders for their arguments.
+
 @deftypefn {Built-in Function} {void *} __builtin_apply_args ()
 This built-in function returns a pointer to data
 describing how to perform a call with the same arguments as were passed