From ee3c3b4a36708a279dda7eb848b4aa765f771003 Mon Sep 17 00:00:00 2001
From: Tom Lord <tom.lord@comlaude.com>
Date: Sat, 7 Feb 2015 23:27:41 +0000
Subject: [PATCH] adding documentation for non-subexp option toggling

---
 doc/regexp.rdoc | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/doc/regexp.rdoc b/doc/regexp.rdoc
index 810f15c..c41bdc3 100644
--- a/doc/regexp.rdoc
+++ b/doc/regexp.rdoc
@@ -528,10 +528,15 @@ options which control how the pattern can match.
 subexpression level with the
 <tt>(?</tt><i>on</i><tt>-</tt><i>off</i><tt>)</tt> construct, which
 enables options <i>on</i>, and disables options <i>off</i> for the
-expression enclosed by the parentheses.
+expression enclosed by the parentheses:
 
-    /a(?i:b)c/.match('aBc') #=> #<MatchData "aBc">
-    /a(?i:b)c/.match('abc') #=> #<MatchData "abc">
+    /a(?i:b)c/.match('aBc')   #=> #<MatchData "aBc">
+    /a(?-i:b)c/i.match('ABC') #=> nil
+
+Additionally, these options can also be toggled for the remainder of the
+pattern:
+
+    /a(?i)bc/.match('abC') #=> #<MatchData "abC">
 
 Options may also be used with <tt>Regexp.new</tt>:
 
-- 
1.9.1