Commit Graph

59 Commits (b795cb09f77353baed10f2afc2f580ddbc055f75)

Author SHA1 Message Date
Paul Clarke 24953643b8 Add example for vec_bperm
vec_bperm is a challenge for showing an example using just tables,
but I've made an attempt.

Three tables are used:
- The values of the input vectors *a* and *b*.
- A zoomed in view of the last two bytes of *a* and the bit
  manipulations therein that leads to the intermediate result.
- The result vector *r*.

Only one example has been provided, but it's getting big.

Fixes #14.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
5 years ago
Paul Clarke 79b5466581 Add headers for new examples
In the absence of sufficient context, the new examples added to:
- vec_double{e,h,l,o}
- vec_permxor
- vec_pmsum_be
- vec_slv
- vec_srv
- vec_sum2s
- vec_sum4s
- vec_sums
- vec_unsigned{e,o}
may appear to be strictly big-endian.

Add headers to these examples showing the element indicies,
which hopefully provides sufficient context.

Fixes #44.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
5 years ago
Bill Schmidt 195033ed41 Fix description of vec_bperm
Fixes #47.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Paul Clarke b36c22b277 Add examples for vec_extract_fp32_from_short{h,l}
Also added table headers to more clearly indicate element ordering.

Fixes #17.

Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
5 years ago
Bill Schmidt 48744ea198 Fix code generation for vec_pack_to_short_fp32
Fixes #45.
5 years ago
Paul Clarke 944e4b238d Add examples for vec_double{e,h,l,o}
Fixes #16.

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

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

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 59cc953efa Change 1.0 to 1.7 for vec_unsigned[eo]
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Paul Clarke a8ee1740fb 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>
5 years ago
Bill Schmidt 0a7757714f 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>
5 years ago
Paul Clarke 21a921ea9a 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>
5 years ago
Paul Clarke 418190d7b8 s/insruction/instruction/g
Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
5 years ago
Paul Clarke fa4c359db2 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>
5 years ago
Paul Clarke 8c13a59ceb 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>
5 years ago
Bill Schmidt b521f3e0b3 Add pcv descriptions for vec_reve & vec_extract_fp32_from_short[hl] 5 years ago
Paul Clarke 13c16340e5 Add border around new examples in vec_slv and vec_srv
Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
5 years ago
Paul Clarke c6ff2b8812 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>
5 years ago
Bill Schmidt 6f0fb84c85 Add named constants to vec_test_data_class for #27.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 109dc639e2 Finished reordering function type signatures for #23.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 65b6e8041b Reorder some function signatures for #23, more to go.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 5d4899554c Resolve a number of comments from Paul Clarke, and one from Steve Munroe. 5 years ago
Bill Schmidt 8b350f9935 Changes for submission to OpenPOWER Systems SW Group. 5 years ago
Bill Schmidt 4a0e35f1d6 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 029c89866f Changed to consistently use Power versus POWER, Power ISA versus
PowerISA, etc.  Added graphic to vec_gb.
5 years ago
Bill Schmidt 44014d7a20 Finish pages for vec_first_{,mis}match{,_eos}_index. 5 years ago
Bill Schmidt 772dc10758 Various clean-ups in the vector reference. A couple remain. 5 years ago
Bill Schmidt 0164b53b85 Finish all the front matter! 5 years ago
Bill Schmidt 8ca11d40b3 Add versions of vec_ctf that return double. 5 years ago
Bill Schmidt efe58c3e51 More work on history. 5 years ago
Bill Schmidt 8a62c47be1 Create outline for front matter chapters.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
5 years ago
Bill Schmidt 024b22d3cd 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 ced618f232 Completion of cross-reference index.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt e3b55ce306 More cross-reference index terms.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 4a302f3b3b Still more index terms.
Signed-off-by: Bill Schmidt <linux.ibm.com>
6 years ago
Bill Schmidt 844e5bccb3 More cross-reference tags.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 929e655fe4 First stage of cross-reference index.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt a5a3ac10e1 Revert "Clarify const parameter in vec_extract."
This reverts commit bbda08d284.

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

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 7827422d71 Completed copying entries from Appendix A.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 3e105bdcc2 Complete transferring table A.3 (vec_all, vec_any) to this document.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 6b11ae5c69 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 ea380443b8 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 e242829d52 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 a2a9b83c4a Changes through vec_xl_be, plus vec_xst.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 8cccf7f539 Updates through vec_unpackl.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt ed5148441c Updates through vec_sube.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 9520441915 Updates through vec_sqrt.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago
Bill Schmidt 4787b5e9fd Updates through vec_sll.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
6 years ago