(no commit message)

diff --git a/openpower/sv/remap.mdwn b/openpower/sv/remap.mdwn
index bf4ef79f97425a427e88f349b2b2ea57d5f6b090..ab17b3c9164d2de7e6a376106b47ef3beb7bd60b 100644 (file)
--- a/openpower/sv/remap.mdwn
+++ b/openpower/sv/remap.mdwn
@@ -198,20 +198,22 @@ pipeline overlaps.  Out-of-order / Superscalar micro-architectures with
 register-renaming will have an easier time dealing with this than
 DSP-style SIMD micro-architectures.
 
-## svstate instruction
+## svshape instruction
 
-Please note: this is **not** intended for production.  It sets up
-(overwrites) all required SVSHAPE SPRs and indicates that the
-*next instruction* shall have those REMAP shapes applied to it,
-assuming that instruction is of the form FRT,FRA,FRC,FRB.
+`svshape` is a convenience instruction that reduces instruction
+count for common usage patterns, particularly Matrix, DCT and FFT. It sets up
+(overwrites) all required SVSHAPE SPRs and also modifies SVSTATE
+including VL and MAXVL. Using `svshape` therefore does not also
+require `setvl`.
 
 Form: SVM-Form SV "Matrix" Form (see [[isatables/fields.text]])
 
+    svshape SVxd,SVyd,SVzd,SVRM,vf
+
 | 0.5|6.10  |11.15  |16..20 | 21..25 | 25 | 26..30 |31|  name    |
 | -- | --   | ---   | ----- | ------ | -- | ------ |--| -------- |
 |OPCD| SVxd | SVyd  | SVzd  | SVRM   | vf | XO     |/ | svstate  |
 
-
 Fields:
 
 * **SVxd** - SV REMAP "xdim"