2003-05-03  Paul A. Crable  <paul@crable.org>

	* doc/invoke.texi: Fixes to spelling, grammar, and diction.

--- invoke.texi.orig	2003-05-04 14:54:30.000000000 -0400
+++ invoke.texi	2003-05-04 15:22:05.000000000 -0400
@@ -5428,7 +5428,7 @@
 
 @item -m68881
 @opindex m68881
-Generate output containing 68881 instructions for floating point.
+Generate output containing 68881 floating point instructions.
 This is the default for most 68020 systems unless @option{--nfp} was
 specified when the compiler was configured.
 
@@ -5443,8 +5443,8 @@
 configured for 68040-based systems.
 
 This option inhibits the use of 68881/68882 instructions that have to be
-emulated by software on the 68040.  Use this option if your 68040 does not
-have code to emulate those instructions.
+emulated by software on the 68040.  Use this option if your 68040 cannot
+emulate those instructions by itself.
 
 @item -m68060
 @opindex m68060
@@ -5453,7 +5453,7 @@
 
 This option inhibits the use of 68020 and 68881/68882 instructions that
 have to be emulated by software on the 68060.  Use this option if your 68060
-does not have code to emulate those instructions.
+cannot emulate those instructions by itself.
 
 @item -mcpu32
 @opindex mcpu32
@@ -5466,7 +5466,7 @@
 
 @item -m5200
 @opindex m5200
-Generate output for a 520X ``coldfire'' family cpu.  This is the default
+Generate output for a 520X ``coldfire''-family CPU.  This is the default
 when the compiler is configured for 520X-based systems.
 
 Use this option for microcontroller with a 5200 core, including
@@ -5489,21 +5489,23 @@
 
 @item -mfpa
 @opindex mfpa
-Generate output containing Sun FPA instructions for floating point.
+Generate output containing Sun FPA instructions for floating point
+processing.
 
 @item -msoft-float
 @opindex msoft-float
-Generate output containing library calls for floating point.
+Generate output containing library calls for floating point processing.
 @strong{Warning:} the requisite libraries are not available for all m68k
-targets.  Normally the facilities of the machine's usual C compiler are
-used, but this can't be done directly in cross-compilation.  You must
+targets.  Normally the facilities of the native C compiler are
+used, but this cannot be done directly in cross-compilation.  You must
 make your own arrangements to provide suitable library functions for
 cross-compilation.  The embedded targets @samp{m68k-*-aout} and
 @samp{m68k-*-coff} do provide software floating point support.
 
 @item -mshort
 @opindex mshort
-Consider type @code{int} to be 16 bits wide, like @code{short int}.
+Force variables of type @code{int} to be 16 bits in width, like
+@code{short int}.
 
 @item -mnobitfield
 @opindex mnobitfield
@@ -5520,22 +5522,21 @@
 @opindex mrtd
 Use a different function-calling convention, in which functions
 that take a fixed number of arguments return with the @code{rtd}
-instruction, which pops their arguments while returning.  This
-saves one instruction in the caller since there is no need to pop
-the arguments there.
+instruction. @code{rtd} pops the arguments from the stack
+while returning, saving one instruction cycle.
 
-This calling convention is incompatible with the one normally
+This convention is incompatible with the one normally
 used on Unix, so you cannot use it if you need to call libraries
 compiled with the Unix compiler.
 
-Also, you must provide function prototypes for all functions that
-take variable numbers of arguments (including @code{printf});
-otherwise incorrect code will be generated for calls to those
-functions.
+If you set this option, you must provide function prototypes for 
+all functions that take variable numbers of arguments (such as 
+@code{printf}); otherwise those functions will not be called
+correctly.
 
 In addition, seriously incorrect code will result if you call a
-function with too many arguments.  (Normally, extra arguments are
-harmlessly ignored.)
+function with too many arguments.  This is unlike the normal 
+convention, where extra arguments are harmlessly ignored.
 
 The @code{rtd} instruction is supported by the 68010, 68020, 68030,
 68040, 68060 and CPU32 processors, but not by the 68000 or 5200.
@@ -5550,8 +5551,8 @@
 Aligning variables on 32-bit boundaries produces code that runs somewhat
 faster on processors with 32-bit busses at the expense of more memory.
 
-@strong{Warning:} if you use the @option{-malign-int} switch, GCC will
-align structures containing the above types  differently than
+@strong{Warning:} the @option{-malign-int} switch will cause GCC to
+align structures containing these types in a manner that differs from
 most published application binary interface specifications for the m68k.
 
 @item -mpcrel
@@ -5566,8 +5567,10 @@
 @itemx -mstrict-align
 @opindex mno-strict-align
 @opindex mstrict-align
-Do not (do) assume that unaligned memory references will be handled by
-the system.
+Control whether GCC will use strict memory alignment.  
+@option{-mno-strict-align} assumes that unaligned memory references will be
+handled by the system.  @option{-mstrict-align} may be required if
+the system cannot handle arbitrary memory references.
 
 @end table