From 4a6facc2d683d1dbb67ded8a9f4d7cd10a9fd8ad Mon Sep 17 00:00:00 2001
From: Nobuyoshi Nakada <nobu@ruby-lang.org>
Date: Mon, 20 Jun 2022 13:35:21 +0900
Subject: [PATCH] [Feature #18788] [DOC] String options to `Regexp.new`
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Janosch Müller <janosch.mueller@betterplace.org>
---
 doc/regexp.rdoc | 5 +++++
 re.c            | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/doc/regexp.rdoc b/doc/regexp.rdoc
index 2b6a870026..f3844d5729 100644
--- a/doc/regexp.rdoc
+++ b/doc/regexp.rdoc
@@ -620,6 +620,11 @@ Options may also be used with <tt>Regexp.new</tt>:
     Regexp.new("abc # Comment", Regexp::EXTENDED)             #=> /abc # Comment/x
     Regexp.new("abc", Regexp::IGNORECASE | Regexp::MULTILINE) #=> /abc/mi
 
+    Regexp.new("abc", "i")           #=> /abc/i
+    Regexp.new("abc", "m")           #=> /abc/m
+    Regexp.new("abc # Comment", "x") #=> /abc # Comment/x
+    Regexp.new("abc", "im")          #=> /abc/mi
+
 == Free-Spacing Mode and Comments
 
 As mentioned above, the <tt>x</tt> option enables <i>free-spacing</i>
diff --git a/re.c b/re.c
index 39d4fc046f..3e059b6287 100644
--- a/re.c
+++ b/re.c
@@ -3665,6 +3665,11 @@ str_to_option(VALUE str)
  *
  *  Optional argument +options+ is one of the following:
  *
+ *  - A String of options:
+ *
+ *      Regexp.new('foo', 'i')  # => /foo/i
+ *      Regexp.new('foo', 'im') # => /foo/im
+ *
  *  - The logical OR of one or more of the constants
  *    Regexp::EXTENDED, Regexp::IGNORECASE, and Regexp::MULTILINE:
  *