diff options
author | Sandra Loosemore <sandra@codesourcery.com> | 2016-01-12 12:34:37 -0500 |
---|---|---|
committer | Sandra Loosemore <sandra@gcc.gnu.org> | 2016-01-12 12:34:37 -0500 |
commit | ee30410c37af792ec093aee52adc742ea2e7d03d (patch) | |
tree | cc226bb4e1a33c621cc141d59fa52bd96c05c573 | |
parent | cdf6119dad04dd912a8c3863880ee764f5ba3ba9 (diff) | |
download | gcc-ee30410c37af792ec093aee52adc742ea2e7d03d.zip gcc-ee30410c37af792ec093aee52adc742ea2e7d03d.tar.gz gcc-ee30410c37af792ec093aee52adc742ea2e7d03d.tar.bz2 |
invoke.texi (Invoking GCC): Copy-edit.
2016-01-12 Sandra Loosemore <sandra@codesourcery.com>
gcc/
* doc/invoke.texi (Invoking GCC): Copy-edit. Incorporate information
about name of GCC executable. Remove deleted node from menu.
(Directory Options) <-B>: Remove cross-reference to deleted node.
(Target Options): Delete section.
From-SVN: r232285
-rw-r--r-- | gcc/ChangeLog | 7 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 36 |
2 files changed, 23 insertions, 20 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 578717c..6fcf9b2 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,10 @@ +2016-01-12 Sandra Loosemore <sandra@codesourcery.com> + + * doc/invoke.texi (Invoking GCC): Copy-edit. Incorporate information + about name of GCC executable. Remove deleted node from menu. + (Directory Options) <-B>: Remove cross-reference to deleted node. + (Target Options): Delete section. + 2016-01-12 Christian Bruel <christian.bruel@st.com> PR target/69180 diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 77115a7..d77346d 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -72,8 +72,9 @@ assembly and linking. The ``overall options'' allow you to stop this process at an intermediate stage. For example, the @option{-c} option says not to run the linker. Then the output consists of object files output by the assembler. +@xref{Overall Options,,Options Controlling the Kind of Output}. -Other options are passed on to one stage of processing. Some options +Other options are passed on to one or more stages of processing. Some options control the preprocessor and others the compiler itself. Yet other options control the assembler and linker; most of these are not documented here, since you rarely need to use any of them. @@ -85,9 +86,18 @@ for C programs; when an option is only useful with another language for a particular option does not mention a source language, you can use that option with all supported languages. -@cindex C++ compilation options -@xref{Invoking G++,,Compiling C++ Programs}, for a summary of special -options for compiling C++ programs. +@cindex cross compiling +@cindex specifying machine version +@cindex specifying compiler version and target machine +@cindex compiler version, specifying +@cindex target machine, specifying +The usual way to run GCC is to run the executable called @command{gcc}, or +@command{@var{machine}-gcc} when cross-compiling, or +@command{@var{machine}-gcc-@var{version}} to run a specific version of GCC. +When you compile C++ programs, you should invoke GCC as @command{g++} +instead. @xref{Invoking G++,,Compiling C++ Programs}, +for information about the differences in behavior between @command{gcc} +and @code{g++} when compiling C++ programs. @cindex grouping options @cindex options, grouping @@ -137,7 +147,6 @@ only one of these two forms, whichever one is not the default. * Directory Options:: Where to find header files and libraries. Where to find the compiler executable files. * Spec Files:: How to pass switches to sub-processes. -* Target Options:: Running a cross-compiler, or an old version of GCC. * Submodel Options:: Specifying minor hardware or convention variations, such as 68010 vs 68020. * Code Gen Options:: Specifying conventions for function calls, data layout @@ -11733,7 +11742,8 @@ include files, and data files of the compiler itself. The compiler driver program runs one or more of the subprograms @command{cpp}, @command{cc1}, @command{as} and @command{ld}. It tries @var{prefix} as a prefix for each program it tries to run, both with and -without @samp{@var{machine}/@var{version}/} (@pxref{Target Options}). +without @samp{@var{machine}/@var{version}/} for the corresponding target +machine and compiler version. For each subprogram to be run, the compiler driver first tries the @option{-B} prefix, if any. If that name is not found, or if @option{-B} @@ -12409,20 +12419,6 @@ proper position among the other output files. @c man begin OPTIONS -@node Target Options -@section Specifying Target Machine and Compiler Version -@cindex target options -@cindex cross compiling -@cindex specifying machine version -@cindex specifying compiler version and target machine -@cindex compiler version, specifying -@cindex target machine, specifying - -The usual way to run GCC is to run the executable called @command{gcc}, or -@command{@var{machine}-gcc} when cross-compiling, or -@command{@var{machine}-gcc-@var{version}} to run a version other than the -one that was installed last. - @node Submodel Options @section Hardware Models and Configurations @cindex submodel options |