Browse Source

Create outline for front matter chapters.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
pull/69/head
Bill Schmidt 3 years ago
parent
commit
5eb6078dfa
  1. 7
      Intrinsics_Reference/bk_main.xml
  2. 43
      Intrinsics_Reference/ch_biendian.xml
  3. 38
      Intrinsics_Reference/ch_intro.xml
  4. 2
      Intrinsics_Reference/ch_isa_intrin_xref.xml
  5. 56
      Intrinsics_Reference/ch_techniques.xml
  6. 17
      Intrinsics_Reference/ch_vec_reference.xml

7
Intrinsics_Reference/bk_main.xml

@ -1,6 +1,6 @@ @@ -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 @@ @@ -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_outline.xml"/>
<xi:include href="ch_intro.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"/>

43
Intrinsics_Reference/ch_biendian.xml

@ -0,0 +1,43 @@ @@ -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>

38
Intrinsics_Reference/ch_intro.xml

@ -0,0 +1,38 @@ @@ -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>

2
Intrinsics_Reference/ch_isa_intrin_xref.xml

@ -1,5 +1,5 @@ @@ -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.

56
Intrinsics_Reference/ch_techniques.xml

@ -0,0 +1,56 @@ @@ -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>

17
Intrinsics_Reference/ch_vec_reference.xml

@ -1,5 +1,5 @@ @@ -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"> @@ -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
used throughout the chapter.</para>
<section>
<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>

Loading…
Cancel
Save