Issue #5709 has been updated by Eric Hodel. I altered the wording on =~ mentioning Range and String because the operator is generic and may be overridden to perform other types of pattern matching. ---------------------------------------- Bug #5709: Improve Regexp documentation http://redmine.ruby-lang.org/issues/5709 Author: Sylvain Daubert Status: Closed Priority: Normal Assignee: Eric Hodel Category: DOC Target version: ruby -v: ruby 1.9.3p0 Improve Regexp documentation: * add a section to explain differences between =~ operator and #match * in Options section, explain how use options with Regexp.new * add a section about special global variables ($~ and so on) -- http://redmine.ruby-lang.org