Commit Graph

129 Commits (master)

Author SHA1 Message Date
Paul Clarke abcf5fd283 Add examples for vec_double{e,h,l,o}
Fixes #16.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Paul Clarke 453d38c649 Add examples for vec_sum2s, vec_sum4s, vec_sums
Fixes #26.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt 55cbd6a38d Add 'const' to vec_ld* and vec_xl* pointer arguments
Fixed #37.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt ca8ef27c57 Change 1.0 to 1.7 for vec_unsigned[eo]
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Paul Clarke d8bf0dad66 Add examples for vec_unsigned{e,o}
Add simple examples for `vec_unsignede` and `vec_unsignedo`,
making sure to show undefined results and negative truncation.

Fixes #29.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt d939b73aac Move the endian-sensitive built-in function table
Move the table so that it won't have a head-scratching location
in the HTML view.  Update it to add the first_match* and first_mismatch*
functions.

Fixed #39.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Paul Clarke 0cea5e8dd1 Fix return type for vec_permxor
The return type for `vec_permxor` which takes `vector signed char`
as inputs should also be `vector signed char`.

Fixes #38.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt c952a73bb4 Improve section 2.7.3 with tables
Fixes #12.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Paul Clarke 5ab9ef6cce s/insruction/instruction/g
Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt 914a28f0cd Fixed typo in column length in Table 2.3
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt cd80528095 Add Table 2.3, Endian-Sensitive Built-In Functions
This fixes #7.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Paul Clarke a661a3a7f0 Add example for vec_pmsum_be
`vec_pmsum_be` is complex enough to warrant an example.

Fixes #33.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Paul Clarke ace0e99214 Add example for vec_permxor
`vec_permxor` is complex enough to warrant an example.

The table used is very wide. I squeezed it more by changing the names
of `index1` and `index2` to `x` and `y`, respectively.

Note: The table may still be too wide, as some additional warnings are
now generated during `mvn generate-sources`:
```
WARNING: Line 1 of a paragraph overflows the available area by more than 50 points. (See position 1:-1)
Apr 30, 2020 8:44:03 PM org.apache.fop.events.LoggingEventListener processEvent
WARNING: Line 1 of a paragraph overflows the available area by 468 millipoints. (See position 14259:-1)
Apr 30, 2020 8:44:03 PM org.apache.fop.events.LoggingEventListener processEvent
...
WARNING: span="inherit" on fo:block, but no explicit value found on the parent FO.
```

Fixes #20.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt b47b40b21a Add pcv descriptions for vec_reve & vec_extract_fp32_from_short[hl] 4 years ago
Paul Clarke 7c3dacd77b Add border around new examples in vec_slv and vec_srv
Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Paul Clarke 3d79fb03c1 Add examples to vec_vslv and vec_vsrv
vec_vslv and vec_vsrv are confusing in their own right and even more
so because they operate only with big-endian semantics.

Some examples are warranted.

Note that the respective examples are arranged such that the impact of
shifting in zero bits has a visible impact.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt 1dcb7e348e Wording change to avoid the word "map".
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt b8e4e0494f Replace "instructions" with "operators".
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 27535dc833 Rewrite section 2.4 for #8.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt a2fbae6002 Add named constants to vec_test_data_class for #27.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt b956e4b0c7 Finished reordering function type signatures for #23.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 09cb5dcfb7 Reorder some function signatures for #23, more to go.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 2ff0ceff3b Fix issue #5 by adding information about XL compiler bug reporting.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Paul Clarke 513de17330 Fix "Vector Registers as Part of VSRs" figure scaling
The "Vector Registers as Part of VSRs" figure was very large,
especially as it immediately follows an almost identical figure.

Before this change:
fig-fpr-vsr.png: PNG image data, 663 x 300...
fig-vr-vsr.png:  PNG image data, 1367 x 608...

After this change:
fig-fpr-vsr.png: PNG image data, 663 x 300...
fig-vr-vsr.png:  PNG image data, 645 x 287...

I chose this size because the actual side boundaries of the
table most closely match in size.

