From e65986c9bc5485d2f784bac6aadd20ee9e6420e7 Mon Sep 17 00:00:00 2001
From: Nobuyoshi Nakada <nobu@ruby-lang.org>
Date: Thu, 16 Jan 2025 13:12:58 +0900
Subject: [PATCH] [DOC] Add reference from global variables to equivalent
 MatchData

c.f. #21040
---
 doc/_regexp.rdoc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/_regexp.rdoc b/doc/_regexp.rdoc
index f86e419258..468827da15 100644
--- a/doc/_regexp.rdoc
+++ b/doc/_regexp.rdoc
@@ -127,6 +127,9 @@ The affected global variables are:
   Note that <tt>$0</tt> is quite different;
   it returns the name of the currently executing program.
 
+These variables, except for <tt>$~</tt>, are shorthands for methods of
+<tt>$~</tt>.  See MatchData@Global+variables+equivalence.
+
 Examples:
 
   # Matched string, but no matched groups.