From: Andrew Pinski <pinskia@gmail.com>
Date: Fri, 1 Feb 2008 01:40:49 +0000 (-0800)
Subject: re PR c/29326 (__builtin_trap is not documented)
X-Git-Tag: releases/gcc-4.2.3~41
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0b5be643e9b30a5213fd977a48eefce8f869ded3;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: r131995
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 88d895c018c5..7d3b294ba814 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  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 0ba7c29b5006..2b29dfbfe3a7 100644
--- 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.