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

gcc/ChangeLog

+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.

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}