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

Initial project files.

Browse Source 
Signed-off-by:  Bill Schmidt <wschmidt@linux.vnet.ibm.com>
pull/30/head
Bill Schmidt 7 years ago
parent a6d2fd6d12
commit 94f19d4637
30 changed files with 9133 additions and 0 deletions
Show Stats Download Patch File Download Diff File

176
Intrinsics_Reference/LICENSE
Unescape Escape View File

@ -0,0 +1,176 @@

Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

95
Intrinsics_Reference/README.md
Unescape Escape View File

@ -0,0 +1,95 @@
# OpenPOWER Foundation Documentation Development Guide
This repository holds the source for the documentation development guide
(formerly *Master Template Document*) for
OpenPOWER Foundation. The PDF and HTML generated from the doc/template/
directory build a document that both describes how to build a new
document and contains examples and directions on how to do it.

To build this project, one must ensure that the Docs-Master project has
also been cloned at the same directory level as the Docs-Template project.
This can be accomplished with the following steps:

1. Clone the master documentation project (Docs-Master) using the following command:

```
$ git clone https://github.com/OpenPOWERFoundation/Docs-Master.git
```
2. Clone this project (Docs-Template) using the following command:

```
$ git clone https://github.com/OpenPOWERFoundation/Docs-Template.git
```
3. Build the project with these commands:
```
$ cd Docs-Template
$ mvn clean generate-sources
```

