diff options
author | Sandra Loosemore <sandra@codesourcery.com> | 2016-01-12 19:40:41 -0500 |
---|---|---|
committer | Sandra Loosemore <sandra@gcc.gnu.org> | 2016-01-12 19:40:41 -0500 |
commit | ad9c3d9d460780261962b8a2fc3d647fdd717593 (patch) | |
tree | 0b78d052bba9b829de98bea8f025b8dc06cf0b44 /gcc | |
parent | 3a07f62555faf6d8a014f448085760a2132f5d13 (diff) | |
download | gcc-ad9c3d9d460780261962b8a2fc3d647fdd717593.zip gcc-ad9c3d9d460780261962b8a2fc3d647fdd717593.tar.gz gcc-ad9c3d9d460780261962b8a2fc3d647fdd717593.tar.bz2 |
2016-01-12 Sandra Loosemore <sandra@codesourcery.com>
gcc/
* doc/invoke.texi (Option Summary) Move -no-canonical-prefixes to
Directory Options, and -specs= to Overall Options.
(Overall Options): Adjust similarly. Reorder to group related
options together. Make -specs= cross-reference the spec file details.
(Directory Options): Adjust similarly.
From-SVN: r232306
Diffstat (limited to 'gcc')
-rw-r--r-- | gcc/ChangeLog | 8 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 71 |
2 files changed, 44 insertions, 35 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 3c2cf3f..07a6a41 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,11 @@ +2016-01-12 Sandra Loosemore <sandra@codesourcery.com> + + * doc/invoke.texi (Option Summary) Move -no-canonical-prefixes to + Directory Options, and -specs= to Overall Options. + (Overall Options): Adjust similarly. Reorder to group related + options together. Make -specs= cross-reference the spec file details. + (Directory Options): Adjust similarly. + 2016-01-12 Jeff Law <law@redhat.com> * tree-ssa-threadupdate.c: Various whitespace and typo fixes. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index d77346d..3bbc267 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -166,10 +166,10 @@ in the following sections. @table @emph @item Overall Options @xref{Overall Options,,Options Controlling the Kind of Output}. -@gccoptlist{-c -S -E -o @var{file} -no-canonical-prefixes @gol --pipe -pass-exit-codes @gol --x @var{language} -v -### --help@r{[}=@var{class}@r{[},@dots{}@r{]]} --target-help @gol ---version -wrapper @@@var{file} -fplugin=@var{file} -fplugin-arg-@var{name}=@var{arg} @gol +@gccoptlist{-c -S -E -o @var{file} -x @var{language} @gol +-v -### --help@r{[}=@var{class}@r{[},@dots{}@r{]]} --target-help --version @gol +-pass-exit-codes -pipe -specs=@var{file} -wrapper @gol +@@@var{file} -fplugin=@var{file} -fplugin-arg-@var{name}=@var{arg} @gol -fdump-ada-spec@r{[}-slim@r{]} -fada-spec-parent=@var{unit} -fdump-go-spec=@var{file}} @item C Language Options @@ -513,7 +513,7 @@ Objective-C and Objective-C++ Dialects}. @item Directory Options @xref{Directory Options,,Options for Directory Search}. @gccoptlist{-B@var{prefix} -I@var{dir} -iplugindir=@var{dir} @gol --iquote@var{dir} -L@var{dir} -specs=@var{file} -I- @gol +-iquote@var{dir} -L@var{dir} -no-canonical-prefixes -I- @gol --sysroot=@var{dir} --no-sysroot-suffix} @item Machine Dependent Options @@ -1342,15 +1342,6 @@ java Turn off any specification of a language, so that subsequent files are handled according to their file name suffixes (as they are if @option{-x} has not been used at all). - -@item -pass-exit-codes -@opindex pass-exit-codes -Normally the @command{gcc} program exits with the code of 1 if any -phase of the compiler returns a non-success return code. If you specify -@option{-pass-exit-codes}, the @command{gcc} program instead returns with -the numerically highest error produced by any phase returning an error -indication. The C, C++, and Fortran front ends return 4 if an internal -compiler error is encountered. @end table If you only want some of the stages of compilation, you can use @@ -1417,13 +1408,6 @@ Like @option{-v} except the commands are not executed and arguments are quoted unless they contain only alphanumeric characters or @code{./-_}. This is useful for shell scripts to capture the driver-generated command lines. -@item -pipe -@opindex pipe -Use pipes rather than temporary files for communication between the -various stages of compilation. This fails to work on some systems where -the assembler is unable to read from a pipe; but the GNU assembler has -no trouble. - @item --help @opindex help Print (on the standard output) a description of the command-line options @@ -1556,16 +1540,36 @@ gcc -c -Q -O2 --help=optimizers > /tmp/O2-opts diff /tmp/O2-opts /tmp/O3-opts | grep enabled @end smallexample -@item -no-canonical-prefixes -@opindex no-canonical-prefixes -Do not expand any symbolic links, resolve references to @samp{/../} -or @samp{/./}, or make the path absolute when generating a relative -prefix. - @item --version @opindex version Display the version number and copyrights of the invoked GCC@. +@item -pass-exit-codes +@opindex pass-exit-codes +Normally the @command{gcc} program exits with the code of 1 if any +phase of the compiler returns a non-success return code. If you specify +@option{-pass-exit-codes}, the @command{gcc} program instead returns with +the numerically highest error produced by any phase returning an error +indication. The C, C++, and Fortran front ends return 4 if an internal +compiler error is encountered. + +@item -pipe +@opindex pipe +Use pipes rather than temporary files for communication between the +various stages of compilation. This fails to work on some systems where +the assembler is unable to read from a pipe; but the GNU assembler has +no trouble. + +@item -specs=@var{file} +@opindex specs +Process @var{file} after the compiler reads in the standard @file{specs} +file, in order to override the defaults which the @command{gcc} driver +program uses when determining what switches to pass to @command{cc1}, +@command{cc1plus}, @command{as}, @command{ld}, etc. More than one +@option{-specs=@var{file}} can be specified on the command line, and they +are processed in order, from left to right. @xref{Spec Files}, for +information about the format of the @var{file}. + @item -wrapper @opindex wrapper Invoke all subcommands under a wrapper program. The name of the @@ -11778,14 +11782,11 @@ As a special kludge, if the path provided by @option{-B} is 9, then it is replaced by @file{[dir/]include}. This is to help with boot-strapping the compiler. -@item -specs=@var{file} -@opindex specs -Process @var{file} after the compiler reads in the standard @file{specs} -file, in order to override the defaults which the @command{gcc} driver -program uses when determining what switches to pass to @command{cc1}, -@command{cc1plus}, @command{as}, @command{ld}, etc. More than one -@option{-specs=@var{file}} can be specified on the command line, and they -are processed in order, from left to right. +@item -no-canonical-prefixes +@opindex no-canonical-prefixes +Do not expand any symbolic links, resolve references to @samp{/../} +or @samp{/./}, or make the path absolute when generating a relative +prefix. @item --sysroot=@var{dir} @opindex sysroot |