From 024b22d3cd75bdfaf015969c3b5a3c6ed73b2534 Mon Sep 17 00:00:00 2001
From: Bill Schmidt <wschmidt@linux.ibm.com>
Date: Thu, 20 Jun 2019 20:26:07 -0500
Subject: [PATCH] Add note on vec_perm invalid usage.  Remove app_a.xml
 reference.

Signed-off-by: Bill Schmidt  <wschmidt@linux.ibm.com>
---
 Intrinsics_Reference/bk_main.xml          | 2 +-
 Intrinsics_Reference/ch_vec_reference.xml | 8 ++++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/Intrinsics_Reference/bk_main.xml b/Intrinsics_Reference/bk_main.xml
index 0949172..d54a28e 100644
--- a/Intrinsics_Reference/bk_main.xml
+++ b/Intrinsics_Reference/bk_main.xml
@@ -123,7 +123,7 @@
   <xi:include href="ch_vec_reference.xml"/>
   <!-- xi:include href="ch_scal_reference.xml"/ -->
   <xi:include href="ch_isa_intrin_xref.xml"/>
-  <xi:include href="app_a.xml"/>
+  <!-- xi:include href="app_a.xml"/ -->
 
   <!-- The app_foundation.xml appendix file is required by all documents. -->
   <xi:include href="../../Docs-Master/common/app_foundation.xml"/>
diff --git a/Intrinsics_Reference/ch_vec_reference.xml b/Intrinsics_Reference/ch_vec_reference.xml
index ac96891..9966981 100644
--- a/Intrinsics_Reference/ch_vec_reference.xml
+++ b/Intrinsics_Reference/ch_vec_reference.xml
@@ -24033,6 +24033,14 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_vec_intrinsics">
 	    role="bold">c</emphasis>.
 	  </para>
 	</listitem>
+	<listitem>
+	  <para>
+	    The <code>vec_perm</code> built-in should only use permutations
+	    that reorder vector elements of the specified type, not to reorder
+	    bytes within those elements.  The results are not guaranteed to be
+	    consistent across big- and little-endian if you violate this rule.
+	  </para>
+	</listitem>
 	<listitem>
 	  <para>
 	    No Power compilers yet support the vector _Float16 type, so that