The online version of the document can be found in the OpenPOWER Foundation
Document library at [OpenPOWER Foundation Documentation Development Guide](http://openpowerfoundation.org/?resource_lib=openpower-foundation-documentation-development-guide).

The project which controls the look and feel of the document is the
[Docs-Maven-Plugin project](https://github.com/OpenPOWERFoundation/Docs-Maven-Plugin), an
OpenPOWER Foundation private project on GitHub. To obtain access to the Maven Plugin project,
contact Jeff Scheel \([scheel@us.ibm.com](mailto://scheel@us.ibm.com)\) or
Jeff Brown \([jeffdb@us.ibm.com](mailto://jeffdb@us.ibm.com)\).

## License
This project is licensed under the Apache V2 license. More information
can be found in the LICENSE file or online at

http://www.apache.org/licenses/LICENSE-2.0

## Contributions
To contribute to the OpenPOWER Foundation template document project, contact Jeff Scheel \([scheel@us.ibm.com](mailto://scheel@us.ibm.com)\) or
Jeff Brown \([jeffdb@us.ibm.com](mailto://jeffdb@us.ibm.com)\).

Contributions to this project should conform to the `Developer Certificate
of Origin` as defined at http://elinux.org/Developer_Certificate_Of_Origin.
Commits to this project need to contain the following line to indicate
the submitter accepts the DCO:
```
Signed-off-by: Your Name <your_email@domain.com>
```
By contributing in this way, you agree to the terms as follows:
```
Developer Certificate of Origin
Version 1.1

Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
660 York Street, Suite 102,
San Francisco, CA 94110 USA

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.


Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
have the right to submit it under the open source license
indicated in the file; or

(b) The contribution is based upon previous work that, to the best
of my knowledge, is covered under an appropriate open source
license and I have the right under that license to submit that
work with modifications, whether created in whole or in part
by me, under the same open source license (unless I am
permitted to submit under a different license), as indicated
in the file; or

(c) The contribution was provided directly to me by some other
person who certified (a), (b) or (c) and I have not modified
it.

(d) I understand and agree that this project and the contribution
are public and that a record of the contribution (including all
personal information I submit with it, including my sign-off) is
maintained indefinitely and may be redistributed consistent with
this project or the open source license(s) involved.
```

30
Intrinsics_Reference/app_template.xml
Unescape Escape View File

@ -0,0 +1,30 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 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.
-->
<appendix 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="app_template">
<?dbhtml stop-chunking?>
<title>Appendix template</title>
<para>This is the first paragraph of a new appendix...</para>
<section xml:id="sample-app-section">
<title>Section title</title>
<para>Section text...</para>
</section>
</appendix>

119
Intrinsics_Reference/bk_main.xml
Unescape Escape View File

@ -0,0 +1,119 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 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.
-->

<!-- The following entity variable is used to reflect the version of the
template document master used for building a document. This value
should be set by copy of the of template used to create a new
document and should not be changed. Use of this value is in
in the Abstract section in this file. -->
<!DOCTYPE book [
<!ENTITY template_version "1.0.0">
]>

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

<!-- TODO: Pick a Title for the new document -->
<title>Intrinsic Function Programming Reference</title>
<!-- TODO: Either add a subtitle or remove the following line -->
<!-- subtitle></subtitle -->

<info>
<author>
<!-- TODO: Set to the appropriate owning Work Group, not an individual -->
<personname>
System Software Work Group
</personname>
<!-- TODO: Set email address of document author to the Work Group Chair -->
<email>syssw-chair@openpowerfoundation.org</email>
<affiliation>
<orgname>OpenPower Foundation</orgname>
</affiliation>
</author>
<copyright>
<!-- TODO: Set copyright year -->
<year>2017</year>
<holder>OpenPOWER Foundation</holder>
</copyright>
<!-- TODO: Set the correct document releaseinfo -->
<releaseinfo>Revision 0.8.0</releaseinfo>
<productname>OpenPOWER</productname>
<pubdate/>

<!-- TODO: Select one of the two following legalnotice role= values:
"apache2" for an Apache V2 license or
"opfExternal" for an official OpenPOWER Foundation external license text.
If you don't know which one to select, leave as "apache2" -->
<legalnotice role="apache2">
<!--legalnotice role="opfExternal"-->

<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 purpose of this document is to provide a guide
for vector programming on OpenPOWER systems, with an emphasis on examples
of best practices. It further provides a reference for intrinsics
provided by compliant compilers on OpenPOWER systems.</para>
<para>This document is a Non-standard Track, Work Group Specification 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 &template_version;.</para>
</abstract>

<revhistory>
<!-- TODO: Set the initial version information and clear any old information out -->
<revision>
<date>2017-09-25</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Version 0.8: Initial publication to private GitHub project.</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"/>

<!-- 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_vec_reference.xml"/>
<xi:include href="ch_scal_reference.xml"/>
<xi:include href="ch_isa_intrin_xref.xml"/>

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

<!-- TODO: The following template document may be modified to create additional appendices as needed. -->
<xi:include href="app_template.xml"/>

</book>

220
Intrinsics_Reference/ch_example.xml
Unescape Escape View File

@ -0,0 +1,220 @@
<!--
Copyright (c) 2016 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_template_examples">
<!-- Chapter Title goes here. -->
<title>Documentation examples</title>
<section>
<title>Section Title goes here</title>
<para>This Section covers something of interest to a limited number of people and shows a 1st level section</para>

<section xml:id="list_example_label">
<title>Example Itemized List</title>
<para>
Here is an example of an itemized list</para>
<itemizedlist>
<listitem>
<para>
Item you don't care about</para>
</listitem>
<listitem>
<para>
Item you might care about </para>
</listitem>
<listitem>
<para>
Item you do care about </para>
</listitem>
</itemizedlist>
</section>
<section>
<title>Example ordered list</title>
<para>
All good documents need ordered lists.</para>
<orderedlist>
<listitem>
<para>First item</para>
</listitem>
<listitem>
<para>Second item</para>
<orderedlist numeration="loweralpha">
<listitem>
<para>first indented item</para>
</listitem>
<listitem>
<para> second indented item</para>
</listitem>
</orderedlist>
</listitem>
<listitem>
<para>Third item</para>
</listitem>
</orderedlist>
</section>

<section>
<title>Example figure with embedded graphic</title>
<para>
Here is how you embed a graphic.</para>
<figure pgwide="1" xml:id="figure_label">
<title>Example figure</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/example_graphic.bmp" format="BMP" scalefit="1" width="100%" />
</imageobject>
</mediaobject>
</figure>
<note><para>Raw images such as the bitmap (bmp) file above may become blurry as they are scaled.
Scalable graphic formats like SVG (Scalable Vector Graphics) embed and scale the best.</para></note>
</section>

<section>
<title>Example table</title>
<para>Of course all good documents need tables. Here's how you build a basic table.</para>

<table frame="all" pgwide="1" xml:id="table_label">
<title>Example Table Title</title>
<tgroup cols="4">
<colspec colname="c1" colwidth="25*" />
<colspec colname="c2" colwidth="25*" />
<colspec colname="c3" colwidth="25*" />
<colspec colname="c4" colwidth="25*" />
<thead>
<row>
<entry>
<para>
<emphasis role="bold">1st Column Heading</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">2nd Column Heading</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">3rd Column Heading</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">4th Column Heading</emphasis>
</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry>
<para>Yes</para>
</entry>
<entry>
<para><phrase role="red">Red</phrase></para>
<para><phrase role="green">Green</phrase></para>
<para><phrase role="blue">Blue</phrase></para>
<para><phrase role="#FFBF00">Custom (Amber)</phrase></para>
</entry>
<entry>
<para>MAIN_Junk</para>
</entry>
<entry>
<para>More_Junk</para>
</entry>
</row>
<row>
<entry namest='c1' nameend='c3' align='center'>
<para>merged cells horizontal</para>
</entry>
<entry>
<para>cell_stuff</para>
</entry>
</row>
<row>
<entry morerows='1'>
<para>Merge cells vertical</para>
</entry>
<entry>
<para>filler</para>
</entry>
<entry namest='c3' nameend='c4' morerows='1' align='center'>
<para>merge cells both ways</para>
</entry>
</row>
<row>
<entry>
<para>filler 2</para>
</entry>
</row>
<row>
<entry>
<para>How about we put a list in the table cell</para>
<itemizedlist>
<listitem>
<para>item 1</para>
</listitem>
<listitem>
<para>item 2</para>
</listitem>
<listitem>
<para>item 2</para>
</listitem>
</itemizedlist>
</entry>
<entry>
<para>Another Cell</para>
</entry>
<entry>
<para>Yet Another Cell</para>
</entry>
<entry>
<para>Finally the last cell</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section>
<title>Example of crossreferences and footnotes</title>
<para>To reference another section or table is pretty easy. For example: see <xref linkend="table_label" /> for how tables look.</para>
<para>Lists are shown in <xref linkend="list_example_label" /> and if you need to make a footnote
<footnote xml:id="foot_id"><para>The footnote text goes here and can reference something like <xref linkend="figure_label" /> for additional explanation.</para></footnote>
For clarification that is easy. Of course you might want an additional reference to the footnote <footnoteref linkend="foot_id"/> which can also be done easily.</para>
<para>Lastly you probably want to mark text by making it <emphasis>italic text example</emphasis> or <emphasis role='bold'>Bold Text Example</emphasis>.</para>
</section>
<section>
<title>Example of code citations and user input</title>
<para>When showing user input, you want a nice sceen-looking layout, a prompt, monospace text, and a way to differentiate input from output. Here's an example:
<screen><prompt>$ </prompt><userinput>echo "Hello world"</userinput>
Hello world
<prompt>$ </prompt></screen>
</para>
<para>Docbook also allows for formatting and display of common languages, allowing for whitespace
and line returns just as they are written. Here's a sample snippet of C code with line numbering enabled:<programlisting linenumbering="numbered"><![CDATA[#include<stdio.h>
main()
{
printf("Hello world\n");
}]]></programlisting></para>
<para>If code formatting is not quite what you need, simply displaying text "literally" may suffice as follows: <literal>This is my literal
text. It ignores whitespace.</literal></para>
</section>

</section>
</chapter>

26
Intrinsics_Reference/ch_isa_intrin_xref.xml
Unescape Escape View File

@ -0,0 +1,26 @@
<!--
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.
-->
<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_isa_intrin_xref">
<!-- Chapter Title goes here. -->
<title>Instruction/Intrinsic Cross-Reference</title>
<para>This chapter will contain a cross-reference from Power hardware
instructions to intrinsics that generate them.</para>
</chapter>

45
Intrinsics_Reference/ch_outline.xml
Unescape Escape View File

@ -0,0 +1,45 @@
<!--
Copyright (c) 2016 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_outline">
<!-- Chapter Title goes here. -->
<title>Notes on what to include</title>

<itemizedlist spacing="compact">
<listitem>
<para>Rewrite the material from ABI Chapter 6</para>
</listitem>
<listitem>
<para>Recommendations for different ways to create efficient vector
code
<itemizedlist spacing="compact">
<listitem>
<para>Portable: C,C++; tricks to help compiler vectorize code</para>
</listitem>
<listitem>
<para>Use intrinsics</para>
</listitem>
<listitem>
<para>Assembly code - not recommended, but if you must</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</itemizedlist>

</chapter>

31
Intrinsics_Reference/ch_scal_reference.xml
Unescape Escape View File

@ -0,0 +1,31 @@
<!--
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.
-->
<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_scal_intrinsics">
<!-- Chapter Title goes here. -->
<title>Scalar Intrinsic Reference</title>
<para>Some front matter should go here, describing conventions
used throughout the chapter.</para>
<section>
<title>Built-In ((Purpose)) Functions</title>
<para>Some front matter should go here, describing conventions
specific to this section.</para>
</section>
</chapter>

96
Intrinsics_Reference/ch_template_overview.xml
Unescape Escape View File

@ -0,0 +1,96 @@
<!--
Copyright (c) 2016 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">
<title>Document development overview</title>

<para>The <emphasis>OpenPOWER Foundation Documentation Development Guide</emphasis>
provides a framework for OpenPOWER public and private
documentation. The goal of the template and this writeup is to promote community contributions
to OpenPOWER documenation and to enable new contributions within a common look and feel. </para>

<para>The major sections of this document addresses the following topics:</para>
<itemizedlist>
<listitem>
<para><xref linkend="section_template_getting_started" endterm="section_template_getting_started_title"/>:
This section details tools and commands used to contribute to OpenPOWER documentation.
All users who are new to OpenPOWER Foundation documentation should start here.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_new_document" endterm="section_template_new_document_title"/>:
This section provides step-by-step instructions on how to create a new document
from scratch. Use this section to start a new document.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_existing_document" endterm="section_template_existing_document_title"/>:
This section highlights common steps in editing an existing OpenPOWER
Foundation document. Use this section as a guideline for contributing to an existing document.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_debug" endterm="section_template_debug_title"/>:
This section provides examples of the two most common types of build failures
and helps users find the relevant failure information.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_process" endterm="section_template_process_title"/>:
This section explains key document types and the appropriate work flow for publishing OpenPOWER Foundation
documents.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_structure" endterm="section_template_structure_title"/>:
This section provides detailed descriptions of the various project
components and their roles in the documentation creation process.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_policies" endterm="section_template_policies_title"/>: This section contains
the generally accepted guidelines for creating OpenPOWER documentation. Use this section as a reference
for documentation style beyond template provided features.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_faq" endterm="section_template_faq_title"/>:
This section answers common questions. Use this section when the other sections
do not answer your questions.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_git_commands" endterm="section_template_git_commands_title"/>:
This section contains examples of commonly used git commands. Reference this section
to find information on a specific git operation.</para>
</listitem>
<listitem>
<para><xref linkend="section_template_references" endterm="section_template_references_title"/>:
This section provides pointers to on-line information about XML, Docbook,
Maven, and other relevant references.</para>
</listitem>
</itemizedlist>

<para>In addition to OpenPOWER Foundation specific topics, <xref linkend="section_template_examples"/>
provides examples of common documenation constructs in XML.</para>

<xi:include href="sec_template_getting_started.xml"/>
<xi:include href="sec_template_new_document.xml"/>
<xi:include href="sec_template_existing_document.xml"/>
<xi:include href="sec_template_debugging.xml"/>
<xi:include href="sec_template_process.xml"/>
<xi:include href="sec_template_structure.xml"/>
<xi:include href="sec_template_policies.xml"/>
<xi:include href="sec_template_faq.xml"/>
<xi:include href="sec_template_git_commands.xml"/>
<xi:include href="sec_template_references.xml"/>


</chapter>

6075
Intrinsics_Reference/ch_vec_reference.xml
View File

File diff suppressed because it is too large Load Diff

BIN
Intrinsics_Reference/figures/example_graphic.bmp
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 648 KiB

BIN
Intrinsics_Reference/figures/example_graphic.odg
View File

Binary file not shown.

BIN
Intrinsics_Reference/figures/project_process_non-std_track_graphic.odg
View File

Binary file not shown.

151
Intrinsics_Reference/figures/project_process_non-std_track_graphic.svg
Unescape Escape View File

@ -0,0 +1,151 @@
<?xml version="1.0" encoding="UTF-8"?>

<svg version="1.2" baseProfile="tiny" width="152.4mm" height="101.6mm" viewBox="0 0 15240 10160" preserveAspectRatio="xMidYMid" fill-rule="evenodd" clip-path="url(#presentation_clip_path)" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
<defs class="ClipPathGroup">
<clipPath id="presentation_clip_path" clipPathUnits="userSpaceOnUse">
<rect x="0" y="0" width="15240" height="10160"/>
</clipPath>
</defs>
<defs>
<font id="EmbeddedFont_1" horiz-adv-x="2048">
<font-face font-family="Arimo embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1852" descent="450"/>
<missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
<glyph unicode="w" horiz-adv-x="1509" d="M 1174,0 L 965,0 776,765 740,934 C 734,904 725,861 712,805 699,748 631,480 508,0 L 300,0 -3,1082 175,1082 358,347 C 363,331 377,265 401,149 L 418,223 644,1082 837,1082 1026,339 1072,149 1103,288 1308,1082 1484,1082 1174,0 Z"/>
<glyph unicode="v" horiz-adv-x="1033" d="M 613,0 L 400,0 7,1082 199,1082 437,378 C 446,351 469,272 506,141 L 541,258 580,376 826,1082 1017,1082 613,0 Z"/>
<glyph unicode="u" horiz-adv-x="874" d="M 314,1082 L 314,396 C 314,325 321,269 335,230 349,191 371,162 402,145 433,128 478,119 537,119 624,119 692,149 742,208 792,267 817,350 817,455 L 817,1082 997,1082 997,231 C 997,105 999,28 1003,0 L 833,0 C 832,3 832,12 831,27 830,42 830,59 829,78 828,97 826,132 825,185 L 822,185 C 781,110 733,58 679,27 624,-4 557,-20 476,-20 357,-20 271,10 216,69 161,128 133,225 133,361 L 133,1082 314,1082 Z"/>
<glyph unicode="t" horiz-adv-x="531" d="M 554,8 C 495,-8 434,-16 372,-16 228,-16 156,66 156,229 L 156,951 31,951 31,1082 163,1082 216,1324 336,1324 336,1082 536,1082 536,951 336,951 336,268 C 336,216 345,180 362,159 379,138 408,127 450,127 474,127 509,132 554,141 L 554,8 Z"/>
<glyph unicode="r" horiz-adv-x="530" d="M 142,0 L 142,830 C 142,906 140,990 136,1082 L 306,1082 C 311,959 314,886 314,861 L 318,861 C 347,954 380,1017 417,1051 454,1085 507,1102 575,1102 599,1102 623,1099 648,1092 L 648,927 C 624,934 592,937 552,937 477,937 420,905 381,841 342,776 322,684 322,564 L 322,0 142,0 Z"/>
<glyph unicode="p" horiz-adv-x="953" d="M 1053,546 C 1053,169 920,-20 655,-20 488,-20 376,43 319,168 L 314,168 C 317,163 318,106 318,-2 L 318,-425 138,-425 138,861 C 138,972 136,1046 132,1082 L 306,1082 C 307,1079 308,1070 309,1054 310,1037 312,1012 314,978 315,944 316,921 316,908 L 320,908 C 352,975 394,1024 447,1055 500,1086 569,1101 655,1101 788,1101 888,1056 954,967 1020,878 1053,737 1053,546 Z M 864,542 C 864,693 844,800 803,865 762,930 698,962 609,962 538,962 482,947 442,917 401,887 371,840 350,777 329,713 318,630 318,528 318,386 341,281 386,214 431,147 505,113 607,113 696,113 762,146 803,212 844,277 864,387 864,542 Z"/>
<glyph unicode="o" horiz-adv-x="980" d="M 1053,542 C 1053,353 1011,212 928,119 845,26 724,-20 565,-20 407,-20 288,28 207,125 126,221 86,360 86,542 86,915 248,1102 571,1102 736,1102 858,1057 936,966 1014,875 1053,733 1053,542 Z M 864,542 C 864,691 842,800 798,868 753,935 679,969 574,969 469,969 393,935 346,866 299,797 275,689 275,542 275,399 298,292 345,221 391,149 464,113 563,113 671,113 748,148 795,217 841,286 864,395 864,542 Z"/>
<glyph unicode="n" horiz-adv-x="874" d="M 825,0 L 825,686 C 825,757 818,813 804,852 790,891 768,920 737,937 706,954 661,963 602,963 515,963 447,933 397,874 347,815 322,732 322,627 L 322,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 358,972 406,1025 461,1056 515,1087 582,1102 663,1102 782,1102 869,1073 924,1014 979,955 1006,857 1006,721 L 1006,0 825,0 Z"/>
<glyph unicode="m" horiz-adv-x="1457" d="M 768,0 L 768,686 C 768,791 754,863 725,903 696,943 645,963 570,963 493,963 433,934 388,875 343,816 321,734 321,627 L 321,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 356,974 400,1027 450,1057 500,1087 561,1102 633,1102 715,1102 780,1086 828,1053 875,1020 908,968 927,897 L 930,897 C 967,970 1013,1022 1066,1054 1119,1086 1183,1102 1258,1102 1367,1102 1447,1072 1497,1013 1546,954 1571,856 1571,721 L 1571,0 1393,0 1393,686 C 1393,791 1379,863 1350,903 1321,943 1270,963 1195,963 1116,963 1055,934 1012,876 968,817 946,734 946,627 L 946,0 768,0 Z"/>
<glyph unicode="l" horiz-adv-x="187" d="M 138,0 L 138,1484 318,1484 318,0 138,0 Z"/>
<glyph unicode="k" horiz-adv-x="901" d="M 816,0 L 450,494 318,385 318,0 138,0 138,1484 318,1484 318,557 793,1082 1004,1082 565,617 1027,0 816,0 Z"/>
<glyph unicode="i" horiz-adv-x="187" d="M 137,1312 L 137,1484 317,1484 317,1312 137,1312 Z M 137,0 L 137,1082 317,1082 317,0 137,0 Z"/>
<glyph unicode="f" horiz-adv-x="557" d="M 361,951 L 361,0 181,0 181,951 29,951 29,1082 181,1082 181,1204 C 181,1303 203,1374 246,1417 289,1460 356,1482 445,1482 495,1482 537,1478 572,1470 L 572,1333 C 542,1338 515,1341 492,1341 446,1341 413,1329 392,1306 371,1283 361,1240 361,1179 L 361,1082 572,1082 572,951 361,951 Z"/>
<glyph unicode="e" horiz-adv-x="980" d="M 276,503 C 276,379 302,283 353,216 404,149 479,115 578,115 656,115 719,131 766,162 813,193 844,233 861,281 L 1019,236 C 954,65 807,-20 578,-20 418,-20 296,28 213,123 129,218 87,360 87,548 87,727 129,864 213,959 296,1054 416,1102 571,1102 889,1102 1048,910 1048,527 L 1048,503 276,503 Z M 862,641 C 852,755 823,838 775,891 727,943 658,969 568,969 481,969 412,940 361,882 310,823 282,743 278,641 L 862,641 Z"/>
<glyph unicode="d" horiz-adv-x="927" d="M 821,174 C 788,105 744,55 689,25 634,-5 565,-20 484,-20 347,-20 247,26 183,118 118,210 86,349 86,536 86,913 219,1102 484,1102 566,1102 634,1087 689,1057 744,1027 788,979 821,914 L 823,914 821,1035 821,1484 1001,1484 1001,223 C 1001,110 1003,36 1007,0 L 835,0 C 833,11 831,35 829,74 826,113 825,146 825,174 L 821,174 Z M 275,542 C 275,391 295,282 335,217 375,152 440,119 530,119 632,119 706,154 752,225 798,296 821,405 821,554 821,697 798,802 752,869 706,936 633,969 532,969 441,969 376,936 336,869 295,802 275,693 275,542 Z"/>
<glyph unicode="c" horiz-adv-x="901" d="M 275,546 C 275,402 298,295 343,226 388,157 457,122 548,122 612,122 666,139 709,173 752,206 778,258 788,328 L 970,328 C 956,222 912,138 837,75 762,12 668,-20 553,-20 402,-20 286,28 207,124 127,219 87,359 87,542 87,724 127,863 207,959 287,1054 402,1102 551,1102 662,1102 754,1073 827,1016 900,959 945,880 964,779 L 779,765 C 770,825 746,873 708,908 670,943 616,961 546,961 451,961 382,929 339,866 296,803 275,696 275,546 Z"/>
<glyph unicode="b" horiz-adv-x="953" d="M 1053,546 C 1053,169 920,-20 655,-20 573,-20 505,-5 451,25 396,54 352,102 318,168 L 316,168 C 316,147 315,116 312,74 309,31 307,7 306,0 L 132,0 C 136,36 138,110 138,223 L 138,1484 318,1484 318,1061 C 318,1018 317,967 314,908 L 318,908 C 351,977 396,1027 451,1057 506,1087 574,1102 655,1102 792,1102 892,1056 957,964 1021,872 1053,733 1053,546 Z M 864,540 C 864,691 844,800 804,865 764,930 699,963 609,963 508,963 434,928 388,859 341,790 318,680 318,529 318,387 341,282 386,215 431,147 505,113 607,113 698,113 763,147 804,214 844,281 864,389 864,540 Z"/>
<glyph unicode="a" horiz-adv-x="1060" d="M 414,-20 C 305,-20 224,9 169,67 114,124 87,204 87,304 87,417 124,504 198,564 271,625 390,655 554,655 L 797,655 797,715 C 797,804 778,868 741,907 704,946 645,965 565,965 484,965 426,951 389,924 352,897 330,853 323,793 L 135,810 C 166,1005 310,1102 569,1102 705,1102 807,1071 876,1009 945,946 979,856 979,738 L 979,272 C 979,219 986,179 1000,152 1014,125 1041,111 1080,111 1097,111 1117,113 1139,118 L 1139,6 C 1094,-5 1047,-10 1000,-10 933,-10 885,8 855,43 824,78 807,132 803,207 L 797,207 C 751,124 698,66 637,32 576,-3 501,-20 414,-20 Z M 455,115 C 521,115 580,130 631,160 682,189 723,230 753,282 782,334 797,388 797,443 L 797,531 600,531 C 515,531 451,523 408,507 364,491 330,466 307,432 284,399 272,355 272,300 272,241 288,196 320,163 351,131 396,115 455,115 Z"/>
<glyph unicode="W" horiz-adv-x="1932" d="M 1511,0 L 1283,0 1039,895 C 1023,951 1000,1051 969,1196 952,1119 937,1054 925,1002 913,950 822,616 652,0 L 424,0 9,1409 208,1409 461,514 C 491,402 519,287 544,168 560,241 579,321 600,408 621,495 713,828 877,1409 L 1060,1409 1305,532 C 1342,389 1372,267 1393,168 L 1402,203 C 1420,280 1435,342 1446,391 1457,439 1551,778 1727,1409 L 1926,1409 1511,0 Z"/>
<glyph unicode="R" horiz-adv-x="1244" d="M 1164,0 L 798,585 359,585 359,0 168,0 168,1409 831,1409 C 990,1409 1112,1374 1199,1303 1285,1232 1328,1133 1328,1006 1328,901 1298,813 1237,742 1176,671 1091,626 984,607 L 1384,0 1164,0 Z M 1136,1004 C 1136,1086 1108,1149 1053,1192 997,1235 917,1256 812,1256 L 359,1256 359,736 820,736 C 921,736 999,760 1054,807 1109,854 1136,919 1136,1004 Z"/>
<glyph unicode="P" horiz-adv-x="1112" d="M 1258,985 C 1258,852 1215,746 1128,667 1041,588 922,549 773,549 L 359,549 359,0 168,0 168,1409 761,1409 C 919,1409 1041,1372 1128,1298 1215,1224 1258,1120 1258,985 Z M 1066,983 C 1066,1165 957,1256 738,1256 L 359,1256 359,700 746,700 C 959,700 1066,794 1066,983 Z"/>
<glyph unicode="N" horiz-adv-x="1165" d="M 1082,0 L 328,1200 333,1103 338,936 338,0 168,0 168,1409 390,1409 1152,201 C 1144,332 1140,426 1140,485 L 1140,1409 1312,1409 1312,0 1082,0 Z"/>
<glyph unicode="M" horiz-adv-x="1377" d="M 1366,0 L 1366,940 C 1366,1044 1369,1144 1375,1240 1342,1121 1313,1027 1287,960 L 923,0 789,0 420,960 364,1130 331,1240 334,1129 338,940 338,0 168,0 168,1409 419,1409 794,432 C 807,393 820,351 833,306 845,261 853,228 857,208 862,235 874,275 891,330 908,384 919,418 925,432 L 1293,1409 1538,1409 1538,0 1366,0 Z"/>
<glyph unicode="G" horiz-adv-x="1377" d="M 103,711 C 103,940 164,1117 287,1242 410,1367 582,1430 804,1430 960,1430 1087,1404 1184,1351 1281,1298 1356,1214 1409,1098 L 1227,1044 C 1187,1124 1132,1182 1062,1219 991,1256 904,1274 799,1274 636,1274 512,1225 426,1127 340,1028 297,890 297,711 297,533 343,393 434,290 525,187 652,135 813,135 905,135 991,149 1071,177 1150,205 1215,243 1264,291 L 1264,545 843,545 843,705 1440,705 1440,219 C 1365,143 1274,84 1166,43 1057,1 940,-20 813,-20 666,-20 539,9 432,68 325,127 244,211 188,322 131,432 103,562 103,711 Z"/>
<glyph unicode="D" horiz-adv-x="1218" d="M 1381,719 C 1381,574 1353,447 1296,338 1239,229 1159,145 1055,87 951,29 831,0 695,0 L 168,0 168,1409 634,1409 C 873,1409 1057,1349 1187,1230 1316,1110 1381,940 1381,719 Z M 1189,719 C 1189,894 1141,1027 1046,1119 950,1210 811,1256 630,1256 L 359,1256 359,153 673,153 C 776,153 867,176 946,221 1024,266 1084,332 1126,417 1168,502 1189,603 1189,719 Z"/>
<glyph unicode="C" horiz-adv-x="1324" d="M 792,1274 C 636,1274 515,1224 428,1124 341,1023 298,886 298,711 298,538 343,400 434,295 524,190 646,137 800,137 997,137 1146,235 1245,430 L 1401,352 C 1343,231 1262,138 1157,75 1052,12 930,-20 791,-20 649,-20 526,10 423,69 319,128 240,212 186,322 131,431 104,561 104,711 104,936 165,1112 286,1239 407,1366 575,1430 790,1430 940,1430 1065,1401 1166,1342 1267,1283 1341,1196 1388,1081 L 1207,1021 C 1174,1103 1122,1166 1050,1209 977,1252 891,1274 792,1274 Z"/>
<glyph unicode="," horiz-adv-x="239" d="M 385,219 L 385,51 C 385,-20 379,-79 366,-126 353,-173 334,-219 307,-262 L 184,-262 C 247,-171 278,-84 278,0 L 190,0 190,219 385,219 Z"/>
<glyph unicode=" " horiz-adv-x="556"/>
</font>
</defs>
<defs class="TextShapeIndex">
<g ooo:slide="id1" ooo:id-list="id3 id4 id5 id6 id7 id8 id9 id10 id11 id12 id13"/>
</defs>
<defs class="EmbeddedBulletChars">
<g id="bullet-char-template(57356)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 580,1141 L 1163,571 580,0 -4,571 580,1141 Z"/>
</g>
<g id="bullet-char-template(57354)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 8,1128 L 1137,1128 1137,0 8,0 8,1128 Z"/>
</g>
<g id="bullet-char-template(10146)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 174,0 L 602,739 174,1481 1456,739 174,0 Z M 1358,739 L 309,1346 659,739 1358,739 Z"/>
</g>
<g id="bullet-char-template(10132)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 2015,739 L 1276,0 717,0 1260,543 174,543 174,936 1260,936 717,1481 1274,1481 2015,739 Z"/>
</g>
<g id="bullet-char-template(10007)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 0,-2 C -7,14 -16,27 -25,37 L 356,567 C 262,823 215,952 215,954 215,979 228,992 255,992 264,992 276,990 289,987 310,991 331,999 354,1012 L 381,999 492,748 772,1049 836,1024 860,1049 C 881,1039 901,1025 922,1006 886,937 835,863 770,784 769,783 710,716 594,584 L 774,223 C 774,196 753,168 711,139 L 727,119 C 717,90 699,76 672,76 641,76 570,178 457,381 L 164,-76 C 142,-110 111,-127 72,-127 30,-127 9,-110 8,-76 1,-67 -2,-52 -2,-32 -2,-23 -1,-13 0,-2 Z"/>
</g>
<g id="bullet-char-template(10004)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 285,-33 C 182,-33 111,30 74,156 52,228 41,333 41,471 41,549 55,616 82,672 116,743 169,778 240,778 293,778 328,747 346,684 L 369,508 C 377,444 397,411 428,410 L 1163,1116 C 1174,1127 1196,1133 1229,1133 1271,1133 1292,1118 1292,1087 L 1292,965 C 1292,929 1282,901 1262,881 L 442,47 C 390,-6 338,-33 285,-33 Z"/>
</g>
<g id="bullet-char-template(9679)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 813,0 C 632,0 489,54 383,161 276,268 223,411 223,592 223,773 276,916 383,1023 489,1130 632,1184 813,1184 992,1184 1136,1130 1245,1023 1353,916 1407,772 1407,592 1407,412 1353,268 1245,161 1136,54 992,0 813,0 Z"/>
</g>
<g id="bullet-char-template(8226)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 346,457 C 273,457 209,483 155,535 101,586 74,649 74,723 74,796 101,859 155,911 209,963 273,989 346,989 419,989 480,963 531,910 582,859 608,796 608,723 608,648 583,586 532,535 482,483 420,457 346,457 Z"/>
</g>
<g id="bullet-char-template(8211)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M -4,459 L 1135,459 1135,606 -4,606 -4,459 Z"/>
</g>
</defs>
<defs class="TextEmbeddedBitmaps"/>
<g>
<g id="id2" class="Master_Slide">
<g id="bg-id2" class="Background"/>
<g id="bo-id2" class="BackgroundObjects"/>
</g>
</g>
<g class="SlideGroup">
<g>
<g id="id1" class="Slide" clip-path="url(#presentation_clip_path)">
<g class="Page">
<g class="com.sun.star.drawing.RectangleShape">
<g id="id3">
<path fill="rgb(51,153,255)" stroke="none" d="M 7640,3170 L 5688,3176 5656,1790 9561,1779 9593,3165 7640,3170 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7640,3170 L 5688,3176 5656,1790 9561,1779 9593,3165 7640,3170 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.RectangleShape">
<g id="id4">
<path fill="rgb(51,153,255)" stroke="none" d="M 7716,9148 L 5764,9154 5732,7768 9637,7757 9669,9143 7716,9148 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7716,9148 L 5764,9154 5732,7768 9637,7757 9669,9143 7716,9148 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.RectangleShape">
<g id="id5">
<path fill="rgb(207,231,229)" stroke="none" d="M 7674,6156 L 5722,6162 5690,4776 9595,4765 9627,6151 7674,6156 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7674,6156 L 5722,6162 5690,4776 9595,4765 9627,6151 7674,6156 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id6">
<path fill="none" stroke="rgb(0,0,0)" d="M 7596,1000 L 7604,1494"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7608,1785 L 7705,1479 7502,1482 7608,1785 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id7">
<path fill="none" stroke="rgb(0,0,0)" d="M 7640,3170 L 7642,4480"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7642,4771 L 7743,4466 7540,4467 7642,4771 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id8">
<path fill="none" stroke="rgb(0,0,0)" d="M 7674,6156 L 7682,7472"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7684,7763 L 7784,7458 7581,7459 7684,7763 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id9">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="7884" y="3877"><tspan fill="rgb(0,0,0)" stroke="none">Public, Member Confidential,</tspan></tspan><tspan class="TextPosition" x="7884" y="4199"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Confidential</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id10">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="7884" y="6878"><tspan fill="rgb(0,0,0)" stroke="none">Public, Member Confidential,</tspan></tspan><tspan class="TextPosition" x="7884" y="7200"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Confidential</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id11">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6255" y="2412"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Note</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="7237" y="2810"><tspan fill="rgb(0,0,0)" stroke="none">Draft</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id12">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6279" y="5397"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Note</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6637" y="5795"><tspan fill="rgb(0,0,0)" stroke="none">Review Draft</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id13">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6315" y="8574"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Note</tspan></tspan></tspan></text>
</g>
</g>
</g>
</g>
</g>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 18 KiB

BIN
Intrinsics_Reference/figures/project_process_std_track_graphic.odg
View File

Binary file not shown.

208
Intrinsics_Reference/figures/project_process_std_track_graphic.svg
Unescape Escape View File

@ -0,0 +1,208 @@
<?xml version="1.0" encoding="UTF-8"?>

<svg version="1.2" baseProfile="tiny" width="152.4mm" height="146.05mm" viewBox="0 0 15240 14605" preserveAspectRatio="xMidYMid" fill-rule="evenodd" clip-path="url(#presentation_clip_path)" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
<defs class="ClipPathGroup">
<clipPath id="presentation_clip_path" clipPathUnits="userSpaceOnUse">
<rect x="0" y="0" width="15240" height="14605"/>
</clipPath>
</defs>
<defs>
<font id="EmbeddedFont_1" horiz-adv-x="2048">
<font-face font-family="Arimo embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1852" descent="450"/>
<missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
<glyph unicode="w" horiz-adv-x="1509" d="M 1174,0 L 965,0 776,765 740,934 C 734,904 725,861 712,805 699,748 631,480 508,0 L 300,0 -3,1082 175,1082 358,347 C 363,331 377,265 401,149 L 418,223 644,1082 837,1082 1026,339 1072,149 1103,288 1308,1082 1484,1082 1174,0 Z"/>
<glyph unicode="v" horiz-adv-x="1033" d="M 613,0 L 400,0 7,1082 199,1082 437,378 C 446,351 469,272 506,141 L 541,258 580,376 826,1082 1017,1082 613,0 Z"/>
<glyph unicode="u" horiz-adv-x="874" d="M 314,1082 L 314,396 C 314,325 321,269 335,230 349,191 371,162 402,145 433,128 478,119 537,119 624,119 692,149 742,208 792,267 817,350 817,455 L 817,1082 997,1082 997,231 C 997,105 999,28 1003,0 L 833,0 C 832,3 832,12 831,27 830,42 830,59 829,78 828,97 826,132 825,185 L 822,185 C 781,110 733,58 679,27 624,-4 557,-20 476,-20 357,-20 271,10 216,69 161,128 133,225 133,361 L 133,1082 314,1082 Z"/>
<glyph unicode="t" horiz-adv-x="531" d="M 554,8 C 495,-8 434,-16 372,-16 228,-16 156,66 156,229 L 156,951 31,951 31,1082 163,1082 216,1324 336,1324 336,1082 536,1082 536,951 336,951 336,268 C 336,216 345,180 362,159 379,138 408,127 450,127 474,127 509,132 554,141 L 554,8 Z"/>
<glyph unicode="r" horiz-adv-x="530" d="M 142,0 L 142,830 C 142,906 140,990 136,1082 L 306,1082 C 311,959 314,886 314,861 L 318,861 C 347,954 380,1017 417,1051 454,1085 507,1102 575,1102 599,1102 623,1099 648,1092 L 648,927 C 624,934 592,937 552,937 477,937 420,905 381,841 342,776 322,684 322,564 L 322,0 142,0 Z"/>
<glyph unicode="p" horiz-adv-x="953" d="M 1053,546 C 1053,169 920,-20 655,-20 488,-20 376,43 319,168 L 314,168 C 317,163 318,106 318,-2 L 318,-425 138,-425 138,861 C 138,972 136,1046 132,1082 L 306,1082 C 307,1079 308,1070 309,1054 310,1037 312,1012 314,978 315,944 316,921 316,908 L 320,908 C 352,975 394,1024 447,1055 500,1086 569,1101 655,1101 788,1101 888,1056 954,967 1020,878 1053,737 1053,546 Z M 864,542 C 864,693 844,800 803,865 762,930 698,962 609,962 538,962 482,947 442,917 401,887 371,840 350,777 329,713 318,630 318,528 318,386 341,281 386,214 431,147 505,113 607,113 696,113 762,146 803,212 844,277 864,387 864,542 Z"/>
<glyph unicode="o" horiz-adv-x="980" d="M 1053,542 C 1053,353 1011,212 928,119 845,26 724,-20 565,-20 407,-20 288,28 207,125 126,221 86,360 86,542 86,915 248,1102 571,1102 736,1102 858,1057 936,966 1014,875 1053,733 1053,542 Z M 864,542 C 864,691 842,800 798,868 753,935 679,969 574,969 469,969 393,935 346,866 299,797 275,689 275,542 275,399 298,292 345,221 391,149 464,113 563,113 671,113 748,148 795,217 841,286 864,395 864,542 Z"/>
<glyph unicode="n" horiz-adv-x="874" d="M 825,0 L 825,686 C 825,757 818,813 804,852 790,891 768,920 737,937 706,954 661,963 602,963 515,963 447,933 397,874 347,815 322,732 322,627 L 322,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 358,972 406,1025 461,1056 515,1087 582,1102 663,1102 782,1102 869,1073 924,1014 979,955 1006,857 1006,721 L 1006,0 825,0 Z"/>
<glyph unicode="m" horiz-adv-x="1457" d="M 768,0 L 768,686 C 768,791 754,863 725,903 696,943 645,963 570,963 493,963 433,934 388,875 343,816 321,734 321,627 L 321,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 356,974 400,1027 450,1057 500,1087 561,1102 633,1102 715,1102 780,1086 828,1053 875,1020 908,968 927,897 L 930,897 C 967,970 1013,1022 1066,1054 1119,1086 1183,1102 1258,1102 1367,1102 1447,1072 1497,1013 1546,954 1571,856 1571,721 L 1571,0 1393,0 1393,686 C 1393,791 1379,863 1350,903 1321,943 1270,963 1195,963 1116,963 1055,934 1012,876 968,817 946,734 946,627 L 946,0 768,0 Z"/>
<glyph unicode="l" horiz-adv-x="187" d="M 138,0 L 138,1484 318,1484 318,0 138,0 Z"/>
<glyph unicode="k" horiz-adv-x="901" d="M 816,0 L 450,494 318,385 318,0 138,0 138,1484 318,1484 318,557 793,1082 1004,1082 565,617 1027,0 816,0 Z"/>
<glyph unicode="i" horiz-adv-x="187" d="M 137,1312 L 137,1484 317,1484 317,1312 137,1312 Z M 137,0 L 137,1082 317,1082 317,0 137,0 Z"/>
<glyph unicode="f" horiz-adv-x="557" d="M 361,951 L 361,0 181,0 181,951 29,951 29,1082 181,1082 181,1204 C 181,1303 203,1374 246,1417 289,1460 356,1482 445,1482 495,1482 537,1478 572,1470 L 572,1333 C 542,1338 515,1341 492,1341 446,1341 413,1329 392,1306 371,1283 361,1240 361,1179 L 361,1082 572,1082 572,951 361,951 Z"/>
<glyph unicode="e" horiz-adv-x="980" d="M 276,503 C 276,379 302,283 353,216 404,149 479,115 578,115 656,115 719,131 766,162 813,193 844,233 861,281 L 1019,236 C 954,65 807,-20 578,-20 418,-20 296,28 213,123 129,218 87,360 87,548 87,727 129,864 213,959 296,1054 416,1102 571,1102 889,1102 1048,910 1048,527 L 1048,503 276,503 Z M 862,641 C 852,755 823,838 775,891 727,943 658,969 568,969 481,969 412,940 361,882 310,823 282,743 278,641 L 862,641 Z"/>
<glyph unicode="d" horiz-adv-x="927" d="M 821,174 C 788,105 744,55 689,25 634,-5 565,-20 484,-20 347,-20 247,26 183,118 118,210 86,349 86,536 86,913 219,1102 484,1102 566,1102 634,1087 689,1057 744,1027 788,979 821,914 L 823,914 821,1035 821,1484 1001,1484 1001,223 C 1001,110 1003,36 1007,0 L 835,0 C 833,11 831,35 829,74 826,113 825,146 825,174 L 821,174 Z M 275,542 C 275,391 295,282 335,217 375,152 440,119 530,119 632,119 706,154 752,225 798,296 821,405 821,554 821,697 798,802 752,869 706,936 633,969 532,969 441,969 376,936 336,869 295,802 275,693 275,542 Z"/>
<glyph unicode="c" horiz-adv-x="901" d="M 275,546 C 275,402 298,295 343,226 388,157 457,122 548,122 612,122 666,139 709,173 752,206 778,258 788,328 L 970,328 C 956,222 912,138 837,75 762,12 668,-20 553,-20 402,-20 286,28 207,124 127,219 87,359 87,542 87,724 127,863 207,959 287,1054 402,1102 551,1102 662,1102 754,1073 827,1016 900,959 945,880 964,779 L 779,765 C 770,825 746,873 708,908 670,943 616,961 546,961 451,961 382,929 339,866 296,803 275,696 275,546 Z"/>
<glyph unicode="b" horiz-adv-x="953" d="M 1053,546 C 1053,169 920,-20 655,-20 573,-20 505,-5 451,25 396,54 352,102 318,168 L 316,168 C 316,147 315,116 312,74 309,31 307,7 306,0 L 132,0 C 136,36 138,110 138,223 L 138,1484 318,1484 318,1061 C 318,1018 317,967 314,908 L 318,908 C 351,977 396,1027 451,1057 506,1087 574,1102 655,1102 792,1102 892,1056 957,964 1021,872 1053,733 1053,546 Z M 864,540 C 864,691 844,800 804,865 764,930 699,963 609,963 508,963 434,928 388,859 341,790 318,680 318,529 318,387 341,282 386,215 431,147 505,113 607,113 698,113 763,147 804,214 844,281 864,389 864,540 Z"/>
<glyph unicode="a" horiz-adv-x="1060" d="M 414,-20 C 305,-20 224,9 169,67 114,124 87,204 87,304 87,417 124,504 198,564 271,625 390,655 554,655 L 797,655 797,715 C 797,804 778,868 741,907 704,946 645,965 565,965 484,965 426,951 389,924 352,897 330,853 323,793 L 135,810 C 166,1005 310,1102 569,1102 705,1102 807,1071 876,1009 945,946 979,856 979,738 L 979,272 C 979,219 986,179 1000,152 1014,125 1041,111 1080,111 1097,111 1117,113 1139,118 L 1139,6 C 1094,-5 1047,-10 1000,-10 933,-10 885,8 855,43 824,78 807,132 803,207 L 797,207 C 751,124 698,66 637,32 576,-3 501,-20 414,-20 Z M 455,115 C 521,115 580,130 631,160 682,189 723,230 753,282 782,334 797,388 797,443 L 797,531 600,531 C 515,531 451,523 408,507 364,491 330,466 307,432 284,399 272,355 272,300 272,241 288,196 320,163 351,131 396,115 455,115 Z"/>
<glyph unicode="W" horiz-adv-x="1932" d="M 1511,0 L 1283,0 1039,895 C 1023,951 1000,1051 969,1196 952,1119 937,1054 925,1002 913,950 822,616 652,0 L 424,0 9,1409 208,1409 461,514 C 491,402 519,287 544,168 560,241 579,321 600,408 621,495 713,828 877,1409 L 1060,1409 1305,532 C 1342,389 1372,267 1393,168 L 1402,203 C 1420,280 1435,342 1446,391 1457,439 1551,778 1727,1409 L 1926,1409 1511,0 Z"/>
<glyph unicode="S" horiz-adv-x="1192" d="M 1272,389 C 1272,259 1221,158 1120,87 1018,16 875,-20 690,-20 347,-20 148,99 93,338 L 278,375 C 299,290 345,228 414,189 483,149 578,129 697,129 820,129 916,150 983,193 1050,235 1083,297 1083,379 1083,425 1073,462 1052,491 1031,520 1001,543 963,562 925,581 880,596 827,609 774,622 716,635 652,650 541,675 456,699 399,724 341,749 295,776 262,807 229,837 203,872 186,913 168,954 159,1000 159,1053 159,1174 205,1267 298,1332 390,1397 522,1430 694,1430 854,1430 976,1406 1061,1357 1146,1308 1205,1224 1239,1106 L 1051,1073 C 1030,1148 991,1202 933,1236 875,1269 795,1286 692,1286 579,1286 493,1267 434,1230 375,1193 345,1137 345,1063 345,1020 357,984 380,956 403,927 436,903 479,884 522,864 609,840 738,811 781,801 825,791 868,781 911,770 952,758 991,744 1030,729 1067,712 1102,693 1136,674 1166,650 1191,622 1216,594 1236,561 1251,523 1265,485 1272,440 1272,389 Z"/>
<glyph unicode="R" horiz-adv-x="1244" d="M 1164,0 L 798,585 359,585 359,0 168,0 168,1409 831,1409 C 990,1409 1112,1374 1199,1303 1285,1232 1328,1133 1328,1006 1328,901 1298,813 1237,742 1176,671 1091,626 984,607 L 1384,0 1164,0 Z M 1136,1004 C 1136,1086 1108,1149 1053,1192 997,1235 917,1256 812,1256 L 359,1256 359,736 820,736 C 921,736 999,760 1054,807 1109,854 1136,919 1136,1004 Z"/>
<glyph unicode="P" horiz-adv-x="1112" d="M 1258,985 C 1258,852 1215,746 1128,667 1041,588 922,549 773,549 L 359,549 359,0 168,0 168,1409 761,1409 C 919,1409 1041,1372 1128,1298 1215,1224 1258,1120 1258,985 Z M 1066,983 C 1066,1165 957,1256 738,1256 L 359,1256 359,700 746,700 C 959,700 1066,794 1066,983 Z"/>
<glyph unicode="O" horiz-adv-x="1430" d="M 1495,711 C 1495,564 1467,435 1411,324 1354,213 1273,128 1168,69 1063,10 938,-20 795,-20 650,-20 526,9 421,68 316,127 235,212 180,323 125,434 97,563 97,711 97,936 159,1113 282,1240 405,1367 577,1430 797,1430 940,1430 1065,1402 1170,1345 1275,1288 1356,1205 1412,1096 1467,987 1495,859 1495,711 Z M 1300,711 C 1300,886 1256,1024 1169,1124 1081,1224 957,1274 797,1274 636,1274 511,1225 423,1126 335,1027 291,889 291,711 291,534 336,394 425,291 514,187 637,135 795,135 958,135 1083,185 1170,286 1257,386 1300,528 1300,711 Z"/>
<glyph unicode="M" horiz-adv-x="1377" d="M 1366,0 L 1366,940 C 1366,1044 1369,1144 1375,1240 1342,1121 1313,1027 1287,960 L 923,0 789,0 420,960 364,1130 331,1240 334,1129 338,940 338,0 168,0 168,1409 419,1409 794,432 C 807,393 820,351 833,306 845,261 853,228 857,208 862,235 874,275 891,330 908,384 919,418 925,432 L 1293,1409 1538,1409 1538,0 1366,0 Z"/>
<glyph unicode="G" horiz-adv-x="1377" d="M 103,711 C 103,940 164,1117 287,1242 410,1367 582,1430 804,1430 960,1430 1087,1404 1184,1351 1281,1298 1356,1214 1409,1098 L 1227,1044 C 1187,1124 1132,1182 1062,1219 991,1256 904,1274 799,1274 636,1274 512,1225 426,1127 340,1028 297,890 297,711 297,533 343,393 434,290 525,187 652,135 813,135 905,135 991,149 1071,177 1150,205 1215,243 1264,291 L 1264,545 843,545 843,705 1440,705 1440,219 C 1365,143 1274,84 1166,43 1057,1 940,-20 813,-20 666,-20 539,9 432,68 325,127 244,211 188,322 131,432 103,562 103,711 Z"/>
<glyph unicode="E" horiz-adv-x="1138" d="M 168,0 L 168,1409 1237,1409 1237,1253 359,1253 359,801 1177,801 1177,647 359,647 359,156 1278,156 1278,0 168,0 Z"/>
<glyph unicode="D" horiz-adv-x="1218" d="M 1381,719 C 1381,574 1353,447 1296,338 1239,229 1159,145 1055,87 951,29 831,0 695,0 L 168,0 168,1409 634,1409 C 873,1409 1057,1349 1187,1230 1316,1110 1381,940 1381,719 Z M 1189,719 C 1189,894 1141,1027 1046,1119 950,1210 811,1256 630,1256 L 359,1256 359,153 673,153 C 776,153 867,176 946,221 1024,266 1084,332 1126,417 1168,502 1189,603 1189,719 Z"/>
<glyph unicode="C" horiz-adv-x="1324" d="M 792,1274 C 636,1274 515,1224 428,1124 341,1023 298,886 298,711 298,538 343,400 434,295 524,190 646,137 800,137 997,137 1146,235 1245,430 L 1401,352 C 1343,231 1262,138 1157,75 1052,12 930,-20 791,-20 649,-20 526,10 423,69 319,128 240,212 186,322 131,431 104,561 104,711 104,936 165,1112 286,1239 407,1366 575,1430 790,1430 940,1430 1065,1401 1166,1342 1267,1283 1341,1196 1388,1081 L 1207,1021 C 1174,1103 1122,1166 1050,1209 977,1252 891,1274 792,1274 Z"/>
<glyph unicode="," horiz-adv-x="239" d="M 385,219 L 385,51 C 385,-20 379,-79 366,-126 353,-173 334,-219 307,-262 L 184,-262 C 247,-171 278,-84 278,0 L 190,0 190,219 385,219 Z"/>
<glyph unicode=" " horiz-adv-x="556"/>
</font>
</defs>
<defs class="TextShapeIndex">
<g ooo:slide="id1" ooo:id-list="id3 id4 id5 id6 id7 id8 id9 id10 id11 id12 id13 id14 id15 id16 id17 id18 id19 id20 id21 id22 id23"/>
</defs>
<defs class="EmbeddedBulletChars">
<g id="bullet-char-template(57356)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 580,1141 L 1163,571 580,0 -4,571 580,1141 Z"/>
</g>
<g id="bullet-char-template(57354)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 8,1128 L 1137,1128 1137,0 8,0 8,1128 Z"/>
</g>
<g id="bullet-char-template(10146)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 174,0 L 602,739 174,1481 1456,739 174,0 Z M 1358,739 L 309,1346 659,739 1358,739 Z"/>
</g>
<g id="bullet-char-template(10132)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 2015,739 L 1276,0 717,0 1260,543 174,543 174,936 1260,936 717,1481 1274,1481 2015,739 Z"/>
</g>
<g id="bullet-char-template(10007)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 0,-2 C -7,14 -16,27 -25,37 L 356,567 C 262,823 215,952 215,954 215,979 228,992 255,992 264,992 276,990 289,987 310,991 331,999 354,1012 L 381,999 492,748 772,1049 836,1024 860,1049 C 881,1039 901,1025 922,1006 886,937 835,863 770,784 769,783 710,716 594,584 L 774,223 C 774,196 753,168 711,139 L 727,119 C 717,90 699,76 672,76 641,76 570,178 457,381 L 164,-76 C 142,-110 111,-127 72,-127 30,-127 9,-110 8,-76 1,-67 -2,-52 -2,-32 -2,-23 -1,-13 0,-2 Z"/>
</g>
<g id="bullet-char-template(10004)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 285,-33 C 182,-33 111,30 74,156 52,228 41,333 41,471 41,549 55,616 82,672 116,743 169,778 240,778 293,778 328,747 346,684 L 369,508 C 377,444 397,411 428,410 L 1163,1116 C 1174,1127 1196,1133 1229,1133 1271,1133 1292,1118 1292,1087 L 1292,965 C 1292,929 1282,901 1262,881 L 442,47 C 390,-6 338,-33 285,-33 Z"/>
</g>
<g id="bullet-char-template(9679)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 813,0 C 632,0 489,54 383,161 276,268 223,411 223,592 223,773 276,916 383,1023 489,1130 632,1184 813,1184 992,1184 1136,1130 1245,1023 1353,916 1407,772 1407,592 1407,412 1353,268 1245,161 1136,54 992,0 813,0 Z"/>
</g>
<g id="bullet-char-template(8226)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 346,457 C 273,457 209,483 155,535 101,586 74,649 74,723 74,796 101,859 155,911 209,963 273,989 346,989 419,989 480,963 531,910 582,859 608,796 608,723 608,648 583,586 532,535 482,483 420,457 346,457 Z"/>
</g>
<g id="bullet-char-template(8211)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M -4,459 L 1135,459 1135,606 -4,606 -4,459 Z"/>
</g>
</defs>
<defs class="TextEmbeddedBitmaps"/>
<g>
<g id="id2" class="Master_Slide">
<g id="bg-id2" class="Background"/>
<g id="bo-id2" class="BackgroundObjects"/>
</g>
</g>
<g class="SlideGroup">
<g>
<g id="id1" class="Slide" clip-path="url(#presentation_clip_path)">
<g class="Page">
<g class="com.sun.star.drawing.RectangleShape">
<g id="id3">
<path fill="rgb(51,153,255)" stroke="none" d="M 7640,3188 L 5688,3194 5656,1808 9561,1797 9593,3183 7640,3188 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7640,3188 L 5688,3194 5656,1808 9561,1797 9593,3183 7640,3188 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.RectangleShape">
<g id="id4">
<path fill="rgb(51,153,255)" stroke="none" d="M 7708,8366 L 5756,8372 5724,6986 9629,6975 9661,8361 7708,8366 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7708,8366 L 5756,8372 5724,6986 9629,6975 9661,8361 7708,8366 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.RectangleShape">
<g id="id5">
<path fill="rgb(207,231,229)" stroke="none" d="M 7674,5774 L 5722,5780 5690,4394 9595,4383 9627,5769 7674,5774 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7674,5774 L 5722,5780 5690,4394 9595,4383 9627,5769 7674,5774 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.RectangleShape">
<g id="id6">
<path fill="rgb(207,231,229)" stroke="none" d="M 7749,10975 L 5797,10981 5765,9595 9670,9584 9702,10970 7749,10975 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7749,10975 L 5797,10981 5765,9595 9670,9584 9702,10970 7749,10975 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id7">
<path fill="none" stroke="rgb(0,0,0)" d="M 7596,1018 L 7604,1512"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7608,1803 L 7705,1497 7502,1500 7608,1803 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id8">
<path fill="none" stroke="rgb(0,0,0)" d="M 7640,3188 L 7642,4098"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7642,4389 L 7743,4084 7540,4085 7642,4389 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id9">
<path fill="none" stroke="rgb(0,0,0)" d="M 7674,5774 L 7676,6690"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7676,6981 L 7777,6676 7574,6677 7676,6981 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id10">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="7884" y="3732"><tspan fill="rgb(0,0,0)" stroke="none">Public, Member Confidential,</tspan></tspan><tspan class="TextPosition" x="7884" y="4054"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Confidential</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id11">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="7884" y="6333"><tspan fill="rgb(0,0,0)" stroke="none">Public, Member Confidential,</tspan></tspan><tspan class="TextPosition" x="7884" y="6655"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Confidential</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id12">
<path fill="none" stroke="rgb(0,0,0)" d="M 7708,8366 L 7715,9299"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7717,9590 L 7816,9285 7613,9286 7717,9590 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id13">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="7884" y="8934"><tspan fill="rgb(0,0,0)" stroke="none">Public</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.RectangleShape">
<g id="id14">
<path fill="rgb(51,153,255)" stroke="none" d="M 7787,13567 L 5835,13573 5803,12187 9708,12176 9740,13562 7787,13567 Z"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 7787,13567 L 5835,13573 5803,12187 9708,12176 9740,13562 7787,13567 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id15">
<path fill="none" stroke="rgb(0,0,0)" d="M 7749,10975 L 7754,11891"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 7755,12182 L 7855,11877 7652,11878 7755,12182 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id16">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="7870" y="11534"><tspan fill="rgb(0,0,0)" stroke="none">Public</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id17">
<path fill="none" stroke="rgb(0,0,0)" d="M 5740,7679 L 4683,7679 4683,5087 5415,5087"/>
<path fill="rgb(0,0,0)" stroke="none" d="M 5706,5087 L 5402,4986 5402,5189 5706,5087 Z"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id18">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="3539" y="6134"><tspan fill="rgb(0,0,0)" stroke="none">Public, </tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="282px" font-weight="400"><tspan class="TextPosition" x="1783" y="6456"><tspan fill="rgb(0,0,0)" stroke="none">Member Confidential,</tspan></tspan><tspan class="TextPosition" x="1385" y="6778"><tspan fill="rgb(0,0,0)" stroke="none">Work Group Confidential</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id19">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6662" y="2226"><tspan fill="rgb(0,0,0)" stroke="none">Work Group</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6613" y="2624"><tspan fill="rgb(0,0,0)" stroke="none">Specification</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="7225" y="3022"><tspan fill="rgb(0,0,0)" stroke="none">Draft</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id20">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6687" y="4809"><tspan fill="rgb(0,0,0)" stroke="none">Work Group</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6014" y="5207"><tspan fill="rgb(0,0,0)" stroke="none">Specification Review</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="7250" y="5605"><tspan fill="rgb(0,0,0)" stroke="none">Draft</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id21">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6727" y="7609"><tspan fill="rgb(0,0,0)" stroke="none">Work Group</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6678" y="8007"><tspan fill="rgb(0,0,0)" stroke="none">Specification</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id22">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="6903" y="10210"><tspan fill="rgb(0,0,0)" stroke="none">Candidate</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="5897" y="10608"><tspan fill="rgb(0,0,0)" stroke="none">OpenPOWERStandard</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id23">
<text class="TextShape"><tspan class="TextParagraph" font-family="Arimo, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="5944" y="13011"><tspan fill="rgb(0,0,0)" stroke="none">OpenPOWERStandard</tspan></tspan></tspan></text>
</g>
</g>
</g>
</g>
</g>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

BIN
Intrinsics_Reference/figures/project_structure_graphic.odg
View File

Binary file not shown.

451
Intrinsics_Reference/figures/project_structure_graphic.svg
Unescape Escape View File

@ -0,0 +1,451 @@
<?xml version="1.0" encoding="UTF-8"?>

<svg version="1.2" baseProfile="tiny" width="152.4mm" height="152.4mm" viewBox="0 0 15240 15240" preserveAspectRatio="xMidYMid" fill-rule="evenodd" clip-path="url(#presentation_clip_path)" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
<defs class="ClipPathGroup">
<clipPath id="presentation_clip_path" clipPathUnits="userSpaceOnUse">
<rect x="0" y="0" width="15240" height="15240"/>
</clipPath>
</defs>
<defs>
<font id="EmbeddedFont_1" horiz-adv-x="2048">
<font-face font-family="Cousine embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1720" descent="635"/>
<missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
<glyph unicode="y" horiz-adv-x="1112" d="M 292,-425 C 243,-425 201,-421 168,-414 L 168,-279 C 193,-283 221,-285 252,-285 305,-285 354,-265 401,-226 447,-187 486,-124 518,-38 L 536,11 66,1082 258,1082 522,440 C 583,291 615,206 620,186 L 661,296 971,1082 1161,1082 705,0 C 646,-157 584,-267 521,-330 457,-393 381,-425 292,-425 Z"/>
<glyph unicode="x" horiz-adv-x="1060" d="M 932,0 L 611,444 288,0 94,0 509,556 112,1082 311,1082 611,661 909,1082 1110,1082 713,558 1133,0 932,0 Z"/>
<glyph unicode="u" horiz-adv-x="900" d="M 365,1082 L 365,396 C 365,292 381,220 414,180 447,139 505,119 589,119 675,119 743,148 793,207 843,266 868,348 868,455 L 868,1082 1049,1082 1049,231 C 1049,105 1051,28 1055,0 L 885,0 C 884,3 884,12 883,27 882,42 882,59 881,78 880,97 878,132 877,185 L 874,185 C 833,110 785,58 731,27 676,-4 609,-20 528,-20 409,-20 323,10 268,69 213,128 185,225 185,361 L 185,1082 365,1082 Z"/>
<glyph unicode="t" horiz-adv-x="848" d="M 190,940 L 190,1082 360,1082 418,1364 538,1364 538,1082 970,1082 970,940 538,940 538,288 C 538,235 552,196 581,171 609,146 655,133 720,133 809,133 908,144 1017,167 L 1017,30 C 904,-1 793,-16 682,-16 574,-16 493,7 439,53 385,98 358,170 358,269 L 358,940 190,940 Z"/>
<glyph unicode="s" horiz-adv-x="900" d="M 1060,309 C 1060,206 1021,126 944,68 866,9 758,-20 621,-20 484,-20 379,2 308,45 236,88 189,155 167,248 L 326,279 C 339,222 366,180 408,154 449,127 520,114 621,114 801,114 891,171 891,285 891,328 875,362 842,389 809,415 759,436 692,453 516,496 404,530 357,555 310,580 273,611 248,648 223,685 210,731 210,786 210,884 245,961 316,1016 387,1071 489,1099 623,1099 740,1099 834,1077 904,1033 974,988 1018,924 1035,839 L 873,819 C 866,867 842,903 802,928 762,953 702,965 623,965 460,965 378,915 378,814 378,774 392,742 420,718 447,694 492,675 553,660 L 672,629 C 781,602 859,576 907,550 954,524 992,492 1019,453 1046,414 1060,366 1060,309 Z"/>
<glyph unicode="r" horiz-adv-x="821" d="M 1045,918 C 970,931 900,937 833,937 726,937 639,897 573,816 507,735 474,633 474,508 L 474,0 294,0 294,701 C 294,752 290,811 281,880 272,949 259,1016 242,1082 L 413,1082 C 440,990 456,907 461,832 L 466,832 C 499,907 532,962 564,997 596,1032 634,1058 678,1076 722,1093 776,1102 839,1102 908,1102 977,1096 1045,1085 L 1045,918 Z"/>
<glyph unicode="p" horiz-adv-x="927" d="M 1090,546 C 1090,169 959,-20 698,-20 534,-20 424,41 367,164 L 362,164 C 365,159 366,103 366,-2 L 366,-425 185,-425 185,858 C 185,971 183,1046 179,1082 L 354,1082 C 355,1079 356,1070 357,1053 358,1036 360,1011 362,978 363,945 364,920 364,904 L 368,904 C 401,974 444,1025 496,1057 547,1088 615,1104 698,1104 830,1104 928,1059 993,968 1058,877 1090,736 1090,546 Z M 904,546 C 904,697 884,804 843,869 802,933 738,965 651,965 550,965 478,929 433,856 388,783 366,672 366,524 366,382 388,278 433,212 478,146 550,113 649,113 738,113 802,147 843,214 884,281 904,392 904,546 Z"/>
<glyph unicode="o" horiz-adv-x="1006" d="M 1097,542 C 1097,360 1055,221 972,125 888,28 767,-20 609,-20 454,-20 336,29 254,126 171,223 130,362 130,542 130,728 172,868 257,962 341,1055 460,1102 615,1102 778,1102 899,1056 978,963 1057,870 1097,730 1097,542 Z M 908,542 C 908,685 885,792 840,863 794,934 720,969 618,969 515,969 439,933 391,861 343,789 319,683 319,542 319,402 343,296 391,223 439,150 511,113 607,113 713,113 790,149 837,220 884,291 908,399 908,542 Z"/>
<glyph unicode="n" horiz-adv-x="900" d="M 868,0 L 868,695 C 868,786 851,853 816,897 781,941 725,963 648,963 565,963 498,933 445,873 392,812 365,730 365,627 L 365,0 185,0 185,851 C 185,977 183,1054 179,1082 L 349,1082 C 350,1079 350,1070 351,1055 352,1040 353,1024 354,1005 355,986 356,950 357,897 L 360,897 C 430,1034 545,1102 706,1102 821,1102 907,1071 964,1009 1021,946 1049,850 1049,721 L 1049,0 868,0 Z"/>
<glyph unicode="m" horiz-adv-x="1060" d="M 531,0 L 531,686 C 531,789 523,861 507,902 490,943 460,963 417,963 374,963 340,931 314,867 287,803 274,716 274,607 L 274,0 105,0 105,851 C 105,977 103,1054 99,1082 L 248,1082 254,955 254,907 256,907 C 279,975 307,1025 342,1056 377,1087 420,1102 472,1102 531,1102 575,1086 604,1054 633,1022 653,973 666,906 L 668,906 C 695,977 727,1027 764,1057 801,1087 847,1102 904,1102 983,1102 1039,1073 1073,1016 1107,959 1124,860 1124,721 L 1124,0 956,0 956,686 C 956,789 948,861 932,902 915,943 885,963 842,963 798,963 763,935 738,879 712,823 699,739 699,627 L 699,0 531,0 Z"/>
<glyph unicode="l" horiz-adv-x="980" d="M 736,142 L 1116,142 1116,0 134,0 134,142 556,142 556,1342 267,1342 267,1484 736,1484 736,142 Z"/>
<glyph unicode="k" horiz-adv-x="927" d="M 914,0 L 548,499 416,401 416,0 236,0 236,1484 416,1484 416,557 891,1082 1102,1082 663,617 1125,0 914,0 Z"/>
<glyph unicode="j" horiz-adv-x="742" d="M 836,-28 C 836,-153 799,-250 724,-320 649,-390 543,-425 405,-425 352,-425 299,-421 244,-412 189,-403 147,-393 117,-382 L 117,-242 C 217,-265 308,-276 390,-276 475,-276 541,-254 587,-210 633,-166 656,-104 656,-25 L 656,940 249,940 249,1082 836,1082 836,-28 Z M 636,1292 L 636,1484 836,1484 836,1292 636,1292 Z"/>
<glyph unicode="i" horiz-adv-x="1007" d="M 745,142 L 1125,142 1125,0 143,0 143,142 565,142 565,940 246,940 246,1082 745,1082 745,142 Z M 545,1292 L 545,1484 745,1484 745,1292 545,1292 Z"/>
<glyph unicode="h" horiz-adv-x="900" d="M 185,1484 L 366,1484 366,1094 C 366,1055 363,989 357,897 L 360,897 C 430,1034 543,1102 699,1102 932,1102 1049,975 1049,721 L 1049,0 868,0 868,695 C 868,786 851,853 816,897 781,941 725,963 648,963 565,963 498,933 445,873 392,812 365,730 365,627 L 365,0 185,0 185,1484 Z"/>
<glyph unicode="f" horiz-adv-x="980" d="M 580,940 L 580,0 400,0 400,940 138,940 138,1082 400,1082 400,1107 C 400,1244 432,1341 497,1398 561,1455 668,1484 818,1484 866,1484 918,1482 974,1478 1029,1473 1071,1468 1099,1463 L 1099,1318 C 1079,1325 1039,1329 978,1329 917,1329 870,1329 839,1329 770,1329 717,1322 682,1307 647,1292 621,1267 605,1233 588,1199 580,1152 580,1092 L 580,1082 1071,1082 1071,940 580,940 Z"/>
<glyph unicode="e" horiz-adv-x="980" d="M 322,503 C 322,382 349,287 403,218 456,149 530,115 623,115 692,115 752,130 804,160 855,189 890,230 907,281 L 1065,236 C 1036,153 982,90 904,46 825,2 732,-20 623,-20 466,-20 345,29 260,127 175,225 133,365 133,548 133,726 175,863 258,959 341,1054 460,1102 617,1102 774,1102 892,1054 973,959 1054,864 1094,720 1094,527 L 1094,503 322,503 Z M 619,969 C 530,969 459,940 407,882 355,823 327,743 324,641 L 908,641 C 889,860 793,969 619,969 Z"/>
<glyph unicode="d" horiz-adv-x="927" d="M 862,174 C 829,104 786,53 732,22 678,-10 611,-26 530,-26 395,-26 296,20 233,113 170,206 138,345 138,532 138,909 269,1098 530,1098 611,1098 678,1084 733,1055 787,1026 830,979 863,914 L 865,914 863,1065 863,1484 1043,1484 1043,223 C 1043,110 1045,36 1049,0 L 877,0 C 874,10 872,34 870,73 868,112 867,145 867,174 L 862,174 Z M 324,538 C 324,390 344,282 384,215 423,147 488,113 577,113 674,113 746,148 793,219 840,289 863,401 863,554 863,697 841,802 796,867 751,932 678,965 579,965 489,965 424,931 384,862 344,793 324,685 324,538 Z"/>
<glyph unicode="c" horiz-adv-x="980" d="M 130,542 C 130,722 173,860 259,957 345,1054 469,1102 632,1102 753,1102 853,1073 932,1015 1011,956 1059,878 1078,779 L 886,765 C 875,826 849,874 806,909 763,944 703,961 624,961 519,961 442,928 393,863 344,798 319,692 319,546 319,398 344,290 393,222 442,153 518,119 623,119 695,119 755,136 802,171 849,205 879,257 890,328 L 1080,328 C 1071,263 1047,204 1008,150 968,97 915,55 850,25 785,-5 712,-20 631,-20 468,-20 343,28 258,124 173,220 130,359 130,542 Z"/>
<glyph unicode="b" horiz-adv-x="927" d="M 1090,546 C 1090,357 1056,215 989,121 921,27 824,-20 698,-20 535,-20 424,41 364,164 L 362,164 C 362,132 361,99 359,64 356,29 354,8 353,0 L 179,0 C 183,36 185,110 185,223 L 185,1484 365,1484 365,1061 C 365,1018 364,965 361,904 L 365,904 C 426,1037 537,1104 699,1104 960,1104 1090,918 1090,546 Z M 904,540 C 904,689 884,798 843,865 802,932 737,965 650,965 551,965 478,929 433,856 388,783 365,672 365,524 365,385 387,281 431,214 475,147 547,113 648,113 738,113 803,148 844,218 884,287 904,395 904,540 Z"/>
<glyph unicode="a" horiz-adv-x="1059" d="M 1101,111 C 1118,111 1138,113 1160,118 L 1160,6 C 1115,-5 1068,-10 1021,-10 954,-10 906,8 876,43 845,78 828,132 824,207 L 818,207 C 775,126 724,68 665,33 606,-2 533,-20 446,-20 341,-20 261,9 208,67 155,124 128,203 128,304 128,538 279,655 582,655 L 818,655 818,715 C 818,804 800,868 765,907 730,946 673,965 596,965 517,965 461,951 426,923 391,895 371,852 364,793 L 176,810 C 207,1005 348,1102 599,1102 732,1102 833,1071 900,1009 967,946 1000,856 1000,738 L 1000,272 C 1000,219 1007,179 1021,152 1035,125 1062,111 1101,111 Z M 492,117 C 556,117 613,132 662,163 711,193 750,234 777,285 804,336 818,388 818,443 L 818,531 628,531 C 549,531 489,523 448,507 407,491 375,466 352,433 329,400 317,355 317,300 317,245 332,201 362,167 391,134 435,117 492,117 Z"/>
<glyph unicode="_" horiz-adv-x="1271" d="M -5,-220 L -5,-124 1233,-124 1233,-220 -5,-220 Z"/>
<glyph unicode="T" horiz-adv-x="1112" d="M 709,1193 L 709,0 519,0 519,1193 76,1193 76,1349 1152,1349 1152,1193 709,1193 Z"/>
<glyph unicode="M" horiz-adv-x="1006" d="M 937,0 L 937,868 C 937,958 938,1025 940,1069 L 943,1169 C 900,1032 869,935 848,878 L 684,440 547,440 381,878 C 369,909 337,1006 285,1169 L 289,868 289,0 129,0 129,1349 366,1349 551,860 C 565,825 588,748 619,629 L 645,719 689,859 874,1349 1099,1349 1099,0 937,0 Z"/>
<glyph unicode="D" horiz-adv-x="980" d="M 1125,688 C 1125,467 1074,298 972,179 869,60 723,0 532,0 L 162,0 162,1349 473,1349 C 692,1349 856,1294 964,1185 1071,1075 1125,909 1125,688 Z M 933,688 C 933,864 896,992 823,1073 750,1153 633,1193 474,1193 L 353,1193 353,156 515,156 C 656,156 761,200 830,289 899,378 933,511 933,688 Z"/>
<glyph unicode="2" horiz-adv-x="954" d="M 144,0 L 144,117 C 177,190 228,263 297,337 366,410 459,494 578,589 684,674 760,747 807,810 854,873 877,933 877,991 877,1065 854,1122 808,1162 762,1202 696,1222 611,1222 535,1222 474,1201 427,1160 380,1118 352,1059 343,984 L 159,1001 C 172,1114 219,1204 298,1271 377,1337 482,1370 611,1370 753,1370 864,1338 943,1274 1022,1210 1062,1119 1062,1002 1062,925 1037,849 986,773 935,696 860,618 759,538 622,429 527,348 474,297 421,245 383,195 361,146 L 1084,146 1084,0 144,0 Z"/>
<glyph unicode="1" horiz-adv-x="1007" d="M 157,0 L 157,145 596,145 596,1166 C 571,1114 513,1069 421,1030 328,991 237,972 148,972 L 148,1120 C 247,1120 340,1142 428,1185 515,1228 576,1283 611,1349 L 777,1349 777,145 1130,145 1130,0 157,0 Z"/>
<glyph unicode="." horiz-adv-x="266" d="M 496,0 L 496,299 731,299 731,0 496,0 Z"/>
<glyph unicode="-" horiz-adv-x="583" d="M 334,464 L 334,624 894,624 894,464 334,464 Z"/>
<glyph unicode=" " horiz-adv-x="1217"/>
</font>
</defs>
<defs>
<font id="EmbeddedFont_2" horiz-adv-x="2048">
<font-face font-family="Cousine embedded" units-per-em="2048" font-weight="normal" font-style="italic" ascent="1720" descent="635"/>
<missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
<glyph unicode="”" horiz-adv-x="1007" d="M 680,862 L 969,1484 1234,1484 803,862 680,862 Z M 241,862 L 530,1484 795,1484 364,862 241,862 Z"/>
<glyph unicode="“" horiz-adv-x="1007" d="M 794,1484 L 505,862 240,862 671,1484 794,1484 Z M 1233,1484 L 944,862 679,862 1110,1484 1233,1484 Z"/>
<glyph unicode="w" horiz-adv-x="1245" d="M 913,0 L 709,0 658,471 640,673 574,534 302,0 99,0 126,1082 304,1082 279,475 C 278,437 274,379 267,301 260,222 254,172 249,149 L 288,235 349,363 566,787 759,787 806,362 820,149 C 823,166 829,188 836,213 843,238 871,326 918,475 L 1137,1082 1313,1082 913,0 Z"/>
<glyph unicode="u" horiz-adv-x="1033" d="M 470,1082 L 337,396 C 328,348 323,307 323,273 323,217 337,177 366,154 394,131 441,119 507,119 594,119 669,149 730,209 791,269 832,351 851,455 L 973,1082 1154,1082 989,231 C 984,208 980,185 976,160 971,135 967,111 964,89 960,66 957,47 954,31 951,15 950,5 950,0 L 780,0 C 780,7 784,33 791,78 798,122 803,158 808,185 L 805,185 C 750,110 691,58 630,27 568,-4 498,-20 419,-20 322,-20 250,-1 204,38 158,77 135,138 135,223 135,263 140,309 150,361 L 290,1082 470,1082 Z"/>
<glyph unicode="t" horiz-adv-x="821" d="M 268,940 L 295,1082 465,1082 578,1364 698,1364 643,1082 1075,1082 1048,940 616,940 489,288 484,244 C 484,206 497,178 522,160 547,142 587,133 641,133 730,133 831,144 944,167 L 918,30 C 801,-1 686,-16 574,-16 481,-16 412,1 366,34 320,67 297,118 297,189 297,219 300,246 305,269 L 436,940 268,940 Z"/>
<glyph unicode="s" horiz-adv-x="1006" d="M 512,-20 C 375,-20 275,1 212,44 149,86 115,154 110,248 L 275,279 C 277,220 297,178 334,153 371,127 439,114 538,114 639,114 716,132 767,169 818,206 844,254 844,315 844,348 830,375 803,397 775,419 729,439 666,456 L 550,487 C 462,511 400,533 365,553 329,572 301,596 282,625 262,653 252,687 252,728 252,776 263,824 285,872 307,920 339,961 381,995 422,1029 473,1055 533,1073 593,1090 659,1099 732,1099 849,1099 939,1077 1001,1032 1062,987 1093,923 1093,839 L 927,819 927,824 C 927,871 910,906 875,930 840,953 784,965 706,965 614,965 545,949 498,917 451,885 428,841 428,784 428,753 440,728 464,709 487,689 528,672 585,657 732,618 825,590 864,573 903,556 934,536 957,514 980,491 997,468 1007,445 1016,422 1021,395 1021,366 1021,297 1000,232 958,171 916,109 856,62 779,29 702,-4 613,-20 512,-20 Z"/>
<glyph unicode="r" horiz-adv-x="980" d="M 1118,918 C 1047,931 977,937 910,937 803,937 709,897 627,816 545,735 492,633 468,508 L 369,0 189,0 325,701 C 342,792 350,888 350,990 L 347,1082 518,1082 C 522,1049 524,1006 524,954 524,910 522,869 518,832 L 523,832 C 572,907 615,962 654,997 692,1032 735,1058 782,1076 829,1093 885,1102 948,1102 1019,1102 1086,1096 1151,1085 L 1118,918 Z"/>
<glyph unicode="p" horiz-adv-x="1138" d="M 589,-20 C 424,-20 326,41 294,164 L 289,164 C 289,157 286,139 281,108 276,77 241,-100 178,-425 L -3,-425 247,858 C 265,949 277,1023 284,1082 L 459,1082 C 459,1069 456,1041 450,999 444,956 439,925 435,904 L 439,904 C 486,974 538,1025 597,1057 655,1088 725,1104 808,1104 1013,1104 1116,992 1116,768 1116,705 1108,631 1091,546 1018,169 850,-20 589,-20 Z M 928,743 C 928,815 913,870 884,908 854,946 804,965 734,965 669,965 615,951 570,923 525,894 486,851 453,792 420,733 393,659 373,572 353,484 343,410 343,350 343,269 361,210 397,171 433,132 489,113 566,113 644,113 709,139 760,191 811,243 851,327 882,444 913,561 928,660 928,743 Z"/>
<glyph unicode="o" horiz-adv-x="1006" d="M 500,-20 C 375,-20 279,13 212,79 145,144 112,240 112,367 112,420 118,478 130,542 167,728 236,868 339,962 441,1055 569,1102 724,1102 857,1102 955,1071 1020,1010 1085,949 1117,856 1117,732 1117,642 1103,547 1075,448 1047,348 1006,263 952,192 898,121 833,68 756,33 679,-2 594,-20 500,-20 Z M 928,720 C 928,803 910,866 874,907 837,948 780,969 701,969 613,969 540,943 483,892 425,841 380,764 349,662 317,560 301,464 301,373 301,200 375,113 524,113 591,113 649,127 696,155 743,182 784,225 819,283 853,341 880,413 899,499 918,584 928,658 928,720 Z"/>
<glyph unicode="n" horiz-adv-x="1033" d="M 763,0 L 898,695 C 905,734 909,766 909,793 909,852 895,895 866,922 837,949 791,963 730,963 647,963 574,933 510,873 445,812 403,730 382,627 L 260,0 80,0 245,851 C 250,874 254,898 259,923 263,948 267,971 271,994 274,1016 277,1035 280,1051 283,1067 284,1077 284,1082 L 454,1082 C 454,1078 451,1056 446,1015 440,974 433,934 426,897 L 429,897 C 474,960 528,1010 590,1047 652,1084 727,1102 815,1102 1004,1102 1098,1017 1098,848 1098,810 1093,768 1084,721 L 944,0 763,0 Z"/>
<glyph unicode="m" horiz-adv-x="1192" d="M 426,0 L 559,686 C 574,759 581,816 581,857 581,896 574,924 561,940 548,955 527,963 499,963 457,963 417,932 378,869 339,806 309,719 287,607 L 169,0 0,0 165,851 C 170,874 174,898 179,923 183,948 187,971 191,994 194,1016 197,1035 200,1051 203,1067 204,1077 204,1082 L 353,1082 334,955 325,907 327,907 C 365,978 404,1029 445,1058 486,1087 531,1102 581,1102 640,1102 680,1086 703,1055 726,1023 737,975 737,912 L 737,906 739,906 C 780,977 822,1027 865,1057 908,1087 957,1102 1013,1102 1072,1102 1114,1087 1141,1056 1168,1025 1181,977 1181,910 1181,860 1174,797 1159,721 L 1019,0 851,0 984,686 C 999,759 1006,816 1006,857 1006,896 999,924 986,940 973,955 952,963 924,963 881,963 841,935 804,879 767,822 737,738 716,627 L 594,0 426,0 Z"/>
<glyph unicode="l" horiz-adv-x="1033" d="M 659,142 L 1039,142 1011,0 29,0 57,142 479,142 712,1342 423,1342 450,1484 919,1484 659,142 Z"/>
<glyph unicode="k" horiz-adv-x="1112" d="M 809,0 L 540,499 389,401 311,0 131,0 419,1484 599,1484 419,557 996,1082 1207,1082 678,617 1020,0 809,0 Z"/>
<glyph unicode="j" horiz-adv-x="1112" d="M 217,-425 C 164,-425 112,-421 60,-412 7,-403 -33,-393 -62,-382 L -35,-242 C 60,-265 149,-276 231,-276 316,-276 385,-254 440,-211 495,-167 530,-105 546,-25 L 734,940 327,940 354,1082 941,1082 726,-28 C 702,-152 646,-249 557,-320 468,-390 355,-425 217,-425 Z M 782,1292 L 819,1484 1019,1484 982,1292 782,1292 Z"/>
<glyph unicode="i" horiz-adv-x="1033" d="M 668,142 L 1048,142 1020,0 38,0 66,142 488,142 643,940 324,940 351,1082 850,1082 668,142 Z M 691,1292 L 728,1484 928,1484 891,1292 691,1292 Z"/>
<glyph unicode="h" horiz-adv-x="1033" d="M 368,1484 L 549,1484 474,1094 C 467,1057 451,991 426,897 L 429,897 C 474,960 527,1010 588,1047 649,1084 722,1102 808,1102 1001,1102 1097,1016 1097,843 1097,805 1093,764 1084,721 L 944,0 763,0 898,695 C 905,734 909,766 909,793 909,852 895,895 866,922 837,949 791,963 730,963 647,963 574,933 510,873 445,812 403,730 382,627 L 260,0 80,0 368,1484 Z"/>
<glyph unicode="g" horiz-adv-x="1112" d="M 428,-424 C 315,-424 230,-401 171,-355 112,-309 82,-243 79,-157 L 268,-132 C 269,-182 286,-220 319,-248 352,-274 399,-288 460,-288 627,-288 730,-183 769,27 L 807,221 805,221 C 711,82 583,12 421,12 317,12 241,38 193,91 144,143 120,222 120,328 120,411 133,508 160,620 187,731 222,822 266,891 310,960 364,1012 428,1047 491,1082 566,1099 652,1099 727,1099 789,1082 838,1047 887,1012 920,962 937,897 L 940,897 C 945,922 953,957 965,1004 977,1050 985,1076 988,1082 L 1159,1082 1140,1000 1110,858 949,32 C 920,-119 862,-233 777,-310 692,-386 575,-424 428,-424 Z M 887,697 C 887,781 868,847 831,894 793,941 740,965 671,965 611,965 560,952 518,926 476,900 440,859 411,804 382,749 357,675 338,584 318,492 308,416 308,355 308,282 324,228 355,195 386,162 437,145 508,145 561,145 612,159 659,188 706,217 746,258 781,312 816,365 842,428 860,501 878,573 887,638 887,697 Z"/>
<glyph unicode="f" horiz-adv-x="1085" d="M 658,940 L 475,0 295,0 478,940 216,940 243,1082 505,1082 510,1107 C 537,1243 588,1340 663,1398 738,1455 850,1484 1001,1484 1048,1484 1098,1482 1153,1478 1208,1473 1249,1468 1278,1463 L 1250,1324 C 1231,1327 1190,1329 1129,1329 1068,1329 1022,1329 993,1329 923,1329 869,1322 831,1307 793,1292 763,1267 740,1233 717,1199 698,1148 685,1082 L 1176,1082 1149,940 658,940 Z"/>
<glyph unicode="e" horiz-adv-x="1006" d="M 315,503 C 306,457 302,417 302,382 302,296 323,230 365,184 406,138 465,115 540,115 608,115 671,130 729,159 786,188 829,229 857,281 L 1006,236 C 960,153 894,90 808,46 721,2 623,-20 514,-20 385,-20 286,14 218,81 150,148 116,244 116,370 116,453 129,542 156,639 183,735 223,818 276,889 329,959 394,1012 469,1048 544,1084 630,1102 726,1102 983,1102 1112,976 1112,723 1112,662 1105,597 1091,527 L 1087,503 315,503 Z M 702,969 C 613,969 538,940 475,882 412,824 368,744 344,641 L 928,641 932,713 C 932,884 855,969 702,969 Z"/>
<glyph unicode="d" horiz-adv-x="1139" d="M 791,174 C 745,104 692,53 632,22 571,-10 501,-26 420,-26 315,-26 237,2 187,58 137,113 112,198 112,311 112,376 120,449 136,532 210,909 377,1098 638,1098 719,1098 784,1084 833,1055 882,1026 916,979 936,914 L 938,914 959,1034 1046,1484 1226,1484 981,223 C 960,104 947,29 944,0 L 772,0 772,4 C 772,33 780,89 796,174 L 791,174 Z M 301,337 C 301,259 317,202 348,167 379,131 427,113 494,113 579,113 649,139 705,192 760,245 804,326 837,437 870,547 886,644 886,728 886,809 868,868 832,907 796,946 739,965 662,965 604,965 554,952 513,925 472,898 436,855 407,798 377,741 352,666 332,573 311,480 301,402 301,337 Z"/>
<glyph unicode="c" horiz-adv-x="1033" d="M 741,1102 C 862,1102 956,1073 1023,1016 1090,958 1124,879 1124,779 L 930,765 930,771 C 930,828 912,874 877,909 842,944 785,961 706,961 617,961 543,938 485,891 427,844 382,768 350,665 317,562 301,464 301,372 301,285 321,221 361,180 401,139 461,119 541,119 613,119 676,136 731,171 785,205 825,257 850,328 L 1038,328 C 1017,263 981,204 932,150 882,97 822,55 751,25 680,-5 603,-20 522,-20 387,-20 285,13 216,79 147,145 112,242 112,369 112,454 126,544 154,640 181,735 223,818 278,889 333,960 399,1013 477,1049 554,1084 642,1102 741,1102 Z"/>
<glyph unicode="b" horiz-adv-x="1059" d="M 589,-20 C 426,-20 327,41 291,164 L 289,164 C 284,135 276,101 266,64 256,26 250,5 248,0 L 74,0 C 77,10 84,37 94,82 103,127 113,174 123,223 L 368,1484 548,1484 466,1061 432,904 436,904 C 523,1037 647,1104 809,1104 1013,1104 1115,990 1115,761 1115,699 1107,627 1091,546 1054,357 993,215 907,121 821,27 715,-20 589,-20 Z M 926,736 C 926,816 910,874 879,911 847,947 798,965 733,965 649,965 579,939 523,886 467,833 423,753 391,645 359,536 343,438 343,351 343,269 361,209 397,171 433,132 489,113 565,113 645,113 711,140 762,195 813,249 853,332 882,443 911,554 926,651 926,736 Z"/>
<glyph unicode="a" horiz-adv-x="1033" d="M 1018,111 C 1036,111 1056,113 1078,118 L 1056,6 C 1009,-5 962,-10 914,-10 856,-10 815,3 791,28 766,53 754,91 754,142 L 759,207 753,207 C 694,126 631,68 565,33 498,-2 422,-20 337,-20 248,-20 182,1 139,42 95,84 73,141 73,214 73,242 76,272 82,304 127,538 302,655 605,655 L 841,655 C 852,710 859,745 861,759 862,774 863,789 863,805 863,863 848,904 817,928 786,953 740,965 679,965 602,965 543,952 504,926 464,899 434,855 413,793 L 228,810 C 264,909 322,983 401,1031 480,1078 582,1102 708,1102 935,1102 1048,1013 1048,835 1048,805 1045,773 1038,738 L 948,272 C 942,243 939,218 939,196 939,168 945,147 957,133 969,118 989,111 1018,111 Z M 410,117 C 473,117 533,132 588,162 643,192 690,233 727,284 764,335 788,388 799,443 L 817,531 626,531 C 536,531 466,520 417,497 367,475 329,441 304,397 278,352 265,304 265,252 265,210 277,177 302,153 326,129 362,117 410,117 Z"/>
<glyph unicode="W" horiz-adv-x="1324" d="M 913,0 L 705,0 673,432 C 670,471 665,579 658,756 636,703 609,639 576,565 543,490 455,302 314,0 L 106,0 157,1349 346,1349 293,514 C 284,404 273,289 259,168 314,298 358,400 392,475 425,550 496,702 604,931 L 779,931 C 794,746 805,605 813,506 820,407 825,294 828,168 L 930,514 1196,1349 1385,1349 913,0 Z"/>
<glyph unicode="T" horiz-adv-x="1139" d="M 836,1193 L 604,0 414,0 646,1193 203,1193 233,1349 1309,1349 1279,1193 836,1193 Z"/>
<glyph unicode="P" horiz-adv-x="1165" d="M 629,514 L 348,514 248,0 57,0 319,1349 779,1349 C 918,1349 1024,1322 1097,1268 1170,1213 1207,1136 1207,1035 1207,944 1182,858 1133,776 1083,694 1014,630 926,584 837,537 738,514 629,514 Z M 1011,1002 C 1011,1131 916,1196 726,1196 L 480,1196 377,665 631,665 C 707,665 774,680 833,709 891,738 935,780 966,833 996,886 1011,943 1011,1002 Z"/>
<glyph unicode="O" horiz-adv-x="1113" d="M 504,-20 C 369,-20 269,19 202,97 135,174 102,285 102,430 102,537 119,654 152,781 185,908 230,1016 289,1105 347,1193 417,1259 498,1304 579,1348 672,1370 776,1370 908,1370 1008,1333 1077,1260 1146,1186 1180,1075 1180,928 1180,825 1164,709 1131,582 1098,455 1052,346 992,255 932,164 861,95 778,49 695,3 604,-20 504,-20 Z M 978,913 C 978,1114 901,1214 746,1214 655,1214 578,1181 515,1115 451,1048 400,948 362,813 323,678 304,556 304,446 304,239 381,135 535,135 602,135 660,152 711,187 762,222 807,276 846,351 885,426 916,518 941,629 966,739 978,834 978,913 Z"/>
<glyph unicode="M" horiz-adv-x="1271" d="M 832,0 L 1001,868 C 1018,952 1039,1052 1065,1169 L 1010,1061 914,878 665,440 528,440 447,878 C 437,927 424,1024 407,1169 L 353,868 184,0 24,0 286,1349 523,1349 613,860 C 621,822 629,745 636,629 L 679,719 751,859 1031,1349 1256,1349 994,0 832,0 Z"/>
<glyph unicode="G" horiz-adv-x="1112" d="M 530,-20 C 397,-20 295,20 224,101 152,181 116,298 116,451 116,558 134,676 169,805 204,933 251,1038 309,1121 367,1204 437,1266 519,1308 601,1349 696,1370 803,1370 1032,1370 1165,1260 1200,1039 L 1018,983 C 994,1137 913,1214 775,1214 704,1214 642,1198 589,1165 536,1132 490,1082 452,1015 414,948 382,860 356,749 329,638 316,540 316,455 316,242 403,135 576,135 621,135 670,142 721,156 772,170 815,188 851,209 L 916,545 623,545 654,705 1133,705 1022,133 C 852,31 688,-20 530,-20 Z"/>
<glyph unicode="D" horiz-adv-x="1139" d="M 427,0 L 57,0 319,1349 630,1349 C 993,1349 1175,1196 1175,890 1175,785 1157,673 1121,555 1085,437 1034,337 969,254 904,171 825,108 734,65 643,22 540,0 427,0 Z M 981,865 C 981,980 950,1064 887,1116 824,1167 728,1193 601,1193 L 480,1193 278,156 440,156 C 525,156 601,172 666,205 731,237 786,286 832,351 878,416 914,498 941,597 968,696 981,785 981,865 Z"/>
<glyph unicode="C" horiz-adv-x="1112" d="M 316,452 C 316,241 405,135 582,135 651,135 717,159 782,207 847,254 906,324 959,417 L 1105,352 C 956,104 771,-20 550,-20 409,-20 301,20 227,99 153,178 116,294 116,447 116,557 133,675 168,802 203,929 250,1034 309,1117 368,1200 439,1263 523,1306 607,1349 703,1370 810,1370 1033,1370 1167,1258 1211,1035 L 1031,970 C 1019,1049 991,1110 947,1152 903,1193 848,1214 781,1214 709,1214 646,1197 592,1163 537,1129 491,1078 452,1009 413,940 380,852 355,743 329,634 316,537 316,452 Z"/>
<glyph unicode="A" horiz-adv-x="1245" d="M 929,0 L 865,382 302,382 91,0 -105,0 667,1349 884,1349 1123,0 929,0 Z M 745,1205 C 714,1144 687,1091 663,1044 638,997 545,826 382,531 L 845,531 769,1031 745,1205 Z"/>
<glyph unicode=" " horiz-adv-x="1217"/>
</font>
</defs>
<defs class="TextShapeIndex">
<g ooo:slide="id1" ooo:id-list="id3 id4 id5 id6 id7 id8 id9 id10 id11 id12 id13 id14 id15 id16 id17 id18 id19 id20 id21 id22 id23 id24 id25 id26 id27 id28 id29 id30 id31 id32 id33 id34 id35 id36 id37 id38 id39 id40 id41 id42 id43 id44 id45 id46 id47 id48 id49 id50 id51 id52 id53 id54 id55 id56 id57 id58 id59 id60 id61 id62 id63 id64 id65 id66"/>
</defs>
<defs class="EmbeddedBulletChars">
<g id="bullet-char-template(57356)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 580,1141 L 1163,571 580,0 -4,571 580,1141 Z"/>
</g>
<g id="bullet-char-template(57354)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 8,1128 L 1137,1128 1137,0 8,0 8,1128 Z"/>
</g>
<g id="bullet-char-template(10146)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 174,0 L 602,739 174,1481 1456,739 174,0 Z M 1358,739 L 309,1346 659,739 1358,739 Z"/>
</g>
<g id="bullet-char-template(10132)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 2015,739 L 1276,0 717,0 1260,543 174,543 174,936 1260,936 717,1481 1274,1481 2015,739 Z"/>
</g>
<g id="bullet-char-template(10007)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 0,-2 C -7,14 -16,27 -25,37 L 356,567 C 262,823 215,952 215,954 215,979 228,992 255,992 264,992 276,990 289,987 310,991 331,999 354,1012 L 381,999 492,748 772,1049 836,1024 860,1049 C 881,1039 901,1025 922,1006 886,937 835,863 770,784 769,783 710,716 594,584 L 774,223 C 774,196 753,168 711,139 L 727,119 C 717,90 699,76 672,76 641,76 570,178 457,381 L 164,-76 C 142,-110 111,-127 72,-127 30,-127 9,-110 8,-76 1,-67 -2,-52 -2,-32 -2,-23 -1,-13 0,-2 Z"/>
</g>
<g id="bullet-char-template(10004)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 285,-33 C 182,-33 111,30 74,156 52,228 41,333 41,471 41,549 55,616 82,672 116,743 169,778 240,778 293,778 328,747 346,684 L 369,508 C 377,444 397,411 428,410 L 1163,1116 C 1174,1127 1196,1133 1229,1133 1271,1133 1292,1118 1292,1087 L 1292,965 C 1292,929 1282,901 1262,881 L 442,47 C 390,-6 338,-33 285,-33 Z"/>
</g>
<g id="bullet-char-template(9679)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 813,0 C 632,0 489,54 383,161 276,268 223,411 223,592 223,773 276,916 383,1023 489,1130 632,1184 813,1184 992,1184 1136,1130 1245,1023 1353,916 1407,772 1407,592 1407,412 1353,268 1245,161 1136,54 992,0 813,0 Z"/>
</g>
<g id="bullet-char-template(8226)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M 346,457 C 273,457 209,483 155,535 101,586 74,649 74,723 74,796 101,859 155,911 209,963 273,989 346,989 419,989 480,963 531,910 582,859 608,796 608,723 608,648 583,586 532,535 482,483 420,457 346,457 Z"/>
</g>
<g id="bullet-char-template(8211)" transform="scale(0.00048828125,-0.00048828125)">
<path d="M -4,459 L 1135,459 1135,606 -4,606 -4,459 Z"/>
</g>
</defs>
<defs class="TextEmbeddedBitmaps"/>
<g>
<g id="id2" class="Master_Slide">
<g id="bg-id2" class="Background"/>
<g id="bo-id2" class="BackgroundObjects"/>
</g>
</g>
<g class="SlideGroup">
<g>
<g id="id1" class="Slide" clip-path="url(#presentation_clip_path)">
<g class="Page">
<g class="com.sun.star.drawing.TextShape">
<g id="id3">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="1223" y="1129"><tspan fill="rgb(0,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id4">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2524" y="1630"><tspan fill="rgb(0,128,0)" stroke="none">Docs-Master</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id5">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2524" y="5131"><tspan fill="rgb(0,0,255)" stroke="none">Docs-Template</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id6">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3624" y="2131"><tspan fill="rgb(0,128,0)" stroke="none">common</tspan><tspan fill="rgb(0,0,0)" stroke="none"> </tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id7">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3624" y="4132"><tspan fill="rgb(0,128,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id8">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4724" y="2632"><tspan fill="rgb(0,128,0)" stroke="none">ch_preface.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id9">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3569" y="4630"><tspan fill="rgb(0,128,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id10">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4725" y="3133"><tspan fill="rgb(0,128,0)" stroke="none">app_foundation.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id11">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4708" y="3631"><tspan fill="rgb(0,128,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id12">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3625" y="5631"><tspan fill="rgb(0,0,255)" stroke="none">template</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id13">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3625" y="7632"><tspan fill="rgb(0,0,255)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id14">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4625" y="6132"><tspan fill="rgb(0,0,255)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id15">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3589" y="8130"><tspan fill="rgb(0,0,255)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id16">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="6633"><tspan fill="rgb(0,0,255)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id17">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4590" y="7131"><tspan fill="rgb(0,0,255)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id18">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2525" y="8631"><tspan fill="rgb(255,0,0)" stroke="none">my_project</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id19">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3626" y="9131"><tspan fill="rgb(255,0,0)" stroke="none">my_doc_1</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id20">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3588" y="13132"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id21">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="9632"><tspan fill="rgb(255,0,0)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id22">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3571" y="13630"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id23">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4627" y="10133"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id24">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4591" y="10631"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id25">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3626" y="11132"><tspan fill="rgb(255,0,0)" stroke="none">my_doc_2</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id26">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="11633"><tspan fill="rgb(255,0,0)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id27">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4627" y="12134"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id28">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4591" y="12632"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id29">
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,1361 L 1541,1535 2274,1535"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id30">
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,1361 L 1541,5036 2274,5036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id31">
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,1361 L 1541,8536 2275,8536"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id32">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2490" y="14131"><tspan fill="rgb(0,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id33">
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,8536 L 1541,14036 2240,14036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id34">
<path fill="none" stroke="rgb(52,101,164)" d="M 2804,1861 L 2778,1861 2778,2036 3374,2036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id35">
<path fill="none" stroke="rgb(52,101,164)" d="M 2743,1861 L 2778,1861 2778,4037 3374,4037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id36">
<path fill="none" stroke="rgb(52,101,164)" d="M 2744,1861 L 2782,1861 2782,4535 3319,4535"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id37">
<path fill="none" stroke="rgb(52,101,164)" d="M 2805,5361 L 2779,5361 2779,5536 3375,5536"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id38">
<path fill="none" stroke="rgb(52,101,164)" d="M 2744,5361 L 2779,5361 2779,7537 3375,7537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id39">
<path fill="none" stroke="rgb(52,101,164)" d="M 2745,5361 L 2783,5361 2783,8035 3320,8035"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id40">
<path fill="none" stroke="rgb(52,101,164)" d="M 2806,8861 L 2780,8861 2780,9036 3376,9036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id41">
<path fill="none" stroke="rgb(52,101,164)" d="M 2745,8861 L 2780,8861 2780,11037 3376,11037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id42">
<path fill="none" stroke="rgb(52,101,164)" d="M 2746,8861 L 2784,8861 2784,13535 3321,13535"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id43">
<path fill="none" stroke="rgb(52,101,164)" d="M 2747,8861 L 2793,8861 2793,13037 3338,13037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id44">
<path fill="none" stroke="rgb(52,101,164)" d="M 3904,2362 L 3939,2362 3939,2537 4474,2537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id45">
<path fill="none" stroke="rgb(52,101,164)" d="M 3904,2363 L 3940,2363 3940,3038 4475,3038"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id46">
<path fill="none" stroke="rgb(52,101,164)" d="M 3905,2364 L 3932,2364 3932,3536 4458,3536"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id47">
<path fill="none" stroke="rgb(52,101,164)" d="M 3905,5862 L 3940,5862 3940,6037 4475,6037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id48">
<path fill="none" stroke="rgb(52,101,164)" d="M 3905,5863 L 3941,5863 3941,6538 4476,6538"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id49">
<path fill="none" stroke="rgb(52,101,164)" d="M 3906,5864 L 3933,5864 3933,7036 4459,7036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id50">
<path fill="none" stroke="rgb(52,101,164)" d="M 3906,9362 L 3941,9362 3941,9537 4476,9537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id51">
<path fill="none" stroke="rgb(52,101,164)" d="M 3906,9363 L 3942,9363 3942,10038 4477,10038"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id52">
<path fill="none" stroke="rgb(52,101,164)" d="M 3907,9364 L 3934,9364 3934,10536 4460,10536"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id53">
<path fill="none" stroke="rgb(52,101,164)" d="M 3907,11362 L 3942,11362 3942,11537 4477,11537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id54">
<path fill="none" stroke="rgb(52,101,164)" d="M 3907,11363 L 3943,11363 3943,12038 4478,12038"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id55">
<path fill="none" stroke="rgb(52,101,164)" d="M 3908,11364 L 3935,11364 3935,12536 4461,12536"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id56">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="8524" y="1631"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master document framework”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id57">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11276" y="2132"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Common files”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id58">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11692" y="4133"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master POM”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id59">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="9356" y="5634"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master Template Guide”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id60">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="10825" y="6135"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Main book file”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id61">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11267" y="6634"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Document POM”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id62">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11015" y="7635"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Workgroup POM”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id63">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11884" y="8636"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">A project”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id64">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11669" y="9137"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">A document”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id65">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="10385" y="11138"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Another document”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id66">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11017" y="13139"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Workgroup POM”</tspan></tspan></tspan></text>
</g>
</g>
</g>
</g>
</g>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 48 KiB

137
Intrinsics_Reference/pom.xml
Unescape Escape View File

@ -0,0 +1,137 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>
<groupId>org.openpowerfoundation.docs</groupId>
<artifactId>workgroup-pom</artifactId>
<version>1.0.0-SNAPSHOT</version>
<relativePath>../pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>

<artifactId>Intrinsics-Reference</artifactId>
<packaging>jar</packaging>
<name>Intrinsics-Reference</name>

<properties>
<!-- This is set by Jenkins according to the branch. -->
<release.path.name></release.path.name>
<comments.enabled>0</comments.enabled>
</properties>
<!-- ################################################ -->
<!-- USE "mvn clean generate-sources" to run this POM -->
<!-- ################################################ -->
<build>
<plugins>
<plugin>
<groupId>org.openpowerfoundation.docs</groupId>
<artifactId>openpowerdocs-maven-plugin</artifactId>
<!-- version set in ../pom.xml -->
<executions>
<execution>
<id>generate-webhelp</id>
<goals>
<goal>generate-webhelp</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<!-- These parameters only apply to webhelp -->
<enableDisqus>${comments.enabled}</enableDisqus>
<!-- TODO: Following 3 need attention -->
<disqusShortname>TBD</disqusShortname>
<enableGoogleAnalytics>0</enableGoogleAnalytics>
<googleAnalyticsId>TBD</googleAnalyticsId>
<generateToc>
appendix toc,title
article/appendix nop
article toc,title
book toc,title,figure,table,example,equation
book/appendix nop
book/chapter nop
chapter toc,title
chapter/section nop
section toc
part toc,title
qandadiv toc
qandaset toc
reference toc,title
set toc,title
</generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>1</sectionAutolabel>
<tocSectionDepth>3</tocSectionDepth>
<sectionLabelIncludesComponentLabel>1
</sectionLabelIncludesComponentLabel>
<webhelpDirname>Intrinsics-Reference</webhelpDirname>
<pdfFilenameBase>Intrinsics-Reference</pdfFilenameBase>

<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
Consult with the Work Group Chair or a Technical Steering Committee member if you have
questions about which value to select.
If no value is provided below, the document will default to "Work Group Notes".-->
<!-- workProduct>workgroupNotes</workProduct -->
<workProduct>workgroupSpecification</workProduct>
<!-- workProduct>candidateStandard</workProduct -->
<!-- workProduct>openpowerStandard</workProduct -->

<!-- TODO: Set the appropriate security policy for the document. For documents
which are not "public" this will affect the document title page and
create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:
public = this document may be shared outside the
foundation and thus this setting must be
used only when completely sure it allowed
foundationConfidential = this document may be shared freely with
OpenPOWER Foundation members but may not be
shared publicly
workgroupConfidential = this document may only be shared within the
work group and should not be shared with
other Foundation members or the public

The appropriate starting security for a new document is "workgroupConfidential". -->
<security>workgroupConfidential</security>
<!-- security>foundationConfidential</security -->
<!-- security>public</security -->

<!-- TODO: Set the appropriate work flow status for the document. For documents
which are not "published" this will affect the document title page
and create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

published = this document has completed all reviews and has
been published
draft = this document is actively being updated and has
not yet been reviewed
review = this document is presently being reviewed

The appropriate starting security for a new document is "draft". -->
<documentStatus>draft</documentStatus>
<!-- documentStatus>review</documentStatus -->
<!-- documentStatus>publish</documentStatus -->
</configuration>
</execution>
</executions>
<configuration>
<!-- These parameters apply to pdf and webhelp -->
<xincludeSupported>true</xincludeSupported>
<sourceDirectory>.</sourceDirectory>
<includes>
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
bk_main.xml
</includes>

<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
<includeCoverLogo>1</includeCoverLogo>
<coverUrl>www.openpowerfoundation.org</coverUrl>
</configuration>
</plugin>
</plugins>
</build>
</project>

228
Intrinsics_Reference/sec_template_debugging.xml
Unescape Escape View File

@ -0,0 +1,228 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_debug">

<title xml:id="section_template_debug_title">Debugging build failures</title>
<para>Maven/docbkx failures generally fall into these categories:</para>
<itemizedlist>
<listitem><para><xref linkend="section_template_debug_structure_error" endterm="section_template_debug_structure_error_title"/></para></listitem>
<listitem><para><xref linkend="section_template_debug_docbook_validation_error" endterm="section_template_debug_docbook_validation_error_title"/></para></listitem>
<listitem><para><xref linkend="section_template_debug_build_failure" endterm="section_template_debug_build_failure_title"/></para></listitem>
<listitem><para><xref linkend="section_template_debug_fo_validation_error" endterm="section_template_debug_fo_validation_error_title"/></para></listitem>
</itemizedlist>
<para>Correcting the document errors starts with understanding which type of failure has occurred and
understanding where to look in your document source.</para>
<section xml:id="section_template_debug_structure_error">
<title xml:id="section_template_debug_structure_error_title">Project structure errors</title>
<para>Because the OpenPOWER Foundation documentation projects are not self-contained in the
GitHub repositories, forgetting to clone the <literal>Docs-Master</literal> project in addition
to the document project or cloning it in the wrong location is a common problem. Failures of this kind
produce the following error:</para>
<screen>...
[INFO] Scanning for projects...
[ERROR] The build could not read 1 project -> [Help 1]
[ERROR]
[ERROR] The project org.openpowerfoundation.docs:workgroup-pom:1.0.0-SNAPSHOT (/home/scheel/Docs-Template/pom.xml) has 1 error
[ERROR] Non-resolvable parent POM: Could not find artifact org.openpowerfoundation.docs:master-pom:pom:1.0.0-SNAPSHOT and 'parent.relativePath' points at wrong local POM @ line 6, column 11 -> [Help 2]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/ProjectBuildingException
[ERROR] [Help 2] http://cwiki.apache.org/confluence/display/MAVEN/UnresolvableModelException
...</screen>
<para>The identifying characteristic of this error type is the message, "Non-resolvable parent POM". This occurs because the
<literal>pom.xml</literal> file in the documentation project, called the "workgroup-pom" because of a project
<literal>&lt;artifactId>workgroup-pom&lt;/artifactId></literal> declaration, expects its parent pom file to be in the
location defined by the <literal>&lt;relativePath>../Docs-Master/pom.xml&lt;/relativePath></literal>, up one directory and
then in the <literal>Docs-Master</literal> director.
</para>
<para>So, if you see the message "Non-resolvable parent POM", ensure that the <literal>Docs-Master</literal> project
and your project have been cloned
into the same parent directory. See <xref linkend="section_cloning_master_doc"/> for detailed directions on how to do this.</para>
</section>

<section xml:id="section_template_debug_docbook_validation_error">
<title xml:id="section_template_debug_docbook_validation_error_title">Docbook validation errors</title>
<para>Validation errors are generally indicated in the build output with text like the following:
<screen>...
@@@@@@@@@@@@@@@@@@@@@@
!!!VALIDATION ERRORS!!
!!!!!!!!!!!!!!!!!!!!!!

Note: Open the temporary file:

file:/home/user1/Docs-Template/template/target//bk_main.xml-invalid.xml

to see all the errors in context.
You must correct the errors in the original
source DocBook or wadl files however.

You can control whether build fails or not by
setting failOnValidationError to no in your pom.

lineNumber: 272; columnNumber: 70; text not allowed here; expected element "address", ...</screen></para>
<para>This error message contains three key pieces of information:</para>
<orderedlist>
<listitem>
<para>The full path and filename that contains the context for the failure. In the message above, this is
<literal>/home/user1/Docs-Template/template/target//bk_main.xml-invalid.xml</literal>.</para>
</listitem>
<listitem>
<para>The location within the file of the syntax error. For the above example, the key information is "<literal>lineNumber: 272; columnNumber: 70</literal>.</para>
</listitem>
<listitem>
<para>An explanation of the failure. This information in the above error reads, "text not allowed here; expected element "address", ...".</para>
</listitem>
</orderedlist>
</section>

<section xml:id="section_template_debug_build_failure">
<title xml:id="section_template_debug_build_failure_title">Build failures</title>
<para>Build errors are easily identified as well. Below is an example:
<screen>...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 4.827s
[INFO] Finished at: Wed Jul 29 14:55:33 CDT 2015
[INFO] Final Memory: 17M/171M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp (generate-webhelp) on project openpower-template-guide: Execution generate-webhelp of goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp failed: XInclude resource error (sec_template_new_document.xml) and no fallback provided. XProc error err:XD0011: org.xml.sax.SAXParseException; systemId: file:/home/user1/openpower-foundation-docbkx-framework/doc/template/sec_template_new_document.xml; lineNumber: 55; columnNumber: 17; The element type "para" must be terminated by the matching end-tag "&lt;/para&gt;". -> [Help 1]
...</screen></para>

<para>Like validation errors, three key pieces of information are again provided:</para>
<orderedlist>
<listitem>
<para>The full path and filename of our failure is
<literal>/home/user1/Docs-Template/template/sec_template_new_document.xml</literal>.</para>
</listitem>
<listitem>
<para>The location within the file of the error is "<literal>lineNumber: 55; columnNumber: 17</literal>.</para>
</listitem>
<listitem>
<para>An explanation of the failure begins with the text, "The element type "para" must be terminated by the
matching end-tag "&lt;/para&gt;."</para>
</listitem>
</orderedlist>

<para>With these details in hand for either error, one simply locates the offending syntax and makes the appropriate
correction. Online resources such as those listed in <xref linkend="section_template_references"/> may be helpful.</para>
</section>

<section xml:id="section_template_debug_fo_validation_error">
<title xml:id="section_template_debug_fo_validation_error_title">FO validation failures</title>
<para>FO (formatting objects) validation failures are a slight bit more difficult to identify and require more effort to correct. A sample appears as follows:
<screen>...
Error
SXCH0003: org.apache.fop.fo.ValidationException:
"{http://www.w3.org/1999/XSL/Format}block" is not a valid child of "fo:list-block"!
(See position 70:-1): null:70:-1: "{http://www.w3.org/1999/XSL/Format}block" is not
a valid child of "fo:list-block"! (See position 70:-1)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 35.900s
[INFO] Finished at: Sat Mar 19 15:54:34 CDT 2016
[INFO] Final Memory: 107M/256M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.3:generate-webhelp (generate-webhelp) on project hwarch-caia-spec: Failed to transform to PDF: org.apache.fop.fo.ValidationException: "{http://www.w3.org/1999/XSL/Format}block" is not a valid child of "fo:list-block"! (See position 70:-1): null:70:-1: "{http://www.w3.org/1999/XSL/Format}block" is not a valid child of "fo:list-block"! (See position 70:-1) -> [Help 1]
...</screen></para>

<para>The "<literal>org.apache.fop.fo.ValidationException</literal>" text indicates that this error was during FO validation. The key pieces of information are as follows:</para>
<orderedlist>
<listitem>
<para>The error type is indicated in the text following the exception indictor. In our case, the error statement is:
<literal>"{http://www.w3.org/1999/XSL/Format}block" is not a valid child of "fo:list-block"!</literal>. This error clearly
has something to do with the nesting of a "fo:block" statement in a "fo:list-block" statement.</para>
</listitem>
<listitem>
<para>The location of the validation error is given in the statement
"<literal>See position 70:-1</literal>". These two values are the line number and character number of the error. So, our sample
error occurs on line 70, but the character number
of <literal>-1</literal> is an indication that the line is too long to effectively point.</para>
</listitem>
</orderedlist>

<para>What this information fails to detail is which file has the problem. To find the particular offending file, one must understand
the Docbook build process. This process begins by collecting all XML into a working copy of the main book file. The build failure error
in <xref linkend="section_template_debug_docbook_validation_error"/> includes a reference to this file which will be found in the
<literal>.../target/</literal> directory. It generally has the same name as the main book file of the document, which if copied
from the <citetitle>Master Template Guide</citetitle> project, will be <literal>bk_main.xml</literal>. When in doubt about
this file name, you will find it in the <literal>&lt;includes></literal> tag in the <literal>pom.xml</literal> file.</para>
<para>Once all information has been pulled into the working XML file, the XML statements are transformed into FO statements
in preparation for building the PDF. This step generates a <literal>.fo</literal>
file which can be found in the <literal>.../target/docbkx/autopdf/</literal> directory and typically has the same base file name as
the target PDF file. Again, the <literal>pom.xml</literal> file will clarify this name with the <literal>&lt;pdfFilenameBase></literal>
variable.</para>
<para>If one locates and opens the .fo file, it becomes obvious that it was intended as a working file and is not readily readable. Therefore, the first
step to understanding this error is to make the FO file more readable.
The <literal>xmllint</literal> tool can be used to create a more readable FO file. Assuming you have been
working in the document directory, the follow steps can be used to produce a more readable XML file:
<screen><prompt>$ </prompt><userinput>cd target/docbkx/autopdf</userinput>
<prompt>$ </prompt><userinput>xmllint --nonet --noent --nowarning --version --timing --format -o outfile infile</userinput>
xmllint: using libxml version 20901
compiled with: Threads Tree Output Push Reader Patterns Writer SAXv1 FTP HTTP DTDValid HTML Legacy C14N Catalog XPath XPointer XInclude Iconv ISO8859X Unicode Regexps Automata Expr Schemas Schematron Modules Debug Zlib Lzma
Parsing took 63 ms
Saving took 39 ms
Freeing took 9 ms
<prompt>$</prompt></screen></para>

<para>For your invocation of <literal>xmllint</literal>, substitute <literal>infile</literal> with the name of the Maven-generated
.fo file for your new project and pick a new <literal>outfile</literal> for the new .fo file.</para>

<note><para>The <literal>xmllint</literal> utility may need to be loaded on your system. On an Ubuntu Linux system,
this utility is provided in the <literal>libxml2-utils</literal> package. To locate the proper package for your system,
you may need to reference Google.</para></note>

<para>Now, with a nicely formatted FO file, we can re-invoke the FO Processor (FOP) directly and achieve a more readable error. To do this, invoke
<literal>fop</literal> as follows:<screen><prompt>$ </prompt><userinput>fop -fo fofile and -pdf pdffile</userinput>
Rendered page #1.
Rendered page #2.
Rendered page #3.
Rendered page #4.
Rendered page #5.
Rendered page #6.
Rendered page #7.
Exception
javax.xml.transform.TransformerException: org.apache.fop.fo.ValidationException: "fo:block" is not a valid child of "fo:list-block"! (See position 7830:112)
<prompt>$</prompt></screen></para>

<para>As expected, the FOP again reports an exception. However, this time the position information appears more complete. With this new information
and a nicely formatted .fo file, one can find the format statements in error, find the context for the error, and then locate the correct source
DocBook (XML) file. With this information, one can inspect the document source to decide if the error is bad DocBook syntax or a tooling bug. If the latter,
please save the newly formatted .fo file and include it in the bug writeup.</para>
<note><para>Fully understanding the error, may require knowing more about XSL FO syntax. Many such web sites exist for this, but
the <citetitle>XSL Formatting Objects Summary</citetitle> from W3C (World Wide Web Consortium) provides a good starting reference online at
<link xlink:href="https://www.w3.org/2002/08/XSLFOsummary.html">https://www.w3.org/2002/08/XSLFOsummary.html</link>.</para></note>

</section>
</section>

95
Intrinsics_Reference/sec_template_existing_document.xml
Unescape Escape View File

@ -0,0 +1,95 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_existing_document">

<title xml:id="section_template_existing_document_title">Modifying an existing document</title>

<para>To begin editing an existing document, you must first clone two projects -- the master document framework project and
the specific document project. Begin by cloning the master document as described in <xref linkend="section_cloning_master_doc"/>.</para>
<para>Once complete, obtain a copy of the desired document by cloning its project. For example, to clone this document,
<citetitle>Master Template Guide</citetitle>, from the
public OpenPOWER Foundation git repository, use this
command:<screen><prompt>$ </prompt><userinput>git clone https://github.com/OpenPOWERFoundation/Docs-Template.git</userinput>
Cloning into 'Docs-Template'...
Username for 'https://github.com': <userinput>my_userid</userinput>
Password for 'https://my_userid@github.com': <userinput>my_password</userinput>
remote: Counting objects: 62, done.
remote: Compressing objects: 100% (10/10), done.
remote: Total 62 (delta 2), reused 0 (delta 0), pack-reused 52
Unpacking objects: 100% (62/62), done.
Checking connectivity... done.
<prompt>$ </prompt></screen></para>

<para>To build a specific document such as the template guide, follow these steps from the directory where
you just cloned:<screen><prompt>$ </prompt><userinput>cd Docs-Template/template</userinput>
<prompt>$ </prompt><userinput>mvn clean</userinput>
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building OpenPOWER Template Guide 1.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ openpower-template-guide ---
[INFO] Deleting ~/Docs-Template/template/target
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.353s
[INFO] Finished at: Wed Feb 25 12:54:47 CST 2015
[INFO] Final Memory: 3M/7M
[INFO] ------------------------------------------------------------------------
<prompt>$ </prompt><userinput>mvn generate-sources</userinput>
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building OpenPOWER Template Guide 1.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- openpowerdocs-maven-plugin:1.0.0:generate-webhelp (generate-webhelp) @ openpower-template-guide ---
[INFO] Processing input file: bk_main.xml
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 20.361s
[INFO] Finished at: Wed Feb 25 12:55:15 CDT 2015
[INFO] Final Memory: 30M/390M
[INFO] ------------------------------------------------------------------------
<prompt>$ </prompt></screen></para>

<note><para>The permutations of Maven invocations may be combined into one operation where the parameters are specified in the order
in which one wishes to execute them. Thus, the command <literal>mvn clean generate-sources</literal> would accomplish the
same thing as the above sequence of commands.</para></note>

<para>If all goes well, the generated pdf should be available in <literal>~/Docs-Template/template/target/docbkx/webhelp/template-guide/</literal>.</para>

<para>For assistance correcting commmon build failures, see <xref linkend="section_template_debug"/>.</para>

<note><para>Projects may contain multiple documents. While specific documents can be built by executing a
<literal>mvn clean generate-sources</literal> in the specific document directory, executing this command in
the base project directory will build all projects identified in the <literal>&lt;module></literal> list in the
top-level <literal>pom.xml</literal> file, known as the "workgroup-pom".</para></note>
<para>You are now ready to begin making updates. Before diving deeply into new text,
you may want to review
<xref linkend="section_template_process"/> to ensure that proper Work Product,
Work Process, and security values are selected for your document.</para>
</section>

34
Intrinsics_Reference/sec_template_faq.xml
Unescape Escape View File

@ -0,0 +1,34 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_faq">

<title xml:id="section_template_faq_title">Frequently asked questions</title>
<para>The list of questions and answers may be helpful to first time document writers:</para>
<qandaset defaultlabel="qanda"><?dbhtml toc="0" ?>
<qandaentry>
<question><para>Do I have to follow the guidelines in <xref linkend="section_template_policies"/> of this guide?</para></question>
<answer><para>No. <emphasis>HOWEVER</emphasis>, doing so makes it simpler for all community members to participate in maintaining your document.</para></answer>
</qandaentry>
<qandaentry>
<question><para>Question 2...</para></question>
<answer><para>Answer 2...</para></answer>
</qandaentry>
</qandaset>

</section>

105
Intrinsics_Reference/sec_template_getting_started.xml
Unescape Escape View File

@ -0,0 +1,105 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_getting_started">

<title xml:id="section_template_getting_started_title">Getting started</title>
<para>To begin contributing to the OpenPOWER Foundation documentation, the following steps must be completed:
<orderedlist>
<listitem>
<para>Installing tools</para>
</listitem>
<listitem>
<para>Creating accounts</para>
</listitem>
<listitem>
<para>Cloning master document information</para>
</listitem>
</orderedlist>
</para>

<para>Once complete, you can proceed to either <xref linkend="section_template_new_document"/> or
<xref linkend="section_template_existing_document"/> as needed.</para>

<section>
<title>Installing tools</title>
<para>Only two tools are required to update documentation, git and maven. Git manages the documentation
source and maven provides the build framework to create the published content in PDF and html form.
Installation steps for these tools varies by operating system.</para>
<para>On Debian-based Linux operating systems (Ubuntu and Debian), install maven and git as follows:
<screen><prompt># </prompt><userinput>apt-get install git</userinput>
<prompt># </prompt><userinput>apt-get install maven</userinput></screen></para>
<para>On RPM-based Linux operating systems (Fedora, RHEL, openSUSE, SLES), install maven and git as follows:
<screen><prompt># </prompt><userinput>yum install git</userinput>
<prompt># </prompt><userinput>yum install maven</userinput></screen></para>
<para>On Mac OS X, use Macports to install maven and git as follows:
<screen><prompt># </prompt><userinput>port install git</userinput>
<prompt># </prompt><userinput>port install maven3</userinput></screen></para>
<para>or use Homebrew to install maven and git as follows:
<screen><prompt>$ </prompt><userinput>brew install git</userinput>
<prompt>$ </prompt><userinput>brew install maven</userinput></screen></para>
<para>For information on how to setup the environment on Windows, see the following websites:
<itemizedlist>
<listitem>
<para>git for Windows - <link xlink:href="http://msysgit.github.io/">http://msysgit.github.io/</link></para>
</listitem>
<listitem>
<para>Maven on Windows - <link xlink:href="http://maven.apache.org/guides/getting-started/windows-prerequisites.html">
http://maven.apache.org/guides/getting-started/windows-prerequisites.html</link></para>
</listitem>
</itemizedlist>
</para>
<note><para>Modification of documentation source files requires a text editor. While standard editors like vim, emacs, or gedit can be used,
it is highly recommended that an editor be used which highlights XML or Docbook syntax. If your favorite editor does not include an
extension or plugin to accomplish this, you might consider using Bluefish to edit your docbook files. Details on this editor
can be found at <link xlink:href="http://bluefish.openoffice.nl/index.html">http://bluefish.openoffice.nl/index.html</link>.</para></note>
</section>

<section xml:id="section_creating_accounts">
<title>Creating accounts</title>
<para>All OpenPOWER project documentation is maintained in GitHub trees, public and private. The first
step to creating documentation will be joining the GitHub community.</para>
<para>To join the GitHub community,
apply at <link xlink:href="https://github.com/join">https://github.com/join</link>.</para>
<para>The OpenPOWER Foundation documentation trees are grouped in the OpenPOWER Foundation project at
<link xlink:href="https://github.com/OpenPOWERFoundation">https://github.com/OpenPOWERFoundation</link>.
Everyone should be able to see and access public trees like Docs-Master. However,
if you will be participating in private OpenPOWER Foundation trees, you will need to request access from the
Technical Steering Committee Chair, <email>tsc-chair@openpowerfoundation.org</email>.</para>
<para>To learn more about using git, see the online article in GitHub Help, "Good Resources for Learning Git and GitHub." at
<link xlink:href="https://help.github.com/articles/good-resources-for-learning-git-and-github/">
https://help.github.com/articles/good-resources-for-learning-git-and-github/</link>.</para>
</section>

<section xml:id="section_cloning_master_doc">
<title>Cloning master document information</title>
<para>To successfully build OpenPOWER Foundation documents, common document files must be in place in addition to the specific
document files. These common files are obtained by cloning the OpenPOWER Foundation public project <literal>Docs-Master</literal>.</para>
<para>To clone the master template document framework use the clone git command:<screen><prompt>$ </prompt><userinput>git clone https://github.com/OpenPOWERFoundation/Docs-Master.git</userinput>
Cloning into 'Docs-Master'...
remote: Counting objects: 24, done.
remote: Compressing objects: 100% (18/18), done.
remote: Total 24 (delta 6), reused 20 (delta 5), pack-reused 0
Unpacking objects: 100% (24/24), done.
Checking connectivity... done.
<prompt>$ </prompt></screen></para>
<para>More information can be found about the Docs-Master project online at <link xlink:href="https://github.com/OpenPOWERFoundation/Docs-Master">
https://github.com/OpenPOWERFoundation/Docs-Master</link>. Additional details about the OpenPOWER Foundation documentation structure
are explained in <xref linkend="section_template_structure"/> of this document.</para>
</section>
</section>

182
Intrinsics_Reference/sec_template_git_commands.xml
Unescape Escape View File

@ -0,0 +1,182 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_git_commands">

<title xml:id="section_template_git_commands_title">Common git commands</title>
<para>This section provides a list of commonly used git command invocations. All commands shown, except
the first one (<literal>git clone</literal> must be issued from within the project directory.</para>

<itemizedlist>

<listitem>
<para>To clone a git tree for first time or temporary use via http,
use:<screen><prompt>$ </prompt><userinput>git clone &lt;URL></userinput></screen></para>
<para>The <literal>&lt;URL></literal> value for OpenPOWER Foundation GitHub projects can be found on the project web pages.
They generally take the form of <literal>https://github.com/OpenPOWERFoundation/project_name</literal> where the
<literal>project_name</literal> can be found on the OpenPOWER Foundation Git Hub community page at
<link xlink:href="https://github.com/OpenPOWERFoundation">https://github.com/OpenPOWERFoundation</link>. The result of this
command will be a new directory with the same name as the project and in which will be the project files.</para>
<note><para>Trees can only be cloned once. To update a tree, use a <literal>git pull</literal> or <literal>git merge</literal>
command.</para></note>
<note><para>When cloning from a private tree, you will be prompted for your GitHub userid and password.</para></note>
</listitem>

<listitem>
<para>To update a git tree with new files from the remote repository,
use:<screen><prompt>$ </prompt><userinput>git pull</userinput></screen></para>
<para>This command assumes that the local tree has not been updated since the clone or last pull. If updates have been made to
the local tree, the command will fail. Use the <literal>git status</literal> command to see what has changed in a local tree.</para>
<note><para>When pulling from a private tree, you will be prompted for your GitHub userid and password.</para></note>
</listitem>

<listitem>
<para>To see the status of the local repository,
use:<screen><prompt>$ </prompt><userinput>git status</userinput></screen></para>
<para>This command identifies files which have changed in the local repository and provides suggestions on how to handle.</para>
<note><para>Adding the <literal>-s</literal> parameter to the end of the command will provide a simplified view in which changed files
are listed with flags such as <literal>M</literal> for modified files, <literal>A</literal> for newly added files,
and <literal>??</literal> for new or unknown files. This parameter also suppresses suggested action information for the files.</para></note>
</listitem>

<listitem>
<para>To add a new file or directory to a git tree,
use:<screen><prompt>$ </prompt><userinput>git add &lt;new_file></userinput></screen></para>
<para>The <literal>&lt;new_file></literal> value can be either a file or a whole directory and may include the path to
the target file or directory. This command will convert the status of file in the <literal>git status -s</literal>
command from <literal>??</literal> to <literal>A</literal> or move it from the "Untracked files" section to the
"Changes to be committed" section of the <literal>git status</literal> command.</para>
</listitem>

<listitem>
<para>To remove a file from a git tree,
use:<screen><prompt>$ </prompt><userinput>git rm &lt;file></userinput></screen></para>
<para>The <literal>&lt;file></literal> value must be a file and may include wildcard characters or the path to
the target file. This command will both remove the file(s) from the directory and the git tree. Removed files will show in
a status modifier of <literal>D</literal> in the <literal>git status -s</literal>
command and be reflected in the "Changes not staged for commit" section of the<literal>git status</literal> command
with a "deleted:" status.</para>
</listitem>

<listitem>
<para>To remove a directory from a git tree,
use:<screen><prompt>$ </prompt><userinput>git rm -rf &lt;directory></userinput></screen></para>
<para>The <literal>&lt;directory></literal> value must be a directory name and may include wildcard characters or the path to
the target directory. This command will remove all files in the directory from the git tree, but will not remove the directory locally.
Standard operating system commands such as the Linux <literal>rmdir &lt;directory></literal> command must be issued separately to
remove the local directory. All removed files will show in
a status modifier of <literal>D</literal> in the <literal>git status -s</literal>
command and be reflected in the "Changes not staged for commit" section of the<literal>git status</literal> command with a
"deleted:" status. Because git does not
track directories, they will not be reflected in status.</para>
</listitem>

<listitem>
<para>To move or rename a file or directory in a git tree,
use:<screen><prompt>$ </prompt><userinput>git mv &lt;source> &lt;destination></userinput></screen></para>
<para>The <literal>&lt;source></literal> value must be a file or directory and may include the path to
the target file. The <literal>&lt;destination></literal> value may be a file (if renaming a file) or a directory
if moving a file or directory.
This command will move or rename the file(s) in both the local and remote the git trees.</para>
</listitem>

<listitem>
<para>To commit all local changes to the staging area for a git tree,
use:<screen><prompt>$ </prompt><userinput>git commit -a</userinput></screen></para>
<para>This command will invoke an editor for a commit message. A well-formatted commit message includes a
title on the first line, a blank line, one or more lines of details describing the changes, and a Developer's
Certificate of Orig (DCO) Sign-off statement at the end. <screen>Signed-off-by: Your name &lt;your_email@domain.com></screen></para>
<para>For information on the DCO, see <citetitle>Developer Certificate Of Origin</citetitle> at
<link xlink:href="http://elinux.org/Developer_Certificate_Of_Origin">http://elinux.org/Developer_Certificate_Of_Origin</link>.</para>
</listitem>

<listitem>
<para>To push all locally staged changes to the remote git tree,
use:<screen><prompt>$ </prompt><userinput>git push</userinput></screen></para>
<note><para>When pushing to a private tree, you will be prompted for your GitHub userid and password.</para></note>
</listitem>

<listitem>
<para>To see what tags exist in a git tree,
use:<screen><prompt>$ </prompt><userinput>git tag</userinput></screen></para>
</listitem>

<listitem>
<para>To create a new tag locally,
use:<screen><prompt>$ </prompt><userinput>git tag -a &lt;tag_name> -m"text"</userinput></screen></para>
<para>The <literal>tag_name</literal> represents the simple value of the tag. The <literal>text</literal> string
provides more description of the tag for readibility.</para>
<note><para>This command simply tags locally. See the next command for how to push the tag to the remote repository.</para></note>
</listitem>

<listitem>
<para>To push a new tag from the local tree to the remote tree,
use:<screen><prompt>$ </prompt><userinput>git push origin &lt;tag_name></userinput></screen></para>
<para>This commands assumes the <literal>git tag</literal> command has been run on the local tree.</para>
</listitem>

<listitem>
<para>To discard changes from a locally changed file and return to the last copy,
use:<screen><prompt>$ </prompt><userinput>git checkout -- &lt;file></userinput></screen></para>
<para>The <literal>&lt;file></literal> value must be a file and may include wildcard characters or the path to
the target file.</para>
</listitem>

<listitem>
<para>To identify what changes have been made locally to a file
use:<screen><prompt>$ </prompt><userinput>git diff &lt;file></userinput></screen></para>
<para>The <literal>&lt;file></literal> value must be a file and may include wildcard characters or the path to
the target file. The output will be in format similar to the standalone <literal>diff</literal> command.</para>
</listitem>

</itemizedlist>

<para>Additional resources about git can be found online at the following locations:</para>

<itemizedlist>

<listitem>
<para>The <citetitle>GitHub Glossary</citetitle> at
<link xlink:href="https://help.github.com/articles/github-glossary/">https://help.github.com/articles/github-glossary/</link>.
This site provides a list of common terms associated with git and GitHub.</para>
</listitem>

<listitem>
<para>The GitHub <citetitle>Git Cheat Sheet</citetitle> at
<link xlink:href="https://training.github.com/kit/downloads/github-git-cheat-sheet.pdf">
https://training.github.com/kit/downloads/github-git-cheat-sheet.pdf</link>.
This two page pdf provides a quick summary of many common commands.</para>
</listitem>


<listitem>
<para>The <citetitle>Git Reference</citetitle> at
<link xlink:href="http://gitref.org/">http://gitref.org/</link>. This is a deeper and more comprehensive reference of important commands.</para>
</listitem>

<listitem>
<para>The git-scm.com <citetitle>Documentation</citetitle> library at
<link xlink:href="http://git-scm.com/doc">http://git-scm.com/doc</link>. This site provides education in the form of books, videos,
and other tutorials for common git activities.</para>
</listitem>

</itemizedlist>
</section>

274
Intrinsics_Reference/sec_template_new_document.xml
Unescape Escape View File

@ -0,0 +1,274 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_new_document">

<title xml:id="section_template_new_document_title">Creating a new document</title>
<para>Creating a new document from scratch follows four simple steps:</para>
<orderedlist>
<listitem>
<para>Cloning the project source.</para>
</listitem>
<listitem>
<para>Finding a document framework.</para>
</listitem>
<listitem>
<para>Modifying core project files.</para>
</listitem>
<listitem>
<para>Adding new document content.</para>
</listitem>
</orderedlist>

<section>
<title>Clone the project source.</title>
<para>All documentation projects reside in a project directory maintained in GitHub, just like the
<literal>Docs-Master</literal> framework described in <xref linkend="section_cloning_master_doc"/>. In the same directory
where the <literal>Docs-Master</literal> project has been cloned, you will need to
clone the documentation source for your project. A list of the OpenPOWER Foundation projects can be found at
<link xlink:href="https://github.com/OpenPOWERFoundation/">https://github.com/OpenPOWERFoundation/</link>. Select
the project from this list.</para>
<note><para>If you do not see the project for which you are looking, you may not be authorized to it. See
<xref linkend="section_creating_accounts"/> for details about joining the OpenPOWER Foundation private projects. If you
feel that you need a new GitHub project, work with the
Technical Steering Committee Chair, <email>tsc-chair@openpowerfoundation.org</email>, to request and get this setup.</para></note>
<para>To clone an OpenPOWER Foundation project like <literal>Docs-Template</literal> issue the following
command:<screen><prompt>$ </prompt><userinput>git clone https://github.com/OpenPOWERFoundation/Docs-Template.git</userinput>
Cloning into 'Docs-Template'...
Username for 'https://github.com': <userinput>my_userid</userinput>
Password for 'https://my_userid@github.com': <userinput>my_password</userinput>
remote: Counting objects: 62, done.
remote: Compressing objects: 100% (10/10), done.
remote: Total 62 (delta 2), reused 0 (delta 0), pack-reused 52
Unpacking objects: 100% (62/62), done.
Checking connectivity... done.
<prompt>$ </prompt></screen> The results should look roughly something like above with actual numbers of objects, files, etc. varying
for different projects.</para>

<note><para>Private projects prompt for a GitHub userid and and password. When cloning public projects, these prompts
are skipped.</para></note>
<para>The base project has now been cloned.</para>
</section>
<section>
<title>Finding a document framework</title>
<para>If this is your first document, in a brand new project (git tree), you have the fewest number of steps
to perform because your project should have been primed with a single project based on <literal>Docs-Template</literal>.
You can verify this by inspecting
the files in your project directory. A new project will contain a <literal>template</literal> directory, a <literal>pom.xml
</literal> file, a <literal>LICENSE</literal> file, and a <literal>README.md</literal> file. If this is the case, you simply
need to perform the following three steps:</para>
<orderedlist>
<listitem>
<para>Navigate down to your project directory, called <literal>my_project</literal> for this example. This can be achieved
using the <literal>cd</literal> command:
<screen><prompt>$ </prompt><userinput>cd ~/my_project</userinput>
<prompt>$ </prompt></screen></para>
<para>This directory should contain the <literal>template</literal> folder used to prime the project.</para>
</listitem>
<listitem>
<para>Rename the <literal>template</literal> document directory to something new like <literal>my_doc</literal>.
To accomplish this, use the <literal>mv</literal> command::
<screen><prompt>$ </prompt><userinput>mv template/ my_doc</userinput></screen></para>
</listitem>
<listitem>
<para>Change the project name in the workgroup POM.xml file. Using your editor, change this line
between the &lt;modules> and the &lt;/modules> tags near the top of the
file:<programlisting><![CDATA[<module>template</module>
]]></programlisting> to read like this:<programlisting><![CDATA[<module>my_doc</module>
]]></programlisting></para>
</listitem>
</orderedlist>
<para>If this is not the first document in the project, then you can either begin by copying an existing document or by cloning the
<literal>Docs-Template</literal> project. To copy an existing project, follow these steps:</para>
<orderedlist>
<listitem>
<para>Navigate down to your project directory, called <literal>my_project</literal> for this example.
This can be achieved using the <literal>cd</literal> command:
<screen><prompt>$ </prompt><userinput>cd ~/my_project</userinput>
<prompt>$ </prompt></screen></para>
<para>This directory should contain the folder name of the document wishing to be copied, called <literal>source_doc</literal>
for clarity in these directions.</para>
</listitem>
<listitem>
<para>To create a new document directory, simply create a new directory and copy the contents of the <literal>source_doc</literal>
directory. If creating a new directory named <literal>my_doc</literal> via a command line, the command
sequence would look like this:
<screen><prompt>$ </prompt><userinput>mkdir my_doc</userinput>
<prompt>$ </prompt><userinput>cp -r source_doc/* my_doc</userinput>
<prompt>$ </prompt></screen></para>
</listitem>
<listitem>
<para>Add the new project to the workgroup POM.xml file. Using your editor, add the following lines
between the &lt;modules> and the &lt;/modules> tags near the top of the file:<programlisting><![CDATA[<module>my_doc</module>
]]></programlisting></para>
</listitem>
</orderedlist>
<para>Instead of copying an existing document, you may want to start with the template document source. The steps to do this
are similar to those above, but with a few more commands. The following commands will create a new document based on the
the master template:</para>
<orderedlist>
<listitem>
<para>Navigate down to your project directory, called <literal>my_project</literal> for this example.
This can be achieved using the <literal>cd</literal> command:
<screen><prompt>$ </prompt><userinput>cd ~/my_project</userinput>
<prompt>$ </prompt></screen></para>
<para>This directory should contain any existing document folders along with at least a <literal>pom.xml</literal> file, a
<literal>LICENSE</literal> file, and a <literal>README.md</literal> file.</para>
</listitem>
<listitem>
<para>Clone the the template project into your working directory with this
command:<screen><prompt>$ </prompt><userinput>git clone https://github.com/OpenPOWERFoundation/Docs-Template.git</userinput>
Cloning into 'Docs-Template'...
Username for 'https://github.com': <userinput>my_userid</userinput>
Password for 'https://my_userid@github.com': <userinput>my_password</userinput>
remote: Counting objects: 62, done.
remote: Compressing objects: 100% (10/10), done.
remote: Total 62 (delta 2), reused 0 (delta 0), pack-reused 52
Unpacking objects: 100% (62/62), done.
Checking connectivity... done.
<prompt>$ </prompt></screen></para>
</listitem>
<listitem>
<para>To create a new project directory, simply create a new directory and copy the contents of the <literal>Docs-Template/template</literal>
directory. If creating a new project named <literal>my_doc</literal> via a command line, the command
sequence would look like this:
<screen><prompt>$ </prompt><userinput>mkdir my_doc</userinput>
<prompt>$ </prompt><userinput>cp -r Docs-Template/template/* my_doc</userinput>
<prompt>$ </prompt></screen></para>
</listitem>
<listitem>
<para>Once copied, the Docs-Template directory and all its contents should be removed from your project so that it does not
accidentally get included in your project. The command <userinput>rm -rf Docs-Template</userinput></para>
</listitem>
<listitem>
<para>Finally, add the new project to the workgroup POM.xml file. Using your editor, add the following lines
between the &lt;modules> and the &lt;/modules> tags near the top of the file:<programlisting><![CDATA[<module>my_doc</module>
]]></programlisting></para>
</listitem>
</orderedlist>

<note><para>Before committing the project back to git, you will need to add the new directory to the git repository. This can
be performed using the <literal>git add my_doc/</literal> command on the whole directory.</para></note>

<warning><para></para></warning>
<para>You are now ready to begin making updates to your new document. The next section will provided detailed steps of where to
get started.</para>
</section>

<section xml:id="section_modifying_project">
<title>Modifying core project files</title>
<para>The first step to customizing a new project is to modify two core project files--<literal>pom.xml</literal>
and <literal>bk_main.xml</literal>. Within these two files are XML comment tags that begin "<literal>&lt;!-- TODO:</literal>"
to identify places which need customization. The surrounding comments will provide guidance on what needs to change and how
it may be changed. Simply work through each item, making updates as requested.</para>
<para>Pick your setting for document work product type (<literal>&lt;workProduct></literal>,
work flow status (<literal>&lt;documentStatus></literal>), and
security (<literal>&lt;security></literal>)
carefully. <xref linkend="section_template_process"/> provides an overview of the process
and details the various settings needed in the document core project files. If you still have
questions after reading this section, consult with your Technical Steering Committee
representative.</para>
<note><para>Be sure to remember two key values you used in the <literal>pom.xml</literal> file, <literal>&lt;webhelpDirname&gt;</literal>
and <literal>&lt;pdfFilenameBase&gt;</literal>, as these will be used to locate your generated document.</para></note>
<para>When ready, build your new document using standard maven commands like
this:<screen><prompt>$ </prompt><userinput>cd my_proj/my_doc</userinput>
<prompt>$ </prompt><userinput>mvn clean</userinput>
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building OpenPOWER Template Guide 1.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ openpower-template-guide ---
[INFO] Deleting ~/my_doc/my_proj/target
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.353s
[INFO] Finished at: Wed Feb 25 12:54:47 CST 2015
[INFO] Final Memory: 3M/7M
[INFO] ------------------------------------------------------------------------
<prompt>$ </prompt><userinput>mvn generate-sources</userinput>
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building OpenPOWER Template Guide 1.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- openpowerdocs-maven-plugin:1.0.0:generate-webhelp (generate-webhelp) @ openpower-template-guide ---
[INFO] Processing input file: bk_main.xml
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 20.361s
[INFO] Finished at: Wed Feb 25 12:55:15 CDT 2015
[INFO] Final Memory: 30M/390M
[INFO] ------------------------------------------------------------------------
<prompt>$ </prompt></screen></para>
<para>If all goes well, the new generated pdf should be available in
<literal>target/docbkx/webhelp/&lt;webhelpDirname&gt;/&lt;pdfFilenameBase&gt;.pdf</literal>.</para>
<para>For assistance correcting commmon build failures, see <xref linkend="section_template_debug"/>.</para>
<note><para>The permutations of Maven invocations may be combined into one operation where the parameters are specified in the order
in which one wishes to execute them. Thus, the command <literal>mvn clean generate-sources</literal> would accomplish the
same thing as the above sequence of commands.</para></note>
</section>

<section>
<title>Adding new content</title>

<para>The starting point for book content is the <literal>bk_main.xml</literal> file (or whatever to which it was renamed
in the previous step). Removal and additions of the main chapter files will be controlled by entries near the
end of that file which appear as follows:<programlisting><![CDATA[ <!-- The ch_preface.xml file is required by all documents -->
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>

<!-- 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"/>
<xi:include href="ch_example.xml"/>

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

<!-- TODO: The following template document may be modified to create additional appendices as needed. -->
<xi:include href="app_template.xml"/>
]]></programlisting></para>

<para>Copying and modifying existing files from the template or other documents is a great way to get started. When creating
whole new chapter or appendix files from scratch, the <literal>ch_example.xml</literal> and <literal>app_template.xml</literal> files
may serve as excellent starting points. For XML examples of various document structures, please see <xref linkend="section_template_examples"/>
and its supporting source files in this document. Online resources such as those listed in <xref linkend="section_template_references"/>
may also be helpful.</para>

<note><para>When creating new files for the project, remember to use the <literal>git add &lt;file name&gt;</literal> command to
add new files to the git tree.</para></note>

</section>

</section>

59
Intrinsics_Reference/sec_template_policies.xml
Unescape Escape View File

@ -0,0 +1,59 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_policies">

<title xml:id="section_template_policies_title">Policies and conventions</title>
<para>Most document style policies are established simply by using the template documentation framework. However,
by applying some conventions to the document source structure, community members will be able to work across more d
ocumentation projects.</para>
<para>The recommended documentation structure guidelines are as follows:
<orderedlist>
<listitem>
<para>The head book file should be named with the prefix "bk_".</para>
</listitem>
<listitem>
<para>The document versioning as defined by the <literal>releaseinfo</literal> tag in the main book
file <literal>bk_xxx</literal> should be named "Revision N.N", not "Version N.N" or simply "N.N"</para>
</listitem>
<listitem>
<para>Chapters files should be named with the prefix "ch_".</para>
</listitem>
<listitem>
<para>Section and sub-section files should be named with the prefix "sec_".</para>
</listitem>
<listitem>
<para>Appendix files should be named with the prefix "app_".</para>
</listitem>
<listitem>
<para>Figures source and images should be placed in the <literal>figures</literal> sub-directory for the document.</para>
</listitem>
</orderedlist>
</para>
<para>In addition to documentation structure, general community/project guidelines are as follows:
<orderedlist>
<listitem>
<para>Contributions to the documentation projects should conform to the <citetitle>Developer Certificate
Of Origin</citetitle> as defined at <link xlink:href="http://elinux.org/Developer_Certificate_Of_Origin">
http://elinux.org/Developer_Certificate_Of_Origin</link>. Commits to the GitHub project need
to contain the following line to indicate the submitter accepts the
DCO:<screen>Signed-off-by: Your name &lt;your_email@domain.com></screen></para>
</listitem>
</orderedlist>
</para>

</section>

169
Intrinsics_Reference/sec_template_process.xml
Unescape Escape View File

@ -0,0 +1,169 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_process">

<title xml:id="section_template_process_title">Publishing OpenPOWER Documents</title>
<para>The <citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document
found in the OpenPOWER Foundation Members Community documents is the definitive guide for understanding
OpenPOWER Foundation documents and their work flow. The section strives to
provide an overview to help writers understand enough of the basics to know how to prepare their
document and what to expect as they proceed through various stages of document development from first
draft to specification publish.</para>
<para>The first key concept to understand about OpenPOWER Foundation documents and the first
decision to make when creating a new document is available document types or "Work Products".
These fall into one of two categories -- Standards Track or Non-standards Track -- with the simple
distinguishing factor being use. If the purpose of a document is to define a specification or standard
for hardware or software, then the document is "Standards Track". Everything else is "Non-standards
Track." For example, this document is a non-stardard work product.</para>
<para>Standards Track Work Products begin their life as Work Group Specification and may ultimately
become an OpenPOWER Standard. Their document lifecycle is defined in the following illustration:</para>

<figure pgwide="1" xml:id="project_process_std_track_label">
<title>Document work flow for Standard Track Work Products</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/project_process_std_track_graphic.svg" format="SVG" scalefit="1" width="100%" />
</imageobject>
</mediaobject>
</figure>

<para>Standard Track Work Products begin their lives as Work Group Specifications and have security classifications
of Public (non-confidental),
Members-only (OpenPOWER Foundation Confidental), or Work Group-only (OpenPOWER Work Group Confidential).
The security classification impacts the review type -- either public or internal to the Foundation -- as appropriate.
Only Work Group Specifications classified as Public may proceed into OpenPOWER Standard Documents. Confidential
documents will remain Work Group Specifications.</para>
<para>Non-standard Track Work Products exist simply as Work Group Notes. Their document
lifecycle follows this simplified workflow:</para>
<figure pgwide="1" xml:id="project_process_non-std_track_label">
<title>Document work flow for Non-standard Track Work Products</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/project_process_non-std_track_graphic.svg" format="SVG" scalefit="1" width="100%" />
</imageobject>
</mediaobject>
</figure>

<para>Non-standard Track, Work Group Notes begin as Drafts and drop the "Draft" annotation once reviewed. Like
Standard Track Work Products, they may have security classifications as Public (non-confidential), Members-only
(OpenPOWER Foundation Confidential), or Work-Group only (OpenPOWER Work Group Confidential) which will
in turn dictate the review context (public or private).</para>
<para>Once these decisions have been made, then they can be reflected into the document in the following ways:</para>
<orderedlist>

<listitem>
<para>The document Work Product type is defined in the document <literal>pom.xml</literal> file with the
<literal>&lt;workProduct></literal> variable. Valid settings are <literal>workgroupNotes</literal>,
<literal>workgroupSpecification</literal>, <literal>candidateStandard</literal>, and <literal>openpowerStandard</literal>.
Select the appropriate setting in the following section:
<programlisting><![CDATA[<!-- TODO: Define the appropriate work product type. These values are defined by the
IPR Policy. Consult with the Work Group Chair or a Technical Steering
Committee member if you have questions about which value to select.

If no value is provided below, the document will default to "Work Group
Notes".-->
<workProduct>workgroupNotes</workProduct>
<!-- workProduct>workgroupSpecification</workProduct -->
<!-- workProduct>candidateStandard</workProduct -->
<!-- workProduct>openpowerStandard</workProduct -->]]></programlisting></para>
</listitem>

<listitem>
<para>The document security is set in the document <literal>pom.xml</literal> file with the
<literal>&lt;security></literal> variable. Valid settings are <literal>public</literal>,
<literal>foundationConfidential</literal>, and <literal>workgroupConfidential</literal>.
Select the appropriate setting in the following section:
<programlisting><![CDATA[<!-- TODO: Set the appropriate security policy for the document. For documents
which are not "public" this will affect the document title page and
create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

public = this document may be shared outside the
foundation and thus this setting must be
used only when completely sure it allowed
foundationConfidential = this document may be shared freely with
OpenPOWER Foundation members but may not be
shared publicly
workgroupConfidential = this document may only be shared within the
work group and should not be shared with
other Foundation members or the public

The appropriate starting security for a new document is "workgroupConfidential". -->
<security>workgroupConfidential</security>
<!-- security>foundationConfidential</security -->
<!-- security>public</security -->]]></programlisting></para>
</listitem>

<listitem>
<para>The document work flow status is set in the document <literal>pom.xml</literal> file with the
<literal>&lt;documentStatus></literal> variable. Valid settings are <literal>draft</literal>,
<literal>review</literal>, and <literal>published</literal>.
Select the appropriate setting in the following section:
<programlisting><![CDATA[<!-- TODO: Set the appropriate work flow status for the document. For documents
which are not "published" this will affect the document title page
and create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

published = this document has completed all reviews and has
been published
draft = this document is actively being updated and has
not yet been reviewed
review = this document is presently being reviewed

The appropriate starting security for a new document is "draft". -->
<documentStatus>draft</documentStatus>
<!-- documentStatus>review</documentStatus -->
<!-- documentStatus>publish</documentStatus -->]]></programlisting></para>
</listitem>

<listitem>
<para>The final place to make updates to a new document is in the <literal>&lt;abstract></literal> section of
the <literal>bk_main.xml</literal> file for the document. This section needs to be updated with the appropriate
work group information and document information. Typical text appears as follows:
<programlisting><![CDATA[<!-- 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 purpose of the Master Template Guide document is to provide a guide
for OpenPOWER documentation writers. As such, it provides directions, policies,
references, and examples of the XML Docbook environment. It is intended to be
used both in final product form (PDF and html) as a document and in source form
as a template for new documents.</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.</para>
</abstract>]]></programlisting></para>
<para>As stated in the comment text of the book file, the first paragraph provides a typical abstract
statement about your particular document. The second paragraph provides more structured
text which should be updated with the appropriate Work Group name, Work Product type,
and Work Product process. The rest of the information in this paragraph should remain as-is.</para>
</listitem>

</orderedlist>

</section>

38
Intrinsics_Reference/sec_template_references.xml
Unescape Escape View File

@ -0,0 +1,38 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_references">

<title xml:id="section_template_references_title">Finding more information</title>
<para>The following lists of references may be helpful in learning about XML, Docbook, and/or Maven:</para>
<itemizedlist>
<listitem>
<para><citetitle>XML In a Nutshell</citetitle> by Elliotte Rusy Harold and W. Scott Means. Online at <link xlink:href="http://docstore.mik.ua/orelly/xml/xmlnut/index.htm">http://docstore.mik.ua/orelly/xml/xmlnut/index.htm</link>.</para>
</listitem>
<listitem>
<para><citetitle>DocBook 5: The Definitive Guide</citetitle> by Normal Walsh. Online at <link xlink:href="https://www.safaribooksonline.com/library/view/docbook-5-the/9781449380243/">https://www.safaribooksonline.com/library/view/docbook-5-the/9781449380243/</link>.</para>
</listitem>
<listitem>
<para><citetitle>DocBook XSL: The Complete Guide</citetitle> by Bob Stayton. Online at <link xlink:href="http://www.sagehill.net/docbookxsl/">http://www.sagehill.net/docbookxsl/</link>.</para>
</listitem>
<listitem>
<para><citetitle>Maven: The Complete Reference</citetitle> by Tim O'Brien, Manfred Moser, John Casey, Brian Fox, Jason Van Zyl, Eric Redmond, and Larry Shatzer. Online at <link xlink:href="http://books.sonatype.com/mvnref-book/reference/index.html">http://books.sonatype.com/mvnref-book/reference/index.html</link>.</para>
</listitem>
</itemizedlist>

</section>

88
Intrinsics_Reference/sec_template_structure.xml
Unescape Escape View File

@ -0,0 +1,88 @@
<!--
Copyright (c) 2016 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.
-->
<section 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_template_structure">

<title xml:id="section_template_structure_title">Understanding the project structure</title>
<para>The OpenPOWER Foundation documentation build process involves dependency on a common
framework and shared files. As such a deeper explanation about the relationships of key projects and their
components may be helpful to prevent and diagnose documentation build problems. This section
provides a pictorial layout of key files and explains their roles and relationships.</para>

<para>As mentioned multiple times throughout this guide, successful build of any OpenPOWER Foundation
document requires two things:</para>
<orderedlist>
<listitem><para>The cloning of the <literal>Docs-Master</literal> project.</para></listitem>
<listitem><para>The cloning of the specific documentation project into the same parent directory as the
<literal>Docs-Master</literal> project.</para></listitem>
</orderedlist>
<para>To begin to understand why, let us use a picture. The following graphic illustrates
the directory structure of three projects -- two
<literal>Docs-Master</literal> and <literal>Docs-Template</literal>, both existing OpenPOWER Foundation GitHub projects and a
hypothetical new project named <literal>my_project</literal>.</para>
<figure pgwide="1" xml:id="project_structure_label">
<title>Directory structure and key files in the OpenPOWER Foundation Docbook projects</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/project_structure_graphic.svg" format="SVG" scalefit="1" width="100%" />
</imageobject>
</mediaobject>
</figure>
<para>To create this structure, one would clone the <literal>Docs-Master</literal> project to
get the <literal>Docs-Master</literal> directory and all its contents (shown above in green),
clone the <literal>Docs-Template</literal> project to get the <literal>Docs-Template</literal> directory
and all its contents (shown in blue), and clone <literal>my_project</literal> project to get the
<literal>my_project</literal> directory and all its contents (shown in red).</para>
<para>Among these projects, the most important directory and project is <literal>Docs-Master</literal>. Without this project
and associated directory, no document will build. As depicted in the above figure, the <literal>Docs-Master</literal> directory
must sit at a level equal to all other project directories. Details on how to install this project can be found in the
<xref linkend="section_cloning_master_doc"/> section.</para>
<para>Inside the <literal>Docs-Master</literal>project directory, the two most important pieces are a
<literal>commmon</literal> directory
and a <literal>pom.xml</literal> file. The directory contains common files used by all projects such as the common preface
(<literal>ch_preface.xml</literal>) and the common appendix (<literal>app_foundation.xml</literal>. The <literal>pom.xml</literal> file
in this directory serves as the "Master POM" for all builds. This file references the OpenPOWER Maven Plugin JAR
(found in the OpenPOWER Foundation Repository at
<link xlink:href="http://openpowerfoundation.org/repo.openpowerfoundation.org/">http://openpowerfoundation.org/repo.openpowerfoundation.org/</link>)
used to control the OpenPOWER
Foundation document builds where all other dependencies, supporting tools, and document build rules are defined. </para>

<para>The <literal>Docs-Template</literal> project and directory are depicted in blue in the above figure. The top level of the
project <literal>Docs-Template</literal> must be cloned into the same parent directory as the <literal>Docs-Master</literal>
for Maven builds to complete successfully.
At the top level of the <literal>Docs-Template</literal> project
are a <literal>pom.xml</literal> referred to as the "Workgroup POM" and a single document directory (<literal>template</literal>).
The "Workgroup POM" is a minimal POM file that locates the parent, "Master POM" in the <literal>Docs-Master</literal>project directory
with a <literal>&lt;relativePath></literal> definition of <literal>../Docs-Master/pom.xml</literal>.
The document directory contains the unique files used to create the document. The two most important files in the
<literal>Docs-Template/template</literal> directory(and in any project) are the <literal>pom.xml</literal> or "Document POM" which describes
how to build the document and which points to the main document file, the <literal>bk_main.xml</literal> file. This book file
contains all the Docbook source, directly or through include statements (<literal>&lt;xi:include href="..."</literal>),
to build the document.</para>
<para>For completeness of understanding, a hypothetical project <literal>my_project</literal> is also depected in red. Like all
OpenPOWER Foundation projects, it is cloned at the correct level, equal to <literal>Docs-Master</literal>. Like the
<literal>Docs-Template</literal> project, it has a "Workgroup POM" which will differ only in the <literal>&lt;modules></literal>
section where it will describe two document projects, <literal>my_doc_1</literal> and <literal>my_doc_2</literal>. But, each
document directory has similar contents to <literal>Docs-Template/template</literal> -- a "Document POM" (<literal>pom.xml</literal>)
and a "Main book file" (<literal>bk_main.xml</literal>).</para>
</section>

1
pom.xml
Unescape Escape View File

@ -18,5 +18,6 @@
<!-- TODO: Add new documents are build in the project, add their directories to this list to
enable all document builds from the top level -->
<module>Porting_Vector_Intrinsics</module>
<module>Intrinsics_Reference</module>
</modules>
</project>

Write Preview
Loading…
Cancel
Save