<?xml version="1.0" encoding="UTF-8"?>
<!--
  Copyright (c) 2017 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.
  
-->
<book xmlns="http://docbook.org/ns/docbook"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:xlink="http://www.w3.org/1999/xlink"
  version="5.0"
  xml:id="bk_main">

    <title>Linux on Power Porting Guide</title>
    <subtitle>Vector Intrinsics</subtitle>

    <info>
    <author>
      <personname>
          <surname>System Software Work Group</surname>
      </personname>
      <email>syssw-chair@openpowerfoundation.org</email>
      <affiliation>
          <orgname>OpenPOWER Foundation</orgname>
      </affiliation>
    </author>
    <copyright>
      <year>2017</year>
      <holder>OpenPOWER Foundation</holder>
    </copyright>
    <!-- TODO: Set the correct document releaseinfo -->
    <releaseinfo>Revision 1.0</releaseinfo>
    <productname>OpenPOWER</productname>
    <pubdate/>

    <legalnotice role="apache2">

      <annotation>
          <remark>Copyright details are filled in by the template.</remark>
      </annotation>
    </legalnotice>
    
    <!-- TODO: Update the following text with the correct document description (first paragraph),
               Work Group name, and Work Product track (both in second paragraph). -->
    <abstract>
      <para>The goal of this project is to provide functional equivalents of the 
      Intel MMX, SSE, and AVX intrinsic functions, that are commonly used in Linux 
      applications, and make them (or equivalents) available for the PowerPC64LE 
      platform.</para>
      
      <para>This document is a Non-standard Track, Work Group Note work product owned by the
      System Software Workgroup and handled in compliance with the requirements outlined in the
      <citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document.  It was
      created using the <citetitle>Master Template Guide</citetitle> version 0.9.5. Comments,
      questions, etc. can be submitted to the public mailing list  for this document at 
      <email>syssw-programming-guides@mailinglist.openpowerfoundation.org</email>.</para>
    </abstract>

    <revhistory>
      <!-- TODO: Update as new revisions created -->
      <revision>
          <date>2018-3-14</date>
          <revdescription>
            <itemizedlist spacing="compact">
              <listitem>
                <para>Revision 1.0 - Minor updates.  Published version.</para>
              </listitem>
            </itemizedlist>
          </revdescription>
      </revision>
      <revision>
          <date>2017-10-30</date>
          <revdescription>
            <itemizedlist spacing="compact">
              <listitem>
                <para>Revision 0.3 - Updates to describe issues associated with larger vector sizes
                and proposed solutions.</para>
              </listitem>
            </itemizedlist>
          </revdescription>
      </revision>
      <revision>
          <date>2017-09-14</date>
          <revdescription>
            <itemizedlist spacing="compact">
              <listitem>
                <para>Revision 0.2 - Miscellaneous correction for spelling, grammar and punctuation.</para>
              </listitem>
            </itemizedlist>
          </revdescription>
      </revision>
      <revision>
          <date>2017-07-26</date>
          <revdescription>
            <itemizedlist spacing="compact">
              <listitem>
                <para>Revision 0.1 - initial draft from Steve Munroe</para>
              </listitem>
            </itemizedlist>
          </revdescription>
      </revision>
     </revhistory>
    </info>

  <!-- The ch_preface.xml file is required by all documents -->
  <xi:include href="../../Docs-Master/common/ch_preface.xml"/>

  <!-- Chapter heading files  -->
  <xi:include href="ch_intel_intrinsic_porting.xml"/>
  <xi:include href="ch_howto_start.xml"/>
  
  <!-- Placeholder files ATM -->
  <!--chapter><title>Placeholders</title>
  </chapter-->
  

  <!-- Document specific appendices -->
  <xi:include href="app_references.xml"/>
  <xi:include href="app_intel_suffixes.xml"/>

  <!-- The app_foundation.xml appendix file is required by all documents. -->
  <xi:include href="../../Docs-Master/common/app_foundation.xml"/>

</book>