Commit Graph

94 Commits (3ce06a1ef1e0a0a06a6420b6b5d3136031ca264d)
 

Author SHA1 Message Date
Paul Clarke 3ce06a1ef1 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>
4 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>
4 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>
4 years ago
Bill Schmidt 59cc953efa Change 1.0 to 1.7 for vec_unsigned[eo]
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 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>
4 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>
4 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>
4 years ago
Bill Schmidt 2f4ddf0e8c Improve section 2.7.3 with tables
Fixes #12.

Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Paul Clarke 418190d7b8 s/insruction/instruction/g
Signed-off-by: Paul A. Clarke <pc@us.ibm.com>
4 years ago
Bill Schmidt 2934030d69 Fixed typo in column length in Table 2.3
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt a928b66b93 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 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>
4 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>
4 years ago
Bill Schmidt b521f3e0b3 Add pcv descriptions for vec_reve & vec_extract_fp32_from_short[hl] 4 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>
4 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>
4 years ago
Bill Schmidt aa0209f734 Wording change to avoid the word "map".
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 65bf9b2827 Replace "instructions" with "operators".
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt f10f0d6283 Rewrite section 2.4 for #8.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 6f0fb84c85 Add named constants to vec_test_data_class for #27.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 109dc639e2 Finished reordering function type signatures for #23.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 65b6e8041b Reorder some function signatures for #23, more to go.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
4 years ago
Bill Schmidt 83d360047d 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 83b190f520 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 5d4899554c Resolve a number of comments from Paul Clarke, and one from Steve Munroe. 4 years ago
Bill Schmidt 42a18a5155 Merge branch 'master' of https://github.com/OpenPOWERFoundation/Programming-Guides 4 years ago
Bill Schmidt 8d8f1399c8 Add specification conformance section. 4 years ago
Jeff Scheel 0355015615 Fix URL links with .pdf extensions by substituting "%2e" fore "."
Signed-of-by: Jeff Scheel <scheel@us.ibm.com>
5 years ago
Bill Schmidt d84bc2d381 Mark this document as Standard Track. 5 years ago
Bill Schmidt e7eed33ece Create revision 1.0.0-prd for public review draft. 5 years ago
Bill Schmidt baccd1d54d Consistency of case for N-1 and Nth. 5 years ago
Bill Schmidt 8b350f9935 Changes for submission to OpenPOWER Systems SW Group. 5 years ago
Bill Schmidt cb85de8310 Fix typos. 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 4b974079d2 Updated bk_main to show this as revision 0.9.1. 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 cd7e3f4a4b Finish chapter 2. 5 years ago
Bill Schmidt 43c3a2851a Significant updates to chapters 1-3. Delete old outline file. 5 years ago
Bill Schmidt 8ca11d40b3 Add versions of vec_ctf that return double. 5 years ago
Bill Schmidt 764e8333fa Completed incorporating portions of Chapter 6 from the ELFv2 ABI. 5 years ago
Bill Schmidt bb5c9ecf8f More work in chapter 2. 5 years ago
Bill Schmidt 8425c297be Begin converting Chapter 6 of ELFv2 ABI document. 5 years ago
Bill Schmidt efe58c3e51 More work on history. 5 years ago
Bill Schmidt 6d84886ede Begin writing history.
Signed-off-by: Bill Schmidt <wschmidt@linux.ibm.com>
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>
5 years ago