From 107bc862addc09dc24a991d77821c11829e12695 Mon Sep 17 00:00:00 2001
From: lkcl <lkcl@web>
Date: Fri, 2 Sep 2022 23:36:28 +0100
Subject: [PATCH]

---
 openpower/sv/remap.mdwn | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/openpower/sv/remap.mdwn b/openpower/sv/remap.mdwn
index 94946b19a..26f5b945f 100644
--- a/openpower/sv/remap.mdwn
+++ b/openpower/sv/remap.mdwn
@@ -633,6 +633,28 @@ whilst `mm=1` is intended to be a little more refined.
 Beyond these mappings it becomes necessary to write directly to
 the SVSTATE SPRs manually.
 
+# svshape2 (offset) <a name="svshape2"> </a>
+
+`svshape2` is an additional convenience instruction that prioritises
+setting `SVSHAPE.offset`. It has similar cap
+
+    svshape2 offs,inv,yx,rmm,SVd,sk,mm
+
+| 0.5|6..8|9  |10|11.15  |16..20 | 21..25 | 25 | 26..31|  name    |
+| -- |----|---|--| ---   | ----- | ------ | -- | ------| -------- |
+|OPCD|offs|inv|yx| rmm   | SVd   | 100/mm | sk | XO    | svshape  |
+
+* **offs** (3 bits) - unsigned offset
+* **yx** (1 bit) - swap XY to YX
+* **inv** (1 bit) inverts X if yx=0, Y if yx=1
+* **SVd** dimension size
+* **rmm** REMAP mask
+* **mm** mask mode
+* **sk** (1 bit) skips 1st dimension if set
+
+Dimensions are calculated exactly as `svindex`. `rmm` and
+`mm` are as per `svindex`.  
+
 
 # TODO
 
-- 
2.30.2