From patchwork Fri Jan 27 05:46:32 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 138184 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) by ozlabs.org (Postfix) with SMTP id D69D81007D2 for ; Fri, 27 Jan 2012 16:49:13 +1100 (EST) Comment: DKIM? See http://www.dkim.org DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=gcc.gnu.org; s=default; x=1328248154; h=Comment: DomainKey-Signature:Received:Received:Received:Received:Received: Received:Message-ID:Date:From:User-Agent:MIME-Version:To:Subject: Content-Type:Mailing-List:Precedence:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:Sender:Delivered-To; bh=4yo1xr1 HgZqTrmhr1GJfAj8moVA=; b=iSTH9yW0cy5S5pB3Eau8yPVD5BvBU7xve3BZRvq A1YMoLtIrsZxFTmdcZqBt+7w78v+8SijSgITtvnlSxdCsZdB1re3yNUqlixGwMaq zCe9vsWdyilSWxdvPrJ2HSHiZ09/0+XmPQNjod5te4Zm4J0fssVrjWhKLALKqnZp QIbw= Comment: DomainKeys? See http://antispam.yahoo.com/domainkeys DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=default; d=gcc.gnu.org; h=Received:Received:X-SWARE-Spam-Status:X-Spam-Check-By:Received:Received:Received:Received:Message-ID:Date:From:User-Agent:MIME-Version:To:Subject:Content-Type:Mailing-List:Precedence:List-Id:List-Unsubscribe:List-Archive:List-Post:List-Help:Sender:Delivered-To; b=imIN0wUbYoMdavdd2Yf/hpvo68aeqs/y1ldEmz0QEcnVbVDJSxtNF4r2/UjN7/ oMa/hW7Qzl8B1qxnj6g+1PB7gqEJBZHg7Zy/N1f76d+LMULlP343cGjJf/fnjItp l6L6HOo91QbtanHw/4WBuzdo92aNY3BPTTzkLAmHf+XtY=; Received: (qmail 9710 invoked by alias); 27 Jan 2012 05:49:08 -0000 Received: (qmail 9702 invoked by uid 22791); 27 Jan 2012 05:49:05 -0000 X-SWARE-Spam-Status: No, hits=-0.4 required=5.0 tests=AWL, BAYES_00, FROM_12LTRDOM X-Spam-Check-By: sourceware.org Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 27 Jan 2012 05:48:51 +0000 Received: from svr-orw-fem-01.mgc.mentorg.com ([147.34.98.93]) by relay1.mentorg.com with esmtp id 1Rqeg5-0005kw-Ov from Sandra_Loosemore@mentor.com for gcc-patches@gcc.gnu.org; Thu, 26 Jan 2012 21:48:49 -0800 Received: from SVR-ORW-FEM-03.mgc.mentorg.com ([147.34.97.39]) by svr-orw-fem-01.mgc.mentorg.com over TLS secured channel with Microsoft SMTPSVC(6.0.3790.4675); Thu, 26 Jan 2012 21:48:49 -0800 Received: from [IPv6:::1] (147.34.91.1) by svr-orw-fem-03.mgc.mentorg.com (147.34.97.39) with Microsoft SMTP Server id 14.1.289.1; Thu, 26 Jan 2012 21:48:48 -0800 Message-ID: <4F223A38.3090105@codesourcery.com> Date: Thu, 26 Jan 2012 22:46:32 -0700 From: Sandra Loosemore User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.2.13) Gecko/20101208 Lightning/1.0b2 Thunderbird/3.1.7 MIME-Version: 1.0 To: Subject: [committed] invoke.texi: fix "command line" vs "command-line" usage Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org As listed in the GCC Coding Conventions http://gcc.gnu.org/codingconventions.html "command line" is a noun phrase, and the adjective form is hyphenated, as in "command-line option". Since invoke.texi talks a lot about command-line options to GCC, we ought to describe them correctly. ;-) I've checked in this patch as obvious. I have close to 500KB of similar kinds of content-free copy-editing patches to invoke.texi in my queue; does anyone really want to review them, or object to me just continuing to check them in piecewise like this? -Sandra 2012-01-27 Sandra Loosemore gcc/ * doc/invoke.texi: Correct usage of "command line" (noun) vs "command-line" (adjective) throughout. Index: gcc/doc/invoke.texi =================================================================== --- gcc/doc/invoke.texi (revision 183602) +++ gcc/doc/invoke.texi (working copy) @@ -83,7 +83,7 @@ options control the assembler and linker documented here, since you rarely need to use any of them. @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 (usually C++), the explanation says so explicitly. If the description for a particular option does not mention a source language, you can use @@ -1247,22 +1247,22 @@ no trouble. @item --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 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 -(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. @item --target-help @opindex target-help -Print (on the standard output) a description of target-specific command -line options for each tool. For some targets extra target-specific +Print (on the standard output) a description of target-specific command-line +options for each tool. For some targets extra target-specific information may also be printed. @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 and qualifiers. These are the supported classes: @@ -1360,7 +1360,7 @@ Here is a truncated example from the ARM -mapcs [disabled] @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 are enabled at @option{-O2} by using: @@ -1858,7 +1858,7 @@ basic integer types such as @code{int} a @section Options Controlling C++ Dialect @cindex compiler options, C++ -@cindex C++ options, command line +@cindex C++ options, command-line @cindex options, C++ 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 @@ -2595,7 +2595,7 @@ In this example, G++ will synthesize a d @section Options Controlling Objective-C and Objective-C++ Dialects @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++ (NOTE: This manual does not describe the Objective-C and Objective-C++ languages themselves. @xref{Standards,,Language Standards @@ -2754,7 +2754,7 @@ suppresses this behavior and causes call to be retained. This is useful in Zero-Link debugging mode, since it allows for individual class implementations to be modified during program execution. 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 @opindex gen-decls @@ -2865,7 +2865,7 @@ a message which is too long to fit on a @opindex fno-diagnostics-show-option @opindex fdiagnostics-show-option 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{-fno-diagnostics-show-option} flag suppresses that behavior. @@ -3688,9 +3688,9 @@ This warning is enabled by @option{-Wall @cindex unknown pragmas, warning @cindex pragmas, warning of unknown 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 -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 @opindex Wno-pragmas @@ -3846,7 +3846,7 @@ obtaining infinities and NaNs. Print warning messages for constructs found in system header files. Warnings from system headers are normally suppressed, on the assumption 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 code. However, note that using @option{-Wall} in conjunction with this option will @emph{not} warn about unknown pragmas in system @@ -4787,7 +4787,7 @@ for maximum benefit. @item -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 DW_AT_producer attribute in DWARF debugging information. The options are concatenated with spaces separating them from each other and from @@ -4796,7 +4796,7 @@ way of storing compiler options into the @item -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. @item -gstrict-dwarf @@ -5617,7 +5617,7 @@ Dump after function inlining. @item -fdump-passes @opindex fdump-passes 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} @opindex fdump-statistics @@ -5895,7 +5895,7 @@ compiling @file{foo.c} with @samp{-c -sa preprocessed @file{foo.i} output file even though the compiler now 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 input source file with the same extension as an intermediate file. The corresponding intermediate file may be obtained by renaming the @@ -8247,7 +8247,7 @@ The default is @option{-fno-rounding-mat This option is experimental and does not currently guarantee to disable all GCC optimizations that are affected by rounding mode. 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}. @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 optimization that is done. For example, GCC will not inline functions 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. The names of specific parameters, and the meaning of the values, are @@ -10139,7 +10139,7 @@ If that switch was not specified, this s the leading dash is omitted when specifying this option, and it is automatically inserted if the substitution is performed. Thus the spec 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}@} 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 Computed goto. @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 -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 If the tools hit a @code{gs()} modifier explained above. @end itemize @@ -11166,7 +11166,7 @@ Alternatively, @code{func_4} can be defi 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 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 @ref{AVR Named Address Spaces} and @ref{AVR Built-in Functions}. @@ -14753,7 +14753,7 @@ one or more modules in it; each module h coprocessors, optional instructions, and peripherals. The @code{MeP-Integrator} tool, not part of GCC, provides these 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}. @item -mcop @@ -17155,7 +17155,7 @@ pointer. The @option{-mno-save-toc-indi @subsection 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 @item -m64bit-doubles @@ -17301,7 +17301,7 @@ larger code, especially in complicated f The actual register chosen to hold the constant data base address 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 allocated first to satisfy the requirements of @option{-mint-register}, then @option{-mpid} and finally @option{-msmall-data-limit}. Thus it @@ -17310,18 +17310,18 @@ is possible for the small data area regi command line. 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 -@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 @code{interrupt} function attribute. This attribute indicates a function intended to process fast interrupts. GCC will will ensure 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 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. @node S/390 and zSeries Options