[ruby-core:74247] [Ruby trunk Bug#11495] [Documentation] Please improve documentation for Regexp.new() and clarify the 3 argument call

Issue #11495 has been updated by Tomoyuki Chikanaga.

Backport changed from 2.1: DONE, 2.2: REQUIRED, 2.3: REQUIRED to 2.1: DONE, 2.2: DONE, 2.3: REQUIRED

r51006 and r53784 were backported into `ruby_2_2` branch at r54071.

----------------------------------------
Bug #11495: [Documentation] Please improve documentation for Regexp.new() and clarify the 3 argument call
https://bugs.ruby-lang.org/issues/11495#change-57381

* Author: Robert A. Heiler
* Status: Closed
* Priority: Normal
* Assignee: Zachary Scott
* ruby -v: 
* Backport: 2.1: DONE, 2.2: DONE, 2.3: REQUIRED
----------------------------------------
Hello,

The documentation at Regepx.new here:

    http://ruby-doc.org/core-2.2.3/Regexp.html#method-c-new

It shows a lot of information, in particular four ways to call it:

    new(string, [options [, kcode]]) -> regexp
    new(regexp) -> regexp
    compile(string, [options [, kcode]]) -> regexp
    compile(regexp) -> regexp
    
However, the examples given do not show an example of where
3 arguments are passed.

Today this came up on IRC where someone asked how to use
respectively what the meaning of kcode is, via example.

Can someone add an example of where/when to use 3 arguments
to this method please? Thank you.

---Files--------------------------------
0001-Improve-documentation-for-Regexp.new.patch (1.55 KB)


-- 
https://bugs.ruby-lang.org/

Unsubscribe: <mailto:[e-mail]?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>