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 e3018e54a656660d0b4e32632076a0a14f5ece96..906231ac02a3886471e5671f5b1ef7f5c6e0ef17 100644 (file)
--- 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 1def793ae30fc14a0fa5dd1c6dfa30ab9ef428ca..a4fddf0a3b09d512eef8636e105fe8ae113f4bdb 100644 (file)
--- 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);