From 64ee3d30c49918b97fa3c04bcd6231bfa5ee4307 Mon Sep 17 00:00:00 2001
From: Bill Schmidt <wschmidt@linux.ibm.com>
Date: Thu, 9 Sep 2021 12:23:53 -0500
Subject: [PATCH] More updates, and prepare for external draft submission.

---
 Intrinsics_Reference/bk_main.xml          |   6 +-
 Intrinsics_Reference/ch_mma_reference.xml |  13 +-
 Intrinsics_Reference/ch_vec_reference.xml | 290 +---------------------
 3 files changed, 18 insertions(+), 291 deletions(-)

diff --git a/Intrinsics_Reference/bk_main.xml b/Intrinsics_Reference/bk_main.xml
index c183b01..fe5bba5 100644
--- a/Intrinsics_Reference/bk_main.xml
+++ b/Intrinsics_Reference/bk_main.xml
@@ -54,7 +54,7 @@
       <holder>OpenPOWER Foundation</holder>
     </copyright>
     <!-- TODO: Set the correct document releaseinfo -->
-    <releaseinfo>Revision 2.0.0</releaseinfo>
+    <releaseinfo>Revision 2.0.0_prd</releaseinfo>
     <productname>OpenPOWER</productname>
     <pubdate/>
 
@@ -88,11 +88,11 @@
     <revhistory>
       <!-- TODO: Set the initial version information and clear any old information out -->
       <revision>
-        <date>2020-10-05</date>
+        <date>2021-09-08</date>
         <revdescription>
           <itemizedlist spacing="compact">
             <listitem>
-              <para>Version 2.0_pre pre-review draft</para>
+              <para>Version 2.0.0_prd public review draft</para>
             </listitem>
           </itemizedlist>
         </revdescription>
diff --git a/Intrinsics_Reference/ch_mma_reference.xml b/Intrinsics_Reference/ch_mma_reference.xml
index d8e8b50..d920326 100644
--- a/Intrinsics_Reference/ch_mma_reference.xml
+++ b/Intrinsics_Reference/ch_mma_reference.xml
@@ -49,11 +49,6 @@
       Assist Best Practices Guide (see <xref
       linkend="VIPR.intro.links" />) and to the POWER ISA.
     </para>
-    <para>
-      <emphasis role="bold">Review status:</emphasis> Chapter reviewed
-      by Paul Clarke; changes made.  Chapter reviewed by Peter
-      Bergner; changes made.
-    </para>
   </section>
 
   <section>
@@ -439,19 +434,19 @@
       </indexterm>
       <indexterm>
 	<primary>pmxvi16ger2</primary>
-	<secondary>__builtin_mma_pmxvi64ger2</secondary>
+	<secondary>__builtin_mma_pmxvi16ger2</secondary>
       </indexterm>
       <indexterm>
 	<primary>pmxvi16ger2pp</primary>
-	<secondary>__builtin_mma_pmxvi64ger2pp</secondary>
+	<secondary>__builtin_mma_pmxvi16ger2pp</secondary>
       </indexterm>
       <indexterm>
 	<primary>pmxvi16ger2s</primary>
-	<secondary>__builtin_mma_pmxvi64ger2s</secondary>
+	<secondary>__builtin_mma_pmxvi16ger2s</secondary>
       </indexterm>
       <indexterm>
 	<primary>pmxvi16ger2spp</primary>
-	<secondary>__builtin_mma_pmxvi64ger2spp</secondary>
+	<secondary>__builtin_mma_pmxvi16ger2spp</secondary>
       </indexterm>
       <indexterm>
 	<primary>pmxvi4ger8</primary>
diff --git a/Intrinsics_Reference/ch_vec_reference.xml b/Intrinsics_Reference/ch_vec_reference.xml
index 8b941c3..8d4cb2f 100644
--- a/Intrinsics_Reference/ch_vec_reference.xml
+++ b/Intrinsics_Reference/ch_vec_reference.xml
@@ -1604,10 +1604,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpequb.</primary>
@@ -2107,10 +2103,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -2500,10 +2492,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -2979,10 +2967,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -3369,10 +3353,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -3856,10 +3836,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpneb.</primary>
@@ -5570,10 +5546,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpneb.</primary>
@@ -6112,10 +6084,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -6626,10 +6594,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -7044,10 +7008,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -7509,10 +7469,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb.</primary>
@@ -8036,10 +7992,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpequb.</primary>
@@ -10254,9 +10206,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Will Schmidt.
-      </para>
       
       <indexterm>
 	<primary>xxblendvb</primary>
