Patchwork extend.texi: Fix grammatical problems with builtin machine function descriptions

login
register
mail settings
Submitter Nick Clifton
Date March 21, 2011, 11:30 a.m.
Message ID <m3d3lklnhh.fsf@redhat.com>
Download mbox | patch
Permalink /patch/87745/
State New
Headers show

Comments

Nick Clifton - March 21, 2011, 11:30 a.m.
Hi Gerald, Hi Joseph,

  I have a attached a mostly mechanical patch to fix a couple of very
  minor grammatical issues with the built-in machine function
  descriptions in the extend.texi file.  The first issue is with this
  sentence:

    They all generate the machine instruction that is part of the name

  The problem is that there is more than one name and that the name is a
  property of the built-in functions.  Thus I feel that it is more correct
  to say:
   
    They all generate the machine instruction that is part of their name


  The second issue is with a couple of sentences which say:

    The following built-in function is available when option <foo> is used.

  The problem here is that there is more than one built-in function that
  is enabled by <foo> options and so I feel that it is better to say:
 
    The following built-in functions are available when option <foo> is used.

    
  Checked by rebuilding the gcc documentation.
  OK to apply ?

Cheers
  Nick

gcc/ChangeLog
2011-03-21  Nick Clifton  <nickc@redhat.com>

	* doc/extend.texi (Alpha Built-in Functions, X86 Built-in
	Functions): Fix grammatical errors.

Patch

Index: gcc/doc/extend.texi
===================================================================
--- gcc/doc/extend.texi	(revision 171210)
+++ gcc/doc/extend.texi	(working copy)
@@ -7945,7 +7945,7 @@ 
 processors, depending on the command-line switches used.
 
 The following built-in functions are always available.  They
-all generate the machine instruction that is part of the name.
+all generate the machine instruction that is part of their name.
 
 @smallexample
 long __builtin_alpha_implver (void)
@@ -7981,7 +7981,7 @@ 
 The following built-in functions are always with @option{-mmax}
 or @option{-mcpu=@var{cpu}} where @var{cpu} is @code{pca56} or
 later.  They all generate the machine instruction that is part
-of the name.
+of their name.
 
 @smallexample
 long __builtin_alpha_pklb (long)
@@ -8002,7 +8002,7 @@ 
 The following built-in functions are always with @option{-mcix}
 or @option{-mcpu=@var{cpu}} where @var{cpu} is @code{ev67} or
 later.  They all generate the machine instruction that is part
-of the name.
+of their name.
 
 @smallexample
 long __builtin_alpha_cttz (long)
@@ -8649,7 +8649,7 @@ 
 floating point and @code{TC} 128-bit complex floating point values.
 
 The following floating point built-in functions are available in 64-bit
-mode.  All of them implement the function that is part of the name.
+mode.  All of them implement the function that is part of their name.
 
 @smallexample
 __float128 __builtin_fabsq (__float128)
@@ -8670,7 +8670,8 @@ 
 @end table
 
 The following built-in functions are made available by @option{-mmmx}.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their
+name.
 
 @smallexample
 v8qi __builtin_ia32_paddb (v8qi, v8qi)
@@ -8731,7 +8732,7 @@ 
 The following built-in functions are made available either with
 @option{-msse}, or with a combination of @option{-m3dnow} and
 @option{-march=athlon}.  All of them generate the machine
-instruction that is part of the name.
+instruction that is part of their name.
 
 @smallexample
 v4hi __builtin_ia32_pmulhuw (v4hi, v4hi)
@@ -8751,7 +8752,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-msse} is used.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their name.
 
 @smallexample
 int __builtin_ia32_comieq (v4sf, v4sf)
@@ -8850,7 +8851,7 @@ 
 @end table
 
 The following built-in functions are available when @option{-msse2} is used.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their name.
 
 @smallexample
 int __builtin_ia32_comisdeq (v2df, v2df)
@@ -9010,7 +9011,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-msse3} is used.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their name.
 
 @smallexample
 v2df __builtin_ia32_addsubpd (v2df, v2df)
@@ -9035,7 +9036,7 @@ 
 @end table
 
 The following built-in functions are available when @option{-mssse3} is used.
-All of them generate the machine instruction that is part of the name
+All of them generate the machine instruction that is part of their name
 with MMX registers.
 
 @smallexample
@@ -9058,7 +9059,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-mssse3} is used.
-All of them generate the machine instruction that is part of the name
+All of them generate the machine instruction that is part of their name
 with SSE registers.
 
 @smallexample
@@ -9081,7 +9082,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-msse4.1} is
-used.  All of them generate the machine instruction that is part of the
+used.  All of them generate the machine instruction that is part of their
 name.
 
 @smallexample
@@ -9159,7 +9160,7 @@ 
 @end table
 
 The following built-in functions are available when @option{-msse4.2} is
-used.  All of them generate the machine instruction that is part of the
+used.  All of them generate the machine instruction that is part of their
 name.
 
 @smallexample
@@ -9208,7 +9209,7 @@ 
 @end table
 
 The following built-in functions are available when @option{-mavx} is
-used. All of them generate the machine instruction that is part of the
+used. All of them generate the machine instruction that is part of their
 name.
 
 @smallexample
@@ -9343,8 +9344,8 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-maes} is
-used.  All of them generate the machine instruction that is part of the
-name.
+used.  All of them generate the machine instruction that is part of
+their name.
 
 @smallexample
 v2di __builtin_ia32_aesenc128 (v2di, v2di)
@@ -9363,8 +9364,8 @@ 
 Generates the @code{pclmulqdq} machine instruction.
 @end table
 
-The following built-in function is available when @option{-mfsgsbase} is
-used.  All of them generate the machine instruction that is part of the
+The following built-in functions are available when @option{-mfsgsbase} is
+used.  All of them generate the machine instruction that is part of their
 name.
 
 @smallexample
@@ -9378,9 +9379,9 @@ 
 void _writegsbase_u64 (unsigned long long)
 @end smallexample
 
-The following built-in function is available when @option{-mrdrnd} is
-used.  All of them generate the machine instruction that is part of the
-name.
+The following built-in functions are available when @option{-mrdrnd} is
+used.  All of them generate the machine instruction that is part of
+their name.
 
 @smallexample
 unsigned int __builtin_ia32_rdrand16_step (unsigned short *)
@@ -9389,7 +9390,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-msse4a} is used.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their name.
 
 @smallexample
 void __builtin_ia32_movntsd (double *, v2df)
@@ -9529,7 +9530,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-mfma4} is used.
-All of them generate the machine instruction that is part of the name
+All of them generate the machine instruction that is part of their name
 with MMX registers.
 
 @smallexample
@@ -9586,7 +9587,7 @@ 
 @end smallexample
 
 The following built-in functions are available when @option{-mbmi} is used.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their name.
 @smallexample
 unsigned int __builtin_ia32_bextr_u32(unsigned int, unsigned int);
 unsigned long long __builtin_ia32_bextr_u64 (unsigned long long, unsigned long long);
@@ -9604,7 +9605,7 @@ 
 
 
 The following built-in functions are available when @option{-m3dnow} is used.
-All of them generate the machine instruction that is part of the name.
+All of them generate the machine instruction that is part of their name.
 
 @smallexample
 void __builtin_ia32_femms (void)
@@ -9631,7 +9632,7 @@ 
 
 The following built-in functions are available when both @option{-m3dnow}
 and @option{-march=athlon} are used.  All of them generate the machine
-instruction that is part of the name.
+instruction that is part of their name.
 
 @smallexample
 v2si __builtin_ia32_pf2iw (v2sf)