From: Manuel López-Ibáñez <manu@gcc.gnu.org>
Date: Fri, 15 Aug 2014 16:27:38 +0000 (+0000)
Subject: input.h (in_system_header_at): Add comment.
X-Git-Tag: releases/gcc-5.1.0~5451
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=86d2cad9064326411c933cd67313e602f0828419;p=thirdparty%2Fgcc.git

input.h (in_system_header_at): Add comment.

2014-08-15  Manuel López-Ibáñez  <manu@gcc.gnu.org>

	* input.h (in_system_header_at): Add comment.

From-SVN: r214028
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index e3018e54a656..906231ac02a3 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2014-08-15  Manuel López-Ibáñez  <manu@gcc.gnu.org>
+
+	* input.h (in_system_header_at): Add comment.
+
 2014-08-15  Manuel López-Ibáñez  <manu@gcc.gnu.org>
 
 	PR fortran/44054
diff --git a/gcc/input.h b/gcc/input.h
index 1def793ae30f..a4fddf0a3b09 100644
--- a/gcc/input.h
+++ b/gcc/input.h
@@ -59,8 +59,17 @@ extern location_t input_location;
   ((tree) ((IS_ADHOC_LOC (LOC)) ? get_data_from_adhoc_loc (line_table, (LOC)) \
    : NULL))
 
+/* Return a positive value if LOCATION is the locus of a token that is
+   located in a system header, O otherwise. It returns 1 if LOCATION
+   is the locus of a token that is located in a system header, and 2
+   if LOCATION is the locus of a token located in a C system header
+   that therefore needs to be extern "C" protected in C++.
+
+   Note that this function returns 1 if LOCATION belongs to a token
+   that is part of a macro replacement-list defined in a system
+   header, but expanded in a non-system file.  */
 #define in_system_header_at(LOC) \
-  ((linemap_location_in_system_header_p (line_table, LOC)))
+  (linemap_location_in_system_header_p (line_table, LOC))
 
 void dump_line_table_statistics (void);