systemsoftware
/
Programming-Guides
25
1
Fork 0
Code Issues 17 Pull Requests Projects Releases Wiki Activity
Browse Source

Create outline for front matter chapters. 

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
pull/69/head
Bill Schmidt 4 years ago
parent
80e327020a
commit
5eb6078dfa
6 changed files with 152 additions and 11 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  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
Unescape View File

@ -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
Unescape View File

@ -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
Unescape View File

@ -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
Unescape View File

@ -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
Unescape View File

@ -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
Unescape View File

@ -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>

Write Preview
Loading…
Cancel
Save