Commit 20aecbd6fc for perl

commit 20aecbd6fc571b7f8365b05efb9d4113ba36aa06
Author: Yves Orton <demerphq@gmail.com>
Date:   Tue Oct 27 21:38:10 2026 +0100

    regcomp: document named regnode properties

    Document the named property reader and setter convention for regnodes.
    Clarify that capture numbers are physical, relative offsets use regnode
    units, and existing semantic accessors keep their interfaces.

diff --git a/pod/perlreguts.pod b/pod/perlreguts.pod
index 45339d2883..b0182ac0b6 100644
--- a/pod/perlreguts.pod
+++ b/pod/perlreguts.pod
@@ -214,6 +214,14 @@ and equivalents for reading and setting the arguments; and C<STR_LEN()>,
 C<STRING()> and C<OPERAND()> for manipulating strings and regop bearing
 types.

+Opcode-specific code uses property names such as C<REF_CAPTURE()>,
+C<GOSUB_TARGET_OFFSET()> and C<CURLY_CAPTURE_PARENS()> instead of anonymous
+argument numbers or overloaded header fields. New properties have separate
+C<NAME(node)> readers and C<NAME_SET(node, value)> setters. Capture numbers
+are physical, and relative offsets are in regnode units. Existing semantic
+accessors, including C<ANYOF_FLAGS()>, C<PARNO()> and the C<CURLY_*> capture
+range and repeat-bound macros, retain their interfaces.
+
 =head3 Regop Definitions

 The following table is generated by F<regen/regcomp.pl> from F<regcomp.sym>.