Create outline for front matter chapters.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>

Intrinsics_Reference/bk_main.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-  Copyright (c) 2016 OpenPOWER Foundation
+  Copyright (c) 2019 OpenPOWER Foundation
   
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -118,8 +118,9 @@
   <!-- TODO: Add your chapter heading files here.  Remove both files and insert your own. -->
   <!--       See the template document for naming conventions and location of files.      -->
   <!-- xi:include href="ch_template_overview.xml"/ -->
-  <!-- WJS: The ch_outline.xml file is temporary while I work out the rest -->
+  <xi:include href="ch_intro.xml"/>
-  <xi:include href="ch_outline.xml"/>
+  <xi:include href="ch_biendian.xml"/>
+  <xi:include href="ch_techniques.xml"/>
   <xi:include href="ch_vec_reference.xml"/>
   <!-- xi:include href="ch_scal_reference.xml"/ -->
   <xi:include href="ch_isa_intrin_xref.xml"/>

Intrinsics_Reference/ch_biendian.xml

@@ -0,0 +1,43 @@
+<!--
+  Copyright (c) 2019 OpenPOWER Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+  
+-->
+<chapter version="5.0" xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
+xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_biendian">
+  
+  <!-- Chapter Title goes here. -->
+  <title>The Power Bi-Endian Programming Model</title>
+
+  <section>
+    <title>Purpose</title>
+    <para>filler</para>
+  </section>
+
+  <section>
+    <title>Examples</title>
+    <para>filler</para>
+  </section>
+
+  <section>
+    <title>Limitations</title>
+    <para>
+      <code>vec_sld</code>
+    </para>
+    <para>
+      <code>vec_perm</code>
+    </para>
+  </section>
+
+</chapter>

Intrinsics_Reference/ch_intro.xml

@@ -0,0 +1,38 @@
+<!--
+  Copyright (c) 2019 OpenPOWER Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+  
+-->
+<chapter version="5.0" xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
+xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_intro">
+  
+  <!-- Chapter Title goes here. -->
+  <title>Introduction to Vector Programming on Power</title>
+
+  <section>
+    <title>A Brief History</title>
+    <para>filler</para>
+  </section>
+
+  <section>
+    <title>The Unified Vector Register Set</title>
+    <para>filler</para>
+  </section>
+
+  <section>
+    <title>Useful Links</title>
+    <para>filler</para>
+  </section>
+
+</chapter>

Intrinsics_Reference/ch_isa_intrin_xref.xml

@@ -1,5 +1,5 @@
 <!--
-  Copyright (c) 2017 OpenPOWER Foundation
+  Copyright (c) 2019 OpenPOWER Foundation
   
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

Intrinsics_Reference/ch_techniques.xml

@@ -0,0 +1,56 @@
+<!--
+  Copyright (c) 2019 OpenPOWER Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+  
+-->
+<chapter version="5.0" xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
+xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_techniques">
+  
+  <!-- Chapter Title goes here. -->
+  <title>Vector Programming Techniques</title>
+
+  <section>
+    <title>Help the Compiler Help You</title>
+    <para>
+      Start with scalar code, which is the most portable.  Use various
+      tricks for helping the compiler vectorize scalar code.  Make
+      sure you align your data on 16-byte boundaries wherever
+      possible, and tell the compiler it's aligned.  Use __restrict__
+      pointers to promise data does not alias.
+    </para>
+  </section>
+
+  <section>
+    <title>Use Portable Intrinsics</title>
+    <para>
+      Individual compilers may provide other intrinsic support.  Only
+      the intrinsics in this manual are guaranteed to be portable
+      across compliant compilers.
+    </para>
+    <para>
+      Some compilers may provide compatibility headers for use with
+      other architectures.  Recent GCC and Clang compilers support
+      compatibility headers for the lower levels of the x86 vector
+      architecture.  These can be used initially for ease of porting,
+      but for best performance, it is preferable to rewrite important
+      sections of code with native Power intrinsics.
+    </para>
+  </section>
+
+  <section>
+    <title>Use Assembly Code Sparingly</title>
+    <para>filler</para>
+  </section>
+
+</chapter>

Intrinsics_Reference/ch_vec_reference.xml

@@ -1,5 +1,5 @@
 <!--
-  Copyright (c) 2017 OpenPOWER Foundation
+  Copyright (c) 2019 OpenPOWER Foundation
   
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -20,15 +20,18 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_vec_intrinsics">
   <!-- Chapter Title goes here. -->
   <title>Vector Intrinsic Reference</title>
  
-  <para>Some front matter should go here, describing conventions
+  <section>
-  used throughout the chapter.</para>
+    <title>How to Use This Reference</title>
-  
+    <para>
+      Brief description of the format of the entries, the cross-reference
+      index, and so forth.
+    </para>
+  </section>
+
+  <?hard-pagebreak?>
   <section>
     <title>Built-In Vector Functions</title>
-    <para>Some front matter should go here, describing conventions
-    specific to this section.</para>
 
-    <?hard-pagebreak?>
     <simplesect xml:id="vec_abs">
       <title>vec_abs</title>
       <subtitle>Vector Absolute Value</subtitle>