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: r131996

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 301df26cda2b111cce2d2fc31208b6027a6d698a..647797eeb6fad80a279d959cb491ae50120f97db 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  Tom Browder <tom.browder@gmail.com>
 
        * doc/c-tree.texi (Types): Fix grammar.

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 73c823fa45ca0914b6f61aa77f033d0f8b8d2b75..0bf8811963ce6a0ec4fd0dd8cd95fdaed8ee2dd9 100644 (file)
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -6423,6 +6423,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___clear_cache (char *@var{begin}, char *@var{end})
 This function is used to flush the processor's instruction cache for
 the region of memory between @var{begin} inclusive and @var{end}