OpenE2K
/
gcc
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

invoke.texi: Correct usage of "command line" (noun) vs "command-line" (adjective) throughout. 

2012-01-27  Sandra Loosemore  <sandra@codesourcery.com>

	gcc/
	* doc/invoke.texi: Correct usage of "command line" (noun)
	vs "command-line" (adjective) throughout.

From-SVN: r183603
This commit is contained in:
Sandra Loosemore 2012-01-27 00:13:03 -05:00 committed by Sandra Loosemore
parent e3bd34b856
commit cb485fff38
2 changed files with 36 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gcc/ChangeLog
View File

@ -1,3 +1,8 @@
2012-01-27 Sandra Loosemore <sandra@codesourcery.com>
* doc/invoke.texi: Correct usage of "command line" (noun)
vs "command-line" (adjective) throughout.
2012-01-27 Sandra Loosemore <sandra@codesourcery.com> 2012-01-27 Sandra Loosemore <sandra@codesourcery.com>
* doc/invoke.texi (Language Independent Options): Move * doc/invoke.texi (Language Independent Options): Move

62
gcc/doc/invoke.texi
View File

@ -83,7 +83,7 @@ options control the assembler and linker; most of these are not
documented here, since you rarely need to use any of them. documented here, since you rarely need to use any of them.
@cindex C compilation options @cindex C compilation options
Most of the command line options that you can use with GCC are useful Most of the command-line options that you can use with GCC are useful
for C programs; when an option is only useful with another language for C programs; when an option is only useful with another language
(usually C++), the explanation says so explicitly. If the description (usually C++), the explanation says so explicitly. If the description
for a particular option does not mention a source language, you can use for a particular option does not mention a source language, you can use
@ -1247,22 +1247,22 @@ no trouble.
@item --help @item --help
@opindex help @opindex help
Print (on the standard output) a description of the command line options Print (on the standard output) a description of the command-line options
understood by @command{gcc}. If the @option{-v} option is also specified understood by @command{gcc}. If the @option{-v} option is also specified
then @option{--help} will also be passed on to the various processes then @option{--help} will also be passed on to the various processes
invoked by @command{gcc}, so that they can display the command line options invoked by @command{gcc}, so that they can display the command-line options
they accept. If the @option{-Wextra} option has also been specified they accept. If the @option{-Wextra} option has also been specified
(prior to the @option{--help} option), then command line options which (prior to the @option{--help} option), then command-line options which
have no documentation associated with them will also be displayed. have no documentation associated with them will also be displayed.
@item --target-help @item --target-help
@opindex target-help @opindex target-help
Print (on the standard output) a description of target-specific command Print (on the standard output) a description of target-specific command-line
line options for each tool. For some targets extra target-specific options for each tool. For some targets extra target-specific
information may also be printed. information may also be printed.
@item --help=@{@var{class}@r{|[}^@r{]}@var{qualifier}@}@r{[},@dots{}@r{]} @item --help=@{@var{class}@r{|[}^@r{]}@var{qualifier}@}@r{[},@dots{}@r{]}
Print (on the standard output) a description of the command line Print (on the standard output) a description of the command-line
options understood by the compiler that fit into all specified classes options understood by the compiler that fit into all specified classes
and qualifiers. These are the supported classes: and qualifiers. These are the supported classes:
@ -1360,7 +1360,7 @@ Here is a truncated example from the ARM port of @command{gcc}:
-mapcs [disabled] -mapcs [disabled]
@end smallexample @end smallexample
The output is sensitive to the effects of previous command line The output is sensitive to the effects of previous command-line
options, so for example it is possible to find out which optimizations options, so for example it is possible to find out which optimizations
are enabled at @option{-O2} by using: are enabled at @option{-O2} by using:
@ -1858,7 +1858,7 @@ basic integer types such as @code{int} are signed types.
@section Options Controlling C++ Dialect @section Options Controlling C++ Dialect
@cindex compiler options, C++ @cindex compiler options, C++
@cindex C++ options, command line @cindex C++ options, command-line
@cindex options, C++ @cindex options, C++
This section describes the command-line options that are only meaningful This section describes the command-line options that are only meaningful
for C++ programs; but you can also use most of the GNU compiler options for C++ programs; but you can also use most of the GNU compiler options
@ -2595,7 +2595,7 @@ In this example, G++ will synthesize a default @samp{A& operator =
@section Options Controlling Objective-C and Objective-C++ Dialects @section Options Controlling Objective-C and Objective-C++ Dialects
@cindex compiler options, Objective-C and Objective-C++ @cindex compiler options, Objective-C and Objective-C++
@cindex Objective-C and Objective-C++ options, command line @cindex Objective-C and Objective-C++ options, command-line
@cindex options, Objective-C and Objective-C++ @cindex options, Objective-C and Objective-C++
(NOTE: This manual does not describe the Objective-C and Objective-C++ (NOTE: This manual does not describe the Objective-C and Objective-C++
languages themselves. @xref{Standards,,Language Standards languages themselves. @xref{Standards,,Language Standards
@ -2754,7 +2754,7 @@ suppresses this behavior and causes calls to @code{objc_getClass("@dots{}")}
to be retained. This is useful in Zero-Link debugging mode, since it allows to be retained. This is useful in Zero-Link debugging mode, since it allows
for individual class implementations to be modified during program execution. for individual class implementations to be modified during program execution.
The GNU runtime currently always retains calls to @code{objc_get_class("@dots{}")} The GNU runtime currently always retains calls to @code{objc_get_class("@dots{}")}
regardless of command line options. regardless of command-line options.
@item -gen-decls @item -gen-decls
@opindex gen-decls @opindex gen-decls
@ -2865,7 +2865,7 @@ a message which is too long to fit on a single line.
@opindex fno-diagnostics-show-option @opindex fno-diagnostics-show-option
@opindex fdiagnostics-show-option @opindex fdiagnostics-show-option
By default, each diagnostic emitted includes text which indicates the By default, each diagnostic emitted includes text which indicates the
command line option that directly controls the diagnostic (if such an command-line option that directly controls the diagnostic (if such an
option is known to the diagnostic machinery). Specifying the option is known to the diagnostic machinery). Specifying the
@option{-fno-diagnostics-show-option} flag suppresses that behavior. @option{-fno-diagnostics-show-option} flag suppresses that behavior.
@ -3688,9 +3688,9 @@ This warning is enabled by @option{-Wall} or @option{-Wextra}.
@cindex unknown pragmas, warning @cindex unknown pragmas, warning
@cindex pragmas, warning of unknown @cindex pragmas, warning of unknown
Warn when a #pragma directive is encountered which is not understood by Warn when a #pragma directive is encountered which is not understood by
GCC@. If this command line option is used, warnings will even be issued GCC@. If this command-line option is used, warnings will even be issued
for unknown pragmas in system header files. This is not the case if for unknown pragmas in system header files. This is not the case if
the warnings were only enabled by the @option{-Wall} command line option. the warnings were only enabled by the @option{-Wall} command-line option.
@item -Wno-pragmas @item -Wno-pragmas
@opindex Wno-pragmas @opindex Wno-pragmas
@ -3846,7 +3846,7 @@ obtaining infinities and NaNs.
Print warning messages for constructs found in system header files. Print warning messages for constructs found in system header files.
Warnings from system headers are normally suppressed, on the assumption Warnings from system headers are normally suppressed, on the assumption
that they usually do not indicate real problems and would only make the that they usually do not indicate real problems and would only make the
compiler output harder to read. Using this command line option tells compiler output harder to read. Using this command-line option tells
GCC to emit warnings from system headers as if they occurred in user GCC to emit warnings from system headers as if they occurred in user
code. However, note that using @option{-Wall} in conjunction with this code. However, note that using @option{-Wall} in conjunction with this
option will @emph{not} warn about unknown pragmas in system option will @emph{not} warn about unknown pragmas in system
@ -4787,7 +4787,7 @@ for maximum benefit.
@item -grecord-gcc-switches @item -grecord-gcc-switches
@opindex grecord-gcc-switches @opindex grecord-gcc-switches
This switch causes the command line options, that were used to invoke the This switch causes the command-line options, that were used to invoke the
compiler and may affect code generation, to be appended to the compiler and may affect code generation, to be appended to the
DW_AT_producer attribute in DWARF debugging information. The options DW_AT_producer attribute in DWARF debugging information. The options
are concatenated with spaces separating them from each other and from are concatenated with spaces separating them from each other and from
@ -4796,7 +4796,7 @@ way of storing compiler options into the object file.
@item -gno-record-gcc-switches @item -gno-record-gcc-switches
@opindex gno-record-gcc-switches @opindex gno-record-gcc-switches
Disallow appending command line options to the DW_AT_producer attribute Disallow appending command-line options to the DW_AT_producer attribute
in DWARF debugging information. This is the default. in DWARF debugging information. This is the default.
@item -gstrict-dwarf @item -gstrict-dwarf
@ -5617,7 +5617,7 @@ Dump after function inlining.
@item -fdump-passes @item -fdump-passes
@opindex fdump-passes @opindex fdump-passes
Dump the list of optimization passes that are turned on and off by Dump the list of optimization passes that are turned on and off by
the current command line options. the current command-line options.
@item -fdump-statistics-@var{option} @item -fdump-statistics-@var{option}
@opindex fdump-statistics @opindex fdump-statistics
@ -5895,7 +5895,7 @@ compiling @file{foo.c} with @samp{-c -save-temps} would produce files
preprocessed @file{foo.i} output file even though the compiler now preprocessed @file{foo.i} output file even though the compiler now
normally uses an integrated preprocessor. normally uses an integrated preprocessor.
When used in combination with the @option{-x} command line option, When used in combination with the @option{-x} command-line option,
@option{-save-temps} is sensible enough to avoid over writing an @option{-save-temps} is sensible enough to avoid over writing an
input source file with the same extension as an intermediate file. input source file with the same extension as an intermediate file.
The corresponding intermediate file may be obtained by renaming the The corresponding intermediate file may be obtained by renaming the
@ -8247,7 +8247,7 @@ The default is @option{-fno-rounding-math}.
This option is experimental and does not currently guarantee to This option is experimental and does not currently guarantee to
disable all GCC optimizations that are affected by rounding mode. disable all GCC optimizations that are affected by rounding mode.
Future versions of GCC may provide finer control of this setting Future versions of GCC may provide finer control of this setting
using C99's @code{FENV_ACCESS} pragma. This command line option using C99's @code{FENV_ACCESS} pragma. This command-line option
will be used to specify the default state for @code{FENV_ACCESS}. will be used to specify the default state for @code{FENV_ACCESS}.
@item -fsignaling-nans @item -fsignaling-nans
@ -8481,7 +8481,7 @@ Not all targets support this option.
In some places, GCC uses various constants to control the amount of In some places, GCC uses various constants to control the amount of
optimization that is done. For example, GCC will not inline functions optimization that is done. For example, GCC will not inline functions
that contain more that a certain number of instructions. You can that contain more that a certain number of instructions. You can
control some of these constants on the command-line using the control some of these constants on the command line using the
@option{--param} option. @option{--param} option.
The names of specific parameters, and the meaning of the values, are The names of specific parameters, and the meaning of the values, are
@ -10139,7 +10139,7 @@ If that switch was not specified, this substitutes nothing. Note that
the leading dash is omitted when specifying this option, and it is the leading dash is omitted when specifying this option, and it is
automatically inserted if the substitution is performed. Thus the spec automatically inserted if the substitution is performed. Thus the spec
string @samp{%@{foo@}} would match the command-line option @option{-foo} string @samp{%@{foo@}} would match the command-line option @option{-foo}
and would output the command line option @option{-foo}. and would output the command-line option @option{-foo}.
@item %W@{@code{S}@} @item %W@{@code{S}@}
Like %@{@code{S}@} but mark last argument supplied within as a file to be Like %@{@code{S}@} but mark last argument supplied within as a file to be
@ -11119,9 +11119,9 @@ following situations:
@item Taking address of a function or code label. @item Taking address of a function or code label.
@item Computed goto. @item Computed goto.
@item If prologue-save function is used, see @option{-mcall-prologues} @item If prologue-save function is used, see @option{-mcall-prologues}
command line option. command-line option.
@item Switch/case dispatch tables. If you do not want such dispatch @item Switch/case dispatch tables. If you do not want such dispatch
tables you can specify the @option{-fno-jump-tables} command line option. tables you can specify the @option{-fno-jump-tables} command-line option.
@item C and C++ constructors/destructors called during startup/shutdown. @item C and C++ constructors/destructors called during startup/shutdown.
@item If the tools hit a @code{gs()} modifier explained above. @item If the tools hit a @code{gs()} modifier explained above.
@end itemize @end itemize
@ -11166,7 +11166,7 @@ Alternatively, @code{func_4} can be defined in the linker script.
avr-gcc defines several built-in macros so that the user code can test avr-gcc defines several built-in macros so that the user code can test
for presence of absence of features. Almost any of the following for presence of absence of features. Almost any of the following
built-in macros are deduced from device capabilities and thus built-in macros are deduced from device capabilities and thus
triggered by the @code{-mmcu=} command line option. triggered by the @code{-mmcu=} command-line option.
For even more AVR-specific built-in macros see For even more AVR-specific built-in macros see
@ref{AVR Named Address Spaces} and @ref{AVR Built-in Functions}. @ref{AVR Named Address Spaces} and @ref{AVR Built-in Functions}.
@ -14753,7 +14753,7 @@ one or more modules in it; each module has a core CPU and a variety of
coprocessors, optional instructions, and peripherals. The coprocessors, optional instructions, and peripherals. The
@code{MeP-Integrator} tool, not part of GCC, provides these @code{MeP-Integrator} tool, not part of GCC, provides these
configurations through this option; using this option is the same as configurations through this option; using this option is the same as
using all the corresponding command line options. The default using all the corresponding command-line options. The default
configuration is @code{default}. configuration is @code{default}.
@item -mcop @item -mcop
@ -17155,7 +17155,7 @@ pointer. The @option{-mno-save-toc-indirect} option is the default.
@subsection RX Options @subsection RX Options
@cindex RX Options @cindex RX Options
These command line options are defined for RX targets: These command-line options are defined for RX targets:
@table @gcctabopt @table @gcctabopt
@item -m64bit-doubles @item -m64bit-doubles
@ -17301,7 +17301,7 @@ larger code, especially in complicated functions.
The actual register chosen to hold the constant data base address The actual register chosen to hold the constant data base address
depends upon whether the @option{-msmall-data-limit} and/or the depends upon whether the @option{-msmall-data-limit} and/or the
@option{-mint-register} command line options are enabled. Starting @option{-mint-register} command-line options are enabled. Starting
with register @code{r13} and proceeding downwards, registers are with register @code{r13} and proceeding downwards, registers are
allocated first to satisfy the requirements of @option{-mint-register}, allocated first to satisfy the requirements of @option{-mint-register},
then @option{-mpid} and finally @option{-msmall-data-limit}. Thus it then @option{-mpid} and finally @option{-msmall-data-limit}. Thus it
@ -17310,18 +17310,18 @@ is possible for the small data area register to be @code{r8} if both
command line. command line.
By default this feature is not enabled. The default can be restored By default this feature is not enabled. The default can be restored
via the @option{-mno-pid} command line option. via the @option{-mno-pid} command-line option.
@end table @end table
@emph{Note:} The generic GCC command line @option{-ffixed-@var{reg}} @emph{Note:} The generic GCC command-line option @option{-ffixed-@var{reg}}
has special significance to the RX port when used with the has special significance to the RX port when used with the
@code{interrupt} function attribute. This attribute indicates a @code{interrupt} function attribute. This attribute indicates a
function intended to process fast interrupts. GCC will will ensure function intended to process fast interrupts. GCC will will ensure
that it only uses the registers @code{r10}, @code{r11}, @code{r12} that it only uses the registers @code{r10}, @code{r11}, @code{r12}
and/or @code{r13} and only provided that the normal use of the and/or @code{r13} and only provided that the normal use of the
corresponding registers have been restricted via the corresponding registers have been restricted via the
@option{-ffixed-@var{reg}} or @option{-mint-register} command line @option{-ffixed-@var{reg}} or @option{-mint-register} command-line
options. options.
@node S/390 and zSeries Options @node S/390 and zSeries Options