The scaling, using The GIMP, resulted in somewhat blurry lines,
but still quite clear enough, and good enough.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt 2333bd8a72 Resolve a number of comments from Paul Clarke, and one from Steve Munroe. 4 years ago
Bill Schmidt a37fc120a3 Merge branch 'master' of https://github.com/OpenPOWERFoundation/Programming-Guides 4 years ago
Bill Schmidt 0bede8ab57 Add specification conformance section. 4 years ago
Jeff Scheel eef719cf08 Fix URL links with .pdf extensions by substituting "%2e" fore "."
Signed-of-by: Jeff Scheel <scheel@us.ibm.com>
4 years ago
Bill Schmidt a396c89802 Mark this document as Standard Track. 4 years ago
Bill Schmidt ac57cca111 Create revision 1.0.0-prd for public review draft. 4 years ago
Bill Schmidt 746882d59a Consistency of case for N-1 and Nth. 5 years ago
Bill Schmidt 5dd75e151c Changes for submission to OpenPOWER Systems SW Group. 5 years ago
Bill Schmidt dfe9f8430a Fix typos. 5 years ago
Bill Schmidt 295c2a5922 Make updates for comments received so far, including issue #4 and
issue #5.  XL bug report support for Linux is still pending.
5 years ago
Bill Schmidt b2e4fce15b Changed to consistently use Power versus POWER, Power ISA versus
PowerISA, etc.  Added graphic to vec_gb.
5 years ago
Bill Schmidt ec386314da Updated bk_main to show this as revision 0.9.1. 5 years ago
Bill Schmidt c4a37819ee Finish pages for vec_first_{,mis}match{,_eos}_index. 5 years ago
Bill Schmidt eebad714c0 Various clean-ups in the vector reference. A couple remain. 5 years ago
Bill Schmidt 2817b77c5a Finish all the front matter! 5 years ago
Bill Schmidt 7a3454dc78 Finish chapter 2. 5 years ago
Bill Schmidt c086fbb288 Significant updates to chapters 1-3. Delete old outline file. 5 years ago
Bill Schmidt 57b40b4d84 Add versions of vec_ctf that return double. 5 years ago
Bill Schmidt 9ee3e96072 Completed incorporating portions of Chapter 6 from the ELFv2 ABI. 5 years ago
Bill Schmidt b32c1f7a1d More work in chapter 2. 5 years ago
Bill Schmidt f67eeaef89 Begin converting Chapter 6 of ELFv2 ABI document. 5 years ago
Bill Schmidt 215118d024 More work on history. 5 years ago
Bill Schmidt d8e780934e Begin writing history.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 5eb6078dfa Create outline for front matter chapters.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 80e327020a Add note on vec_perm invalid usage. Remove app_a.xml reference.
Signed-off-by: Bill Schmidt  <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 885b36c130 Completion of cross-reference index.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt f6ec308f1e More cross-reference index terms.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 9149a61781 Still more index terms.
Signed-off-by: Bill Schmidt <linux.ibm.com>
5 years ago
Bill Schmidt dd75407cb5 More cross-reference tags.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt f3ab8d4d81 First stage of cross-reference index.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 976ee6b8ae Revert "Clarify const parameter in vec_extract."
This reverts commit bbda08d284.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 8ce5f8cf87 Clarify const parameter in vec_extract.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 71180f5d04 Large chunk of progress; completed Appendix A, deprecated some
interfaces in vec_revb, etc.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt ec47543988 Completed copying entries from Appendix A.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 1b64f19d15 Complete transferring table A.3 (vec_all, vec_any) to this document.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt fbef5cb97e Changes for vec_all_eq, vec_all_ge, vec_all_gt.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt f8107bbc83 Add roughed-in pages for the intrinsics from tables A.3, A.4, A.5,
and A.6 of the original ABI, generated by Bill Seurer's doctool.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 4a97f22f82 Finished populating entries from Table A.2 of the ELFv2 ABI.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt ad2c1c1671 Changes through vec_xl_be, plus vec_xst.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 833ce97107 Updates through vec_unpackl.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt bfeaf69cde Updates through vec_sube.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 85fe025414 Updates through vec_sqrt.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 904139bf94 Updates through vec_sll.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 71571f871a Updates through vec_signed2.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 7233ab5254 Updates through vec_rl.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 84a108f287 Updates through vec_reve.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 8d64f1fdeb Incremental changes up through vec_nmsub.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 29ff012933 Incremental updates through vec_mul.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt b3033ba928 Incremental changes up through vec_loge.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 662f552fbf Changes through vec_extract_exp.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 0913542a05 Delete a number of unused files.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 781bd6ba0b Merge branch 'master' of
https://github.com/OpenPOWERFoundation/Programming-Guides.  Add Bill Seurer's
automatically generated entries to the main chapter.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt d15f4daaea Incorporate auto-generated sections from Bill Seurer's tool.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Jeff Scheel b99448cf90 Add mailing list references
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
7 years ago
Bill Schmidt 0465de7781 Initial project files.
Signed-off-by:  Bill Schmidt <wschmidt@linux.vnet.ibm.com>
7 years ago