This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: typos in the manual


* Daniel Jacobowitz wrote on Wed, Aug 09, 2006 at 03:15:58AM CEST:
> On Tue, Aug 08, 2006 at 09:27:42PM +0000, Joseph S. Myers wrote:
> > On Tue, 8 Aug 2006, Ralf Wildenhues wrote:
> > 
> > > should I redo the patch with all "non-" changes removed, but
> > > without any other "non-" changes added?
> > 
> > Yes; and remove the first change to c-tree.texi where the errors are 
> > deliberate.
> 
> The last time someone fixed that sentence didn't we request a comment
> asking to leave it alone?  If not, can I request such a comment now,
> please?

Updated patch below.

Cheers,
Ralf

	* doc/sourcebuild.texi: Fix some typos.
	* doc/extend.texi: Likewise.
	* doc/passes.texi: Likewise.
	* doc/cppinternals.texi: Likewise.
	* doc/tm.texi: Likewise.
	* doc/tree-ssa.texi: Likewise.
	* doc/invoke.texi: Likewise.
	* doc/rtl.texi: Likewise.
	* doc/install.texi: Likewise.
	* doc/c-tree.texi: Likewise.
	(Deficiencies): Mark deliberate typos.

Index: doc/sourcebuild.texi
===================================================================
--- doc/sourcebuild.texi	(Revision 116015)
+++ doc/sourcebuild.texi	(Arbeitskopie)
@@ -162,7 +162,7 @@
 @item po
 Message catalogs with translations of messages produced by GCC into
 various languages, @file{@var{language}.po}.  This directory also
-contains @file{gcc.pot}, the template for these message catalogues,
+contains @file{gcc.pot}, the template for these message catalogs,
 @file{exgettext}, a wrapper around @command{gettext} to extract the
 messages from the GCC sources and create @file{gcc.pot}, which is run
 by @samp{make gcc.pot}, and @file{EXCLUDES}, a list of files from
@@ -831,7 +831,7 @@
 @node Test Idioms
 @subsection Idioms Used in Testsuite Code
 
-In general C testcases have a trailing @file{-@var{n}.c}, starting
+In general, C testcases have a trailing @file{-@var{n}.c}, starting
 with @file{-1.c}, in case other testcases with similar names are added
 later.  If the test is a test of some well-defined feature, it should
 have a name referring to that feature such as
Index: doc/extend.texi
===================================================================
--- doc/extend.texi	(Revision 116015)
+++ doc/extend.texi	(Arbeitskopie)
@@ -1274,7 +1274,7 @@
 duration by compound literals (which is not possible in ISO C99, because
 the initializer is not a constant).
 It is handled as if the object was initialized only with the bracket
-enclosed list if compound literal's and object types match.
+enclosed list if compound literals and object types match.
 The initializer list of the compound literal must be constant.
 If the object being initialized has array type of unknown size, the size is
 determined by compound literal size.
@@ -3214,7 +3214,7 @@
 @item dllimport
 The @code{dllimport} attribute is described in @xref{Function Attributes}.
 
-@item dlexport
+@item dllexport
 The @code{dllexport} attribute is described in @xref{Function Attributes}.
 
 @end table
@@ -9757,7 +9757,7 @@
 @cindex pragma, diagnostic
 
 Modifies the disposition of a diagnostic.  Note that not all
