[PATCH v2 03/47] s390: Enhance documentation of instruction operands

Jens Remus jremus@linux.ibm.com
Fri Nov 6 15:56:53 GMT 2026


gas/
	* doc/c-s390.texi (s390 Operands): Enhance documentation of
	instruction operands.

Signed-off-by: Jens Remus <jremus@linux.ibm.com>
---
 gas/doc/c-s390.texi | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/gas/doc/c-s390.texi b/gas/doc/c-s390.texi
index f6569af7d1e9..858c617a6a91 100644
--- a/gas/doc/c-s390.texi
+++ b/gas/doc/c-s390.texi
@@ -246,9 +246,10 @@ of Operation.
 Instruction operands can be grouped into three classes, operands located
 in registers, immediate operands, and operands in storage.
 
-A register operand can be located in general, floating-point, access,
-or control register. The register is identified by a four-bit field.
-The field containing the register operand is called the R field.
+Register operands can be located in a general, floating-point, vector,
+access, or control register.  The register is identified by a four-bit
+R field and, in case of vector registers, an additional bit in the four-bit
+RXB field.
 
 Immediate operands are contained within the instruction and can have
 8, 16 or 32 bits. The field containing the immediate operand is called
@@ -259,12 +260,12 @@ A storage operand consists of an address and a length. The address of a
 storage operands can be specified in any of these ways:
 
 @itemize
-@item The content of a single general R
+@item The content of a single general register R
 @item The sum of the content of a general register called the base
 register B plus the content of a displacement field D
 @item The sum of the contents of two general registers called the
 index register X and the base register B plus the content of a
-displacement field
+displacement field D
 @item The sum of the current instruction address and a 32-bit signed
 immediate field multiplied by two.
 @end itemize
@@ -273,9 +274,9 @@ The length of a storage operand can be:
 
 @itemize
 @item Implied by the instruction
-@item Specified by a bitmask
+@item Specified by a four-bit mask M
 @item Specified by a four-bit or eight-bit length field L
-@item Specified by the content of a general register
+@item Specified by the content of a general register R
 @end itemize
 
 The notation for storage operand addresses formed from multiple fields is
@@ -288,7 +289,7 @@ register Bn called the base register and the displacement field Dn.
 @item Dn(Xn,Bn)
 the address for operand number n is formed from the content of general
 register Xn called the index register, general register Bn called the
-base register and the displacement field Dn.
+base register, and the displacement field Dn.
 @item Dn(Ln,Bn)
 the address for operand number n is formed from the content of general
 register Bn called the base register and the displacement field Dn.
@@ -326,14 +327,18 @@ The following table lists the abbreviations used in the table of
 instruction formats:
 
 @display
-@multitable {OpCode / OpCd} {Displacement lower 12 bits for operand x.}
-@item OpCode / OpCd @tab Part of the op code.
+@multitable {OpCode / OpCd} {Signed PC-relative immediate for operand x.}
+@headitem Abbreviation @tab Description
+@item OpCode / OpCd @tab Part of the operation code.
 @item Bx @tab Base register number for operand x.
 @item Dx @tab Displacement for operand x.
 @item DLx @tab Displacement lower 12 bits for operand x.
-@item DHx @tab Displacement higher 8-bits for operand x.
+@item DHx @tab Displacement higher 8 bits for operand x.
+@item Mx @tab Mask for operand x.
+@item Lx @tab Length for operand x.
 @item Rx @tab Register number for operand x.
 @item Xx @tab Index register number for operand x.
+@item Vx @tab Vector register number for operand x.
 @item Ix @tab Signed immediate for operand x.
 @item Ux @tab Unsigned immediate for operand x.
 @end multitable
-- 
2.53.0



More information about the Binutils mailing list