re PR c/29326 (__builtin_trap is not documented)

	PR c/29326
	* doc/extend.texi (Other Builtins): Document.

Co-Authored-By: Ben Elliston <bje@au.ibm.com>
Co-Authored-By: Mark Mitchell <mark@codesourcery.com>
From-SVN: r131995

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 88d895c018c58ce16a556a17c5e3fe5caa0340f7..7d3b294ba81490ba9f708f55cb46b3017f02360e 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,10 @@
+2008-02-01  Andrew Pinski  <pinskia@gmail.com>
+           Mark Mitchell  <mark@codesourcery.com>
+           Ben Elliston  <bje@au.ibm.com>
+
+       PR c/29326
+       * doc/extend.texi (Other Builtins): Document.
+
 2008-01-31  Manuel Lopez-Ibanez  <manu@gcc.gnu.org>
 
        * doc/invoke.texi (-ansi): Mention explicitly corresponding -std=

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 0ba7c29b500649ab0ceab02dc9967599511a5afe..2b29dfbfe3a703b78650c4cd294d18bfd7503345 100644 (file)
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -5932,6 +5932,14 @@ if (__builtin_expect (ptr != NULL, 1))
 when testing pointer or floating-point values.
 @end deftypefn
 
+@deftypefn {Built-in Function} void __builtin_trap (void)
+This function causes the program to exit abnormally.  GCC implements
+this function by using a target-dependent mechanism (such as
+intentionally executing an illegal instruction) or by calling
+@code{abort}.  The mechanism used may vary from release to release so
+you should not rely on any particular implementation.
+@end deftypefn
+
 @deftypefn {Built-in Function} void __builtin_prefetch (const void *@var{addr}, ...)
 This function is used to minimize cache-miss latency by moving data into
 a cache before it is accessed.