-diagnostics are modifyiable; at the moment only warnings (normally
+diagnostics are modifiable; at the moment only warnings (normally
 controlled by @samp{-W...}) can be controlled, and not all of them.
 Use @option{-fdiagnostics-show-option} to determine which diagnostics
 are controllable and which option controls them.
@@ -10813,7 +10813,7 @@
 The implicit typename extension has been deprecated and is now
 removed from G++.
 
-The use of default arguments in function pointers, function typedefs and
+The use of default arguments in function pointers, function typedefs
 and other places where they are not permitted by the standard is
 deprecated and will be removed from a future version of G++.
 
Index: doc/passes.texi
===================================================================
--- doc/passes.texi	(Revision 116015)
+++ doc/passes.texi	(Arbeitskopie)
@@ -223,7 +223,7 @@
 
 @item Lower control flow
 
-This pass flattens @code{if} statements (@code{COND_EXPR}) and
+This pass flattens @code{if} statements (@code{COND_EXPR})
 and moves lexical bindings (@code{BIND_EXPR}) out of line.  After
 this pass, all @code{if} statements will have exactly two @code{goto}
 statements in its @code{then} and @code{else} arms.  Lexical binding
@@ -301,7 +301,7 @@
 value, excluding feedback.  Such degenerate forms are typically created
 by removing unreachable code.  The pass is run multiple times throughout
 the optimization process.  It is located in @file{tree-ssa.c} and is
-described by @code{pass_redundant_phi}.o
+described by @code{pass_redundant_phi}.
 
 @item Forward propagation of single-use variables
 
@@ -332,7 +332,7 @@
 The resulting may-alias, must-alias, and escape analysis information
 is used to promote variables from in-memory addressable objects to
 non-aliased variables that can be renamed into SSA form.  We also
-update the @code{VDEF}/@code{VUSE} memory tags for non-renamable
+update the @code{VDEF}/@code{VUSE} memory tags for non-renameable
 aggregates so that we get fewer false kills.  The pass is located
 in @file{tree-ssa-alias.c} and is described by @code{pass_may_alias}.
 
@@ -495,7 +495,7 @@
 @item Folding built-in functions
 
 This pass simplifies built-in functions, as applicable, with constant
-arguments or with inferrable string lengths.  It is located in
+arguments or with inferable string lengths.  It is located in
 @file{tree-ssa-ccp.c} and is described by @code{pass_fold_builtins}.
 
 @item Split critical edges
Index: doc/cppinternals.texi
===================================================================
--- doc/cppinternals.texi	(Revision 116015)
+++ doc/cppinternals.texi	(Arbeitskopie)
@@ -963,7 +963,7 @@
 on.
 
 Note that whilst we are inside the conditional block, @code{mi_valid} is
-likely to be reset to @code{false}, but this does not matter since the
+likely to be reset to @code{false}, but this does not matter since
 the closing @code{#endif} restores it to @code{true} if appropriate.
 
 Finally, since @code{_cpp_lex_direct} pops the file off the buffer stack
Index: doc/c-tree.texi
===================================================================
--- doc/c-tree.texi	(Revision 116015)
+++ doc/c-tree.texi	(Arbeitskopie)
@@ -64,6 +64,7 @@
 @node Deficiencies
 @section Deficiencies
 
+@c Fix the document before fixing the typos in the next sentence!
 There are many places in which this document is incomplet and incorrekt.
 It is, as of yet, only @emph{preliminary} documentation.
 
@@ -2124,7 +2125,7 @@
 
 @item FIX_TRUNC_EXPR
 These nodes represent conversion of a floating-point value to an
-integer.  The single operand will have a floating-point type, while the
+integer.  The single operand will have a floating-point type, while
 the complete expression will have an integral (or boolean) type.  The
 operand is rounded towards zero.
 
@@ -2203,7 +2204,7 @@
 
 @item TRUTH_ANDIF_EXPR
 @itemx TRUTH_ORIF_EXPR
-These nodes represent logical and and logical or, respectively.  These
+These nodes represent logical and @w{}and logical or, respectively.  These
 operators are not strict; i.e., the second operand is evaluated only if
 the value of the expression is not determined by evaluation of the first
 operand.  The type of the operands and that of the result are always of
Index: doc/tm.texi
===================================================================
--- doc/tm.texi	(Revision 116015)
+++ doc/tm.texi	(Arbeitskopie)
@@ -2333,7 +2333,7 @@
 reference affects whether a register may be used as a base register.  If
 you define this macro, the compiler will use it instead of
 @code{REGNO_OK_FOR_BASE_P}.  The mode may be @code{VOIDmode} for addresses
-that appear outside a @code{MEM}, i.e. as an @code{address_operand}.
+that appear outside a @code{MEM}, i.e., as an @code{address_operand}.
 
 @end defmac
 
@@ -2357,7 +2357,7 @@
 something that occurs in an @code{address_operand}).  @var{index_code} is the
 code of the corresponding index expression if @var{outer_code} is @code{PLUS};
 @code{SCRATCH} otherwise.  The mode may be @code{VOIDmode} for addresses
-that appear outside a @code{MEM}, i.e. as an @code{address_operand}.
+that appear outside a @code{MEM}, i.e., as an @code{address_operand}.
 @end defmac
 
 @defmac REGNO_OK_FOR_INDEX_P (@var{num})
@@ -5183,7 +5183,7 @@
 
 @findex copy_rtx
 If you want to change only a part of @var{x}, one standard way of doing
-this is to use @code{copy_rtx}.  Note, however, that is unshares only a
+this is to use @code{copy_rtx}.  Note, however, that it unshares only a
 single level of rtl.  Thus, if the part to be changed is not at the
 top level, you'll need to replace first the top level.
 It is not necessary for this macro to come up with a legitimate
@@ -5249,7 +5249,7 @@
 used to extract from two vectors the relevant data that resides in
 @var{addr} in case @var{addr} is not properly aligned.
 
-The autovectrizer, when vectorizing a load operation from an address
+The autovectorizer, when vectorizing a load operation from an address
 @var{addr} that may be unaligned, will generate two vector loads from
 the two aligned addresses around @var{addr}. It then generates a
 @code{REALIGN_LOAD} operation to extract the relevant data from the
@@ -8607,7 +8607,7 @@
 @deftypefn Macro REAL_VALUE_TYPE REAL_VALUE_TRUNCATE (REAL_VALUE_TYPE @var{mode}, enum machine_mode @var{x})
 Truncates the floating point value @var{x} to fit in @var{mode}.  The
 return value is still a full-size @code{REAL_VALUE_TYPE}, but it has an
-appropriate bit pattern to be output asa floating constant whose
+appropriate bit pattern to be output as a floating constant whose
 precision accords with mode @var{mode}.
 @end deftypefn
 
@@ -9274,7 +9274,7 @@
 machines, define the appropriate patterns.  Use the names @code{incscc}
 and @code{decscc}, respectively, for the patterns which perform
 @code{plus} or @code{minus} operations on condition code values.  See
-@file{rs6000.md} for some examples.  The GNU Superoptizer can be used to
+@file{rs6000.md} for some examples.  The GNU Superoptimizer can be used to
 find such instruction sequences on other machines.
 
 If this macro is not defined, the default value, 1, is used.  You need
Index: doc/tree-ssa.texi
===================================================================
--- doc/tree-ssa.texi	(Revision 116015)
+++ doc/tree-ssa.texi	(Arbeitskopie)
@@ -874,7 +874,7 @@
 Operands are updated as soon as the statement is finished via a call
 to @code{update_stmt}.  If statement elements are changed via
 @code{SET_USE} or @code{SET_DEF}, then no further action is required
-(ie, those macros take care of updating the statement).  If changes
+(i.e., those macros take care of updating the statement).  If changes
 are made by manipulating the statement's tree directly, then a call
 must be made to @code{update_stmt} when complete.  Calling one of the
 @code{bsi_insert} routines or @code{bsi_replace} performs an implicit
@@ -1110,7 +1110,7 @@
 @end smallexample
 
 There are 2 iterators which can be used. @code{FOR_EACH_IMM_USE_FAST} is used 
-when the immediate uses are not changed, ie. you are looking at the uses, but 
+when the immediate uses are not changed, i.e., you are looking at the uses, but 
 not setting them.  
 
 If they do get changed, then care must be taken that things are not changed 
Index: doc/invoke.texi
===================================================================
--- doc/invoke.texi	(Revision 116015)
+++ doc/invoke.texi	(Arbeitskopie)
@@ -1441,7 +1441,7 @@
 @samp{throw()}, in which case the compiler will always check the
 return value even without this option.  In all other cases, when
 @code{operator new} has a non-empty exception specification, memory
-exhaustion is signalled by throwing @code{std::bad_alloc}.  See also
+exhaustion is signaled by throwing @code{std::bad_alloc}.  See also
 @samp{new (nothrow)}.
 
 @item -fconserve-space
@@ -1617,7 +1617,7 @@
 on load and link times of a DSO as it massively reduces the size of the
 dynamic export table when the library makes heavy use of templates.
 
-The behaviour of this switch is not quite the same as marking the
+The behavior of this switch is not quite the same as marking the
 methods as hidden directly, because it does not affect static variables
 local to the function or cause the compiler to deduce that
 the function is defined in only one shared object.
@@ -4210,7 +4210,7 @@
 
 @item phiopt
 @opindex fdump-tree-phiopt
-Dump each function after optimizing PHI nodes into straightline code.  The file
+Dump each function after optimizing PHI nodes into straight-line code.  The file
 name is made by appending @file{.phiopt} to the source file name.
 
 @item forwprop
@@ -4254,7 +4254,7 @@
 If @var{n}=1 the vectorizer reports each loop that got vectorized, 
 and the total number of loops that got vectorized.
 If @var{n}=2 the vectorizer also reports non-vectorized loops that passed 
-the first analysis phase (vect_analyze_loop_form) - i.e. countable, 
+the first analysis phase (vect_analyze_loop_form) - i.e., countable, 
 inner-most, single-bb, single-entry/exit loops.  This is the same verbosity 
 level that @option{-fdump-tree-vect-stats} uses.
 Higher verbosity levels mean either more information dumped for each 
@@ -4263,7 +4263,7 @@
 If @var{n}=4, data-references related information (e.g. memory dependences, 
 memory access-patterns) is added to the reports.
 If @var{n}=5, the vectorizer reports also non-vectorized inner-most loops 
-that did not pass the first analysis phase (i.e. may not be countable, or 
+that did not pass the first analysis phase (i.e., may not be countable, or 
 may have complicated control-flow).
 If @var{n}=6, the vectorizer reports also non-vectorized nested loops.
 For @var{n}=7, all the information the vectorizer generates during its 
@@ -5969,7 +5969,7 @@
 For small units this might be too tight (consider unit consisting of function A
 that is inline and B that just calls A three time.  If B is small relative to
 A, the growth of unit is 300\% and yet such inlining is very sane.  For very
-large units consisting of small inlininable functions however the overall unit
+large units consisting of small inlineable functions however the overall unit
 growth limit is needed to avoid exponential explosion of code size.  Thus for
 smaller units, the size is increased to @option{--param large-unit-insns}
 before applying @option{--param inline-unit-growth}.  The default is 10000
@@ -5986,7 +5986,7 @@
 function can grow into by performing recursive inlining.
 
 For functions declared inline @option{--param max-inline-insns-recursive} is
-taken into acount.  For function not declared inline, recursive inlining
+taken into account.  For functions not declared inline, recursive inlining
 happens only when @option{-finline-functions} (included in @option{-O3}) is
 enabled and @option{--param max-inline-insns-recursive-auto} is used.  The
 default value is 450.
@@ -5996,7 +5996,7 @@
 Specifies maximum recursion depth used by the recursive inlining.
 
 For functions declared inline @option{--param max-inline-recursive-depth} is
-taken into acount.  For function not declared inline, recursive inlining
+taken into account.  For functions not declared inline, recursive inlining
 happens only when @option{-finline-functions} (included in @option{-O3}) is
 enabled and @option{--param max-inline-recursive-depth-auto} is used.  The
 default value is 450.
@@ -6199,7 +6199,7 @@
 value is 100.
 
 @item max-cselib-memory-locations
-The maximum number of memory locations cselib should take into acount.
+The maximum number of memory locations cselib should take into account.
 Increasing values mean more aggressive optimization, making the compile time
 increase with probably slightly better performance.  The default value is 500.
 
@@ -6262,7 +6262,7 @@
 @item integer-share-limit
 Small integer constants can use a shared data structure, reducing the
 compiler's memory usage and increasing its speed.  This sets the maximum
-value of a shared integer constant's.  The default value is 256.
+value of shared integer constants.  The default value is 256.
 
 @item min-virtual-mappings
 Specifies the minimum number of virtual mappings in the incremental
@@ -6277,7 +6277,7 @@
 ratio is 3.
 
 @item ssp-buffer-size
-The minimum size of buffers (i.e. arrays) that will receive stack smashing
+The minimum size of buffers (i.e., arrays) that will receive stack smashing
 protection when @option{-fstack-protection} is used.
 
 @item max-jump-thread-duplication-stmts
@@ -7993,7 +7993,7 @@
 
 The subtype of the file created (like @samp{ppc7400} or @samp{ppc970} or
 @samp{i686}) is determined by the flags that specify the ISA
-that GCC is targetting, like @option{-mcpu} or @option{-march}.  The
+that GCC is targeting, like @option{-mcpu} or @option{-march}.  The
 @option{-force_cpusubtype_ALL} option can be used to override this.
 
 The Darwin tools vary in their behavior when presented with an ISA
@@ -9065,7 +9065,7 @@
 @option{--with-ld} configure option, GCC's program search path, and
 finally by the user's @env{PATH}.  The linker used by GCC can be printed
 using @samp{which `gcc -print-prog-name=ld`}.  This option is only available
-on the 64 bit HP-UX GCC, i.e. configured with @samp{hppa*64*-*-hpux*}.
+on the 64 bit HP-UX GCC, i.e., configured with @samp{hppa*64*-*-hpux*}.
 
 @item -mhp-ld
 @opindex hp-ld
@@ -9078,7 +9078,7 @@
 configure option, GCC's program search path, and finally by the user's
 @env{PATH}.  The linker used by GCC can be printed using @samp{which
 `gcc -print-prog-name=ld`}.  This option is only available on the 64 bit
-HP-UX GCC, i.e. configured with @samp{hppa*64*-*-hpux*}.
+HP-UX GCC, i.e., configured with @samp{hppa*64*-*-hpux*}.
 
 @item -mlong-calls
 @opindex mno-long-calls
@@ -9232,24 +9232,24 @@
 @item k6
 AMD K6 CPU with MMX instruction set support.
 @item k6-2, k6-3
-Improved versions of AMD K6 CPU with MMX and 3dNOW! instruction set support.
+Improved versions of AMD K6 CPU with MMX and 3dNOW!@: instruction set support.
 @item athlon, athlon-tbird
-AMD Athlon CPU with MMX, 3dNOW!, enhanced 3dNOW! and SSE prefetch instructions
+AMD Athlon CPU with MMX, 3dNOW!, enhanced 3dNOW!@: and SSE prefetch instructions
 support.
 @item athlon-4, athlon-xp, athlon-mp
-Improved AMD Athlon CPU with MMX, 3dNOW!, enhanced 3dNOW! and full SSE
+Improved AMD Athlon CPU with MMX, 3dNOW!, enhanced 3dNOW!@: and full SSE
 instruction set support.
 @item k8, opteron, athlon64, athlon-fx
 AMD K8 core based CPUs with x86-64 instruction set support.  (This supersets
-MMX, SSE, SSE2, 3dNOW!, enhanced 3dNOW! and 64-bit instruction set extensions.)
+MMX, SSE, SSE2, 3dNOW!, enhanced 3dNOW!@: and 64-bit instruction set extensions.)
 @item winchip-c6
 IDT Winchip C6 CPU, dealt in same way as i486 with additional MMX instruction
 set support.
 @item winchip2
-IDT Winchip2 CPU, dealt in same way as i486 with additional MMX and 3dNOW!
+IDT Winchip2 CPU, dealt in same way as i486 with additional MMX and 3dNOW!@:
 instruction set support.
 @item c3
-Via C3 CPU with MMX and 3dNOW! instruction set support.  (No scheduling is
+Via C3 CPU with MMX and 3dNOW!@: instruction set support.  (No scheduling is
 implemented for this chip.)
 @item c3-2
 Via C3-2 CPU with MMX and SSE instruction set support.  (No scheduling is
@@ -9543,7 +9543,7 @@
 @opindex m3dnow
 @opindex mno-3dnow
 These switches enable or disable the use of instructions in the MMX,
-SSE, SSE2 or 3DNow! extended instruction sets.  These extensions are
+SSE, SSE2 or 3DNow!@: extended instruction sets.  These extensions are
 also available as built-in functions: see @ref{X86 Built-in Functions},
 for details of the functions enabled and disabled by these switches.
 
@@ -9836,7 +9836,7 @@
 @opindex -mno-sched-control-spec
 @opindex -msched-control-spec
 (Dis/En)able control speculative scheduling.  This feature is
-available only during region scheduling (i.e. before reload).
+available only during region scheduling (i.e., before reload).
 This will result in generation of the ld.s instructions and
 the corresponding check instructions chk.s .
 The default is 'disable'.
@@ -10511,7 +10511,7 @@
 @itemx -mno-mips16
 @opindex mips16
 @opindex mno-mips16
-Generate (do not generate) MIPS16 code.  If GCC is targetting a
+Generate (do not generate) MIPS16 code.  If GCC is targeting a
 MIPS32 or MIPS64 architecture, it will make use of the MIPS16e ASE@.
 
 @item -mabi=32
@@ -11591,7 +11591,7 @@
 @opindex mno-mulhw
 Generate code that uses (does not use) the half-word multiply and
 multiply-accumulate instructions on the IBM 405 and 440 processors.
-These instructions are generated by default when targetting those
+These instructions are generated by default when targeting those
 processors.
 
 @item -mdlmzb
@@ -11600,7 +11600,7 @@
 @opindex mno-dlmzb
 Generate code that uses (does not use) the string-search @samp{dlmzb}
 instruction on the IBM 405 and 440 processors.  This instruction is
-generated by default when targetting those processors.
+generated by default when targeting those processors.
 
 @item -mno-bit-align
 @itemx -mbit-align
@@ -11793,7 +11793,7 @@
 @opindex msim
 On embedded PowerPC systems, assume that the startup module is called
 @file{sim-crt0.o} and that the standard C libraries are @file{libsim.a} and
-@file{libc.a}.  This is the default for @samp{powerpc-*-eabisim}.
+@file{libc.a}.  This is the default for @samp{powerpc-*-eabisim}
 configurations.
 
 @item -mmvme
Index: doc/install.texi
===================================================================
--- doc/install.texi	(Revision 116015)
+++ doc/install.texi	(Arbeitskopie)
@@ -407,7 +407,7 @@
 Necessary when regenerating @file{Makefile} dependencies in libiberty.
 Necessary when regenerating @file{libiberty/functions.texi}.
 Necessary when generating manpages from Texinfo manuals.
-Necessary when targetting Darwin, building libstdc++,
+Necessary when targeting Darwin, building libstdc++,
 and not using @option{--disable-symvers}.
 Used by various scripts to generate some files included in SVN (mainly
 Unicode-related and rarely changing) from source tables.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]