@@ -10720,9 +10669,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; changes made.
-      </para>
       
       <indexterm>
 	<primary>vcfuged</primary>
@@ -10990,9 +10936,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The element numbering within a register is left-to-right for
       big-endian targets, and right-to-left for little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vclrlb</primary>
@@ -11129,9 +11072,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The element numbering within a register is left-to-right for
       big-endian targets, and right-to-left for little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vclrlb</primary>
@@ -11370,10 +11310,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpequb</primary>
@@ -11814,10 +11750,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb</primary>
@@ -12191,10 +12123,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb</primary>
@@ -12554,10 +12482,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb</primary>
@@ -12931,10 +12855,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpgtsb</primary>
@@ -13292,10 +13212,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcmpneb</primary>
@@ -14718,9 +14634,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; changes made.
-      </para>
       
       <indexterm>
 	<primary>vclzdm</primary>
@@ -14823,9 +14736,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       efficiently by the VSX Load Vector with Length
       (<code>lxvl</code>) instruction.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vcntmbb</primary>
@@ -15761,9 +15671,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; changes made.
-      </para>
       
       <indexterm>
 	<primary>vctzdm</primary>
@@ -16108,10 +16015,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       <para revisionflag="added">
 	<emphasis role="bold">Notes:</emphasis>
 	The example implementation when <emphasis
@@ -16226,10 +16129,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       <para revisionflag="added">
 	<emphasis role="bold">Notes:</emphasis>
 	The example implementation when <emphasis
@@ -16356,12 +16255,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
 	role="bold">b</emphasis> is negative one, the corresponding
 	element of <emphasis role="bold">r</emphasis> is undefined. 
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Changes other than __int128 reviewed by Paul Clarke and
-	Jinsong Ji.  Added 0x8000_0000 example per Jinsong's comment.
-	Changes for __int128 have been reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>xxspltd</primary>
@@ -16706,13 +16599,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
 	role="bold">r</emphasis>, the corresponding element of
 	<emphasis role="bold">r</emphasis> is undefined.
       </para>
-      <para>
-	<emphasis role="bold">Review status:</emphasis>
-	Changes other than __int128 were reviewed by Paul Clarke and
-	Jinsong Ji.  Updated language about the shift amount per
-	Jinsong's comment.  Changes for __int128 were reviewed by Paul
-	Clarke.
-      </para>
 
       <indexterm>
 	<primary>vdivesw</primary>
@@ -18219,9 +18105,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vexpandbm</primary>
@@ -19617,9 +19500,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       range 0 to 31.  The results are undefined if the byte index does
       not address an element boundary.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Will Schmidt.
-      </para>
       
       <indexterm>
 	<primary>vextubvlx</primary>
@@ -19863,9 +19743,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       range 0 to 31.  The results are undefined if the byte index does
       not address an element boundary.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>vextubvlx</primary>
@@ -20097,9 +19974,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vextractbm</primary>
@@ -23108,9 +22982,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       vector regardless of endianness, the semantics of this built-in
       function differ on big-endian and little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; example added.
-      </para>
       
       <indexterm>
 	<primary>mtvsrbm</primary>
@@ -23244,9 +23115,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       vector regardless of endianness, the semantics of this built-in
       function differ on big-endian and little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; example added.
-      </para>
       
       <indexterm>
 	<primary>mtvsrdm</primary>
@@ -23375,9 +23243,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       vector regardless of endianness, the semantics of this built-in
       function differ on big-endian and little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; example added.
-      </para>
       
       <indexterm>
 	<primary>mtvsrhm</primary>
@@ -23503,9 +23368,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       linkend="VIPR.intro.links" />) for examples of how to use this
       function in practice.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; minor changes made.
-      </para>
       
       <indexterm>
 	<primary>xxgenpcvbm</primary>
@@ -23702,9 +23564,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>mtvsrqm</primary>
@@ -23833,9 +23692,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       vector regardless of endianness, the semantics of this built-in
       function differ on big-endian and little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; example added.
