From: Andrew Pinski <pinskia@gmail.com>
Date: Fri, 1 Feb 2008 01:41:27 +0000 (-0800)
Subject: re PR c/29326 (__builtin_trap is not documented)
X-Git-Tag: releases/gcc-4.3.0~308
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a18c20ec9a1a6da58096040a1c1a423344993e8d;p=thirdparty%2Fgcc.git

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 301df26cda2b..647797eeb6fa 100644
--- 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 73c823fa45ca..0bf8811963ce 100644
--- 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}