(no commit message)

diff --git a/openpower/sv/remap.mdwn b/openpower/sv/remap.mdwn
index 2a93e5f80c8d713a3056f851fe2b55c61e00056c..59f00316df314fb9bce6c6f7b3b723803d6016ab 100644 (file)
--- a/openpower/sv/remap.mdwn
+++ b/openpower/sv/remap.mdwn
@@ -667,6 +667,20 @@ makes it easier.
 Dimensions are calculated exactly as `svindex`. `rmm` and
 `mm` are as per `svindex`.  
 
+*Programmer's Note: offsets for `svshape2` may be specified in the range
+0-7. Given that the principle of Simple-V is to fit on top of
+byte-addressable register files and that GPR and FPR are 64-bit (8 bytes)
+it should be clear that the offset may, when `elwidth=8`, begin an
+element-level operation starting element zero at any arbitrary byte.
+On cursory examination attempting to go **beyond** the range 0-7 seems
+inadequate until it is recalled that the **next GPR or FPR** is an
+alias for an offset in the range 8-15.  Thus by simply increasing
+the starting Vector point of the operation to the next register it
+can be seen that the offset of 0-7 would be sufficient.  Unfortunately
+however some operations are EXTRA2-encoded which does in fact leave
+them inaccessible.  TODO: decide if the decision to sacrifice one
+bit of `offs` in favour of an `inv` bit is worth it.
+<https://bugs.libre-soc.org/show_bug.cgi?id=911#c9>*
 
 # TODO