-      </para>
       
       <indexterm>
 	<primary>mtvsrwm</primary>
@@ -23930,9 +23786,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vgnb</primary>
@@ -24574,9 +24427,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       range 0 to 15.  The results are undefined if the byte index does
       not address an element boundary.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>vinsblx</primary>
@@ -24934,9 +24784,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       range 0 to 15.  The results are undefined if the byte index does
       not address an element boundary.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>vinsblx</primary>
@@ -28876,12 +28723,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
 	negative one, the corresponding element of <emphasis
 	role="bold">r</emphasis> is undefined.
       </para>
-      <para>
-	<emphasis role="bold">Review status:</emphasis>
-	Changes other than __int128 were reviewed by Paul Clarke and
-	Jinsong Ji.  Changes for __int128 have been reviewed by Paul
-	Clarke.
-      </para>
 
       <indexterm>
 	<primary>vmodsw</primary>
@@ -29392,10 +29233,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke; changes made.
-      </para>
       
       <indexterm>
 	<primary>vmsummbm</primary>
@@ -29603,9 +29440,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vmsumcud</primary>
@@ -29983,10 +29817,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
 	  </para>
 	</listitem>
       </itemizedlist>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Changes reviewed by Paul Clarke and Jinsong Ji.
-      </para>
 
       <indexterm>
 	<primary>vmulesb</primary>
@@ -30288,10 +30118,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The element numbering within a register is left-to-right for big-endian
       targets, and right-to-left for little-endian targets.
       </para>
-      <para revisionflag="added"><emphasis role="bold">Review
-      status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vmulosh</primary>
@@ -30616,9 +30442,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke and Jinsong Ji.
-      </para>
 
       <indexterm>
 	<primary>vmulhsw</primary>
@@ -30774,10 +30597,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The element numbering within a register is left-to-right for big-endian
       targets, and right-to-left for little-endian targets.
       </para>
-      <para revisionflag="added"><emphasis role="bold">Review
-      status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vmulesh</primary>
@@ -34487,9 +34306,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; changes made.
-      </para>
       
       <indexterm>
 	<primary>vpdepd</primary>
@@ -35067,9 +34883,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       Instruction Set Architecture (<xref linkend="VIPR.intro.links"
       />) for examples.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>xxpermx</primary>
@@ -36177,9 +35990,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke; changes made.
-      </para>
       
       <indexterm>
 	<primary>vpextd</primary>
@@ -37022,9 +36832,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       0 and  3 for word-length elements, and between 0 and 1 for
       doubleword-length elements.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>vinsw</primary>
@@ -37280,15 +37087,14 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       </para>
       <para><emphasis role="bold">Endian considerations:</emphasis>
       The semantics of this built-in function differ for big-endian
-      and little-endian targets.
+      and little-endian targets, since the byte position indicated by
+      <emphasis role="bold">c</emphasis> is in left-to-right order
+      regardless of target endianness.
       </para>
       <para><emphasis role="bold">Notes:</emphasis>
       The value of <emphasis role="bold">c</emphasis> must be between
       0 and 15.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>vinsw</primary>
@@ -38248,10 +38054,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vrlb</primary>
@@ -38593,10 +38395,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The referenced bit numbers within the elements of <emphasis
       role="bold">c</emphasis> are in left-to-right order.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vrlwmi</primary>
@@ -38769,10 +38567,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vspltisw</primary>
@@ -40576,9 +40370,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       is used with the appropriate permute control vector (pcv) to
       achieve this.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vextsb2w</primary>
@@ -40714,9 +40505,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       is used with the appropriate permute control vector (pcv) to
       achieve this.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vextsb2d</primary>
@@ -40864,9 +40652,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       Element 0 is the rightmost element for little endian, and the
       leftmost element for big endian.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vextsd2q</primary>
@@ -40960,10 +40745,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vslb</primary>
@@ -41625,15 +41406,14 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       </para>
       <para><emphasis role="bold">Endian considerations:</emphasis>
       The semantics of this built-in function differ for big-endian
