--- gcc/cpp.texinfo 2018/04/24 16:51:55 1.1.1.6 +++ gcc/cpp.texinfo 2018/04/24 16:52:50 1.1.1.7 @@ -301,12 +301,12 @@ however, contain a @samp{<} character. @item #include "@var{file}" This variant is used for header files of your own program. It -searches for a file named @var{file} first in the current -directory, then in the same directories used for system header -files. The current directory is tried first because it is -presumed to be the location of the files of the program being -compiled. (If the @samp{-I-} option is used, the special treatment -of the current directory is inhibited.) +searches for a file named @var{file} first in the current directory, +then in the same directories used for system header files. The +current directory is the directory of the current input file. It is +tried first because it is presumed to be the location of the files +that the current input file refers to. (If the @samp{-I-} option is +used, the special treatment of the current directory is inhibited.) The argument @var{file} may not contain @samp{"} characters. If backslashes occur within @var{file}, they are considered ordinary text @@ -2025,13 +2025,18 @@ Source file name and line number informa the form @example -# @var{linenum} @var{filename} +# @var{linenum} @var{filename} @var{flag} @end example @noindent -which are inserted as needed into the middle of the input (but never within -a string or character constant). Such a line means that the following line -originated in file @var{filename} at line @var{linenum}. +which are inserted as needed into the middle of the input (but never +within a string or character constant). Such a line means that the +following line originated in file @var{filename} at line @var{linenum}. + +The third field, @var{flag}, may be a number, or may be absent. It is +@samp{1} for the beginning of a new source file, and @samp{2} for return +to an old source file at the end of an included file. It is absent +otherwise. @node Invocation,, Output, Top @section Invoking the C Preprocessor