binutils Newspaper
OCTOBER 12, 2026
s390 — Proposed

s390: Document PC-relative immediate operands in instruction formats

Updates s390 instruction format documentation to use 'RIx' for PC-relative immediate operands in RIE, RIL, and RSI formats.

This patch enhances the GNU Assembler’s documentation for the s390 architecture by introducing the ‘RIx’ (Relative Immediate) notation for PC-relative immediate operands. This change applies to instruction formats like RIE, RIL, and RSI, ensuring clearer and more accurate documentation that aligns with the z/Architecture Principles of Operation.

In the Thread 1 participant
  1. Jens Remus <jremus@linux.ibm.com> proposer

    Introduces 'RIx' notation for PC-relative immediate operands in the documentation for RIE, RIL, and RSI instruction formats.

In Details

This patch updates the s390 assembler's documentation (gas/doc/c-s390.texi) to standardize the representation of PC-relative immediate operands. It introduces the RIx notation (e.g., RI2) to denote signed PC-relative immediates used in instruction formats like RIE, RIL, and RSI, improving clarity and consistency with the z/Architecture specification.

For Context
PC-relative immediate
An immediate value in an instruction that is calculated relative to the current value of the Program Counter (PC).
RIE format
A s390 instruction format that includes register and PC-relative immediate operands.
RIL format
A s390 instruction format that includes a register and a PC-relative immediate operand.
RSI format
A s390 instruction format that includes register and PC-relative immediate operands.
Filed Under: s390gasdocumentationinstruction-formats