-      and little-endian targets.
+      and little-endian targets, since the concatenation of <emphasis
+      role="bold">a</emphasis> and <emphasis role="bold">b</emphasis>
+      is done in big-endian fashion (left to right).
       </para>
       <para><emphasis role="bold">Notes:</emphasis>
       The value of <emphasis role="bold">c</emphasis> must be between
       0 and 7, inclusive.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Will Schmidt.
-      </para>
       
       <indexterm>
 	<primary>vsldbi</primary>
@@ -43842,9 +43622,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Will Schmidt.
-      </para>
       
       <indexterm>
 	<primary>xxspltiw</primary>
@@ -43951,9 +43728,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       Element numbering is left-to-right in a register for big-endian
       targets, and right-to-left for little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Will Schmidt.
-      </para>
       
       <indexterm>
 	<primary>xxsplti32dx</primary>
@@ -44122,9 +43896,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       denormal value, the value of <emphasis role="bold">r</emphasis>
       is undefined.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>xxspltidp</primary>
@@ -44543,10 +44314,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vsrb</primary>
@@ -44838,10 +44605,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para revisionflag="added">
-	<emphasis role="bold">Review status:</emphasis>
-	Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vsrab</primary>
@@ -45137,15 +44900,14 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       </para>
       <para><emphasis role="bold">Endian considerations:</emphasis>
       The semantics of this built-in function differ for big-endian
-      and little-endian targets.
+      and little-endian targets, since the concatenation of <emphasis
+      role="bold">a</emphasis> and <emphasis role="bold">b</emphasis>
+      is done in big-endian fashion (left to right).
       </para>
       <para><emphasis role="bold">Notes:</emphasis>
       The value of <emphasis role="bold">c</emphasis> must be between
       0 and 7, inclusive.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Will Schmidt.
-      </para>
       
       <indexterm>
 	<primary>vsrdbi</primary>
@@ -47763,9 +47525,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The element numbering within a register is left-to-right for
       big-endian targets, and right-to-left for little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vstribr</primary>
@@ -47939,9 +47698,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
 	when the test guards a call to <code>vec_stril</code>.  This
 	allows compilers to generate the most efficient code.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vstribr.</primary>
@@ -48127,9 +47883,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       The element numbering within a register is left-to-right for
       big-endian targets, and right-to-left for little-endian targets.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vstribr</primary>
@@ -48303,9 +48056,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
 	when the test guards a call to <code>vec_strir</code>.  This
 	allows compilers to generate the most efficient code.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>vstribr.</primary>
@@ -50373,9 +50123,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>xxeval</primary>
@@ -50732,9 +50479,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <emphasis>t</emphasis>, and "bit" identifies the first bit
       position in condition register field <emphasis>t</emphasis>.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>xvtlsbb</primary>
@@ -50828,9 +50572,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <emphasis>t</emphasis>, and "bit" identifies the third bit
       position in condition register field <emphasis>t</emphasis>.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Reviewed by Paul Clarke.
-      </para>
       
       <indexterm>
 	<primary>xvtlsbb</primary>
@@ -53877,7 +53618,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       to a 128-bit integer.
       </para>
       <para><emphasis role="bold">Result value:</emphasis>
-      Let <emphasis role="bold">x</emphasis> be the addressed formed
+      Let <emphasis role="bold">x</emphasis> be the address formed
       by adding <emphasis role="bold">a</emphasis> and <emphasis
       role="bold">b</emphasis>.  Then <emphasis
       role="bold">r</emphasis> is set to the value of the element
@@ -53889,9 +53630,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>lxvrbx</primary>
@@ -54066,7 +53804,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       to a 128-bit unsigned integer.
       </para>
       <para><emphasis role="bold">Result value:</emphasis>
-      Let <emphasis role="bold">x</emphasis> be the addressed formed
+      Let <emphasis role="bold">x</emphasis> be the address formed
       by adding <emphasis role="bold">a</emphasis> and <emphasis
       role="bold">b</emphasis>.  Then <emphasis
       role="bold">r</emphasis> is set to the value of the element
@@ -54078,9 +53816,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>lxvrbx</primary>
@@ -55568,9 +55303,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="VIPR.vec-ref">
       <para><emphasis role="bold">Endian considerations:</emphasis>
       None.
       </para>
-      <para><emphasis role="bold">Review status:</emphasis>
-      Not yet reviewed.
-      </para>
       
       <indexterm>
 	<primary>stxvrbx</primary>