Mercurial > hg > CbC > CbC_gcc

comparison gcc/doc/cppopts.texi @ 131:84e7813d76e9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children 1830386684a0
comparison
equal deleted inserted replaced
111:04ced10e8804 131:84e7813d76e9
1 @c Copyright (C) 1999-2017 Free Software Foundation, Inc. 1 @c Copyright (C) 1999-2018 Free Software Foundation, Inc.
2 @c This is part of the CPP and GCC manuals. 2 @c This is part of the CPP and GCC manuals.
3 @c For copying conditions, see the file gcc.texi. 3 @c For copying conditions, see the file gcc.texi.
4 4
5 @c --------------------------------------------------------------------- 5 @c ---------------------------------------------------------------------
6 @c Options affecting the preprocessor 6 @c Options affecting the preprocessor
198 @option{-o} switch is understood to specify the dependency output file 198 @option{-o} switch is understood to specify the dependency output file
199 (@pxref{dashMF,,-MF}), but if used without @option{-E}, each @option{-o} 199 (@pxref{dashMF,,-MF}), but if used without @option{-E}, each @option{-o}
200 is understood to specify a target object file. 200 is understood to specify a target object file.
201 201
202 Since @option{-E} is not implied, @option{-MD} can be used to generate 202 Since @option{-E} is not implied, @option{-MD} can be used to generate
203 a dependency output file as a side-effect of the compilation process. 203 a dependency output file as a side effect of the compilation process.
204 204
205 @item -MMD 205 @item -MMD
206 @opindex MMD 206 @opindex MMD
207 Like @option{-MD} except mention only user header files, not system 207 Like @option{-MD} except mention only user header files, not system
208 header files. 208 header files.
285 When this option is given no argument, the default parameter value is 285 When this option is given no argument, the default parameter value is
286 @samp{2}. 286 @samp{2}.
287 287
288 Note that @code{-ftrack-macro-expansion=2} is activated by default. 288 Note that @code{-ftrack-macro-expansion=2} is activated by default.
289 289
290 @item -fmacro-prefix-map=@var{old}=@var{new}
291 @opindex fmacro-prefix-map
292 When preprocessing files residing in directory @file{@var{old}},
293 expand the @code{__FILE__} and @code{__BASE_FILE__} macros as if the
294 files resided in directory @file{@var{new}} instead. This can be used
295 to change an absolute path to a relative path by using @file{.} for
296 @var{new} which can result in more reproducible builds that are
297 location independent. This option also affects
298 @code{__builtin_FILE()} during compilation. See also
299 @option{-ffile-prefix-map}.
300
290 @item -fexec-charset=@var{charset} 301 @item -fexec-charset=@var{charset}
291 @opindex fexec-charset 302 @opindex fexec-charset
292 @cindex character set, execution 303 @cindex character set, execution
293 Set the execution character set, used for string and character 304 Set the execution character set, used for string and character
294 constants. The default is UTF-8. @var{charset} can be any encoding 305 constants. The default is UTF-8. @var{charset} can be any encoding
390 @opindex CC 401 @opindex CC
391 Do not discard comments, including during macro expansion. This is 402 Do not discard comments, including during macro expansion. This is
392 like @option{-C}, except that comments contained within macros are 403 like @option{-C}, except that comments contained within macros are
393 also passed through to the output file where the macro is expanded. 404 also passed through to the output file where the macro is expanded.
394 405
395 In addition to the side-effects of the @option{-C} option, the 406 In addition to the side effects of the @option{-C} option, the
396 @option{-CC} option causes all C++-style comments inside a macro 407 @option{-CC} option causes all C++-style comments inside a macro
397 to be converted to C-style comments. This is to prevent later use 408 to be converted to C-style comments. This is to prevent later use
398 of that macro from inadvertently commenting out the remainder of 409 of that macro from inadvertently commenting out the remainder of
399 the source line. 410 the source line.
400 411
532 @option{-E}, it dumps debugging information about location maps. Every 543 @option{-E}, it dumps debugging information about location maps. Every
533 token in the output is preceded by the dump of the map its location 544 token in the output is preceded by the dump of the map its location
534 belongs to. 545 belongs to.
535 546
536 When used from GCC without @option{-E}, this option has no effect. 547 When used from GCC without @option{-E}, this option has no effect.
537