NEWS: categorized new entries all

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@64469 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 74 insertions, 45 deletions

diff --git a/NEWS b/NEWS
index 9e6c707a60..d25f6f32d6 100644
--- a/NEWS
+++ b/NEWS
@@ -83,43 +83,45 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `Exception`
 
-    * `Exception#full_message` takes `:highlight` and `:order` options.
-      [Bug #14324]
+    * New options:
+
+        * `Exception#full_message` takes `:highlight` and `:order` options.
+          [Bug #14324]
 
 * `Hash`
 
     * Aliased methods:
 
         * `Hash#filter` is a new alias for `Hash#select`.  [Feature #13784]
+
         * `Hash#filter!` is a new alias for `Hash#select!`.
           [Feature #13784]
 
 * `IO`
 
-    * new mode character `'x'` to open files for exclusive access.
-      [Feature #11258]
+    * New options:
+
+        * new mode character `'x'` to open files for exclusive access.
+          [Feature #11258]
 
 * `Kernel`
 
-    * `Kernel#then` is a new alias for `Kernel#yield_self`.
-      [Feature #14594]
+    * Aliased methods:
 
-    * `Kernel.#Complex` takes `:exception` option to specify the way of
-      error handling.  [Feature #12732]
+        * `Kernel#then` is a new alias for `Kernel#yield_self`.
+          [Feature #14594]
 
-    * `Kernel.#Float` takes `:exception` option to specify the way of error
-      handling.  [Feature #12732]
+    * New options:
 
-    * `Kernel.#Integer` takes `:exception` option to specify the way of
-      error handling.  [Feature #12732]
+        * `Kernel.#Complex`, `Kernel.#Float`, `Kernel.#Integer` and
+          `Kernel.#Rational` take `:exception` option to specify the way of
+          error handling.  [Feature #12732]
 
-    * `Kernel.#Rational` takes `:exception` option to specify the way of
-      error handling.  [Feature #12732]
+        * `Kernel.#system` takes `:exception` option to raise an exception
+          on failure.  [Feature #14386]
 
-    * `Kernel.#system` takes `:exception` option to raise an exception on
-      failure.  [Feature #14386]
+    * Incompatible changes:
 
-    * incompatible changes:
         * `system()` and `exec()` do not close non-standard file descriptors
           (The default of `:close_others` option is changed to `false` by
           default.  but we still set the `FD_CLOEXEC` flag on descriptors we
@@ -127,29 +129,40 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `KeyError`
 
-    * `KeyError#initialize` accepts `:receiver` and `:key` options to set
-      receiver and key in Ruby code.  [Feature #14313]
+    * New options:
+
+        * `KeyError#initialize` accepts `:receiver` and `:key` options to
+          set receiver and key in Ruby code.  [Feature #14313]
 
 * `Module`
 
-    * `Module#method_defined?`, `Module#private_method_defined?` and
-      `Module#protected_method_defined?` now accepts the second parameter as
-      optional. If it's `true` (=default), checks ancestor modules/classes,
-      or checks only the class itself.  [Feature #14944]
+    * New methods:
+
+        * `Module#method_defined?`, `Module#private_method_defined?` and
+          `Module#protected_method_defined?` now accepts the second
+          parameter as optional. If it's `true` (=default), checks ancestor
+          modules/classes, or checks only the class itself.
+          [Feature #14944]
 
 * `NameError`
 
-    * `NameError#initialize` accepts `:receiver` option to set receiver in
-      Ruby code.  [Feature #14313]
+    * New options:
+
+        * `NameError#initialize` accepts `:receiver` option to set receiver
+          in Ruby code.  [Feature #14313]
 
 * `NoMethodError`
 
-    * `NoMethodError#initialize` accepts `:receiver` option to set receiver
-      in Ruby code.  [Feature #14313]
+    * New options:
+
+        * `NoMethodError#initialize` accepts `:receiver` option to set
+          receiver in Ruby code.  [Feature #14313]
 
 * `Proc`
 
-    * `Proc#call` doesn't change `$SAFE` any more.  [Feature #14250]
+    * Incompatible changes:
+
+        * `Proc#call` doesn't change `$SAFE` any more.  [Feature #14250]
 
 * `Random`
 
@@ -159,20 +172,27 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `Range`
 
-    * `Range#===` now uses `#cover?` instead of `#include?` method.
-      [Feature #14575]
+    * Incompatible changes:
+
+        * `Range#===` now uses `#cover?` instead of `#include?` method.
+          [Feature #14575]
 
 * `RubyVM::AST`
 
-    * `RubyVM::AST.parse` parses a given string and returns AST nodes.
-      [experimental]
-    * `RubyVM::AST.parse_file` parses a given file and returns AST nodes.
-      [experimental]
+    * New methods:
+
+        * `RubyVM::AST.parse` parses a given string and returns AST nodes.
+          [experimental]
+
+        * `RubyVM::AST.parse_file` parses a given file and returns AST
+          nodes.  [experimental]
 
 * `String`
 
-    * `String#split` yields each substring to the block if given.
-      [Feature #4780]
+    * New features:
+
+        * `String#split` yields each substring to the block if given.
+          [Feature #4780]
 
 * `TracePoint`
 
@@ -184,12 +204,15 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `ERB`
 
-    * Add `:trim_mode` and `:eoutvar` keyword arguments to `ERB.new`. Now
-      non-keyword arguments other than first one are softly deprecated and
-      will be removed when Ruby 2.5 becomes EOL.  [Feature #14256]
+    * New options:
+
+        * Add `:trim_mode` and `:eoutvar` keyword arguments to `ERB.new`.
+          Now non-keyword arguments other than first one are softly
+          deprecated and will be removed when Ruby 2.5 becomes EOL.
+          [Feature #14256]
 
-    * erb command's `-S` option is deprecated, which will be removed in the
-      next version.
+        * erb command's `-S` option is deprecated, which will be removed in
+          the next version.
 
 * `FileUtils`
 
@@ -205,11 +228,13 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `Net`
 
-    * New method:
+    * New options:
 
         * Add `:write_timeout` keyword argument to `Net::BufferedIO.new`.
           [Feature #13396]
 
+    * New methods:
+
         * Add `Net::BufferedIO#write_timeout`,
           `Net::BufferedIO#write_timeout=`, `Net::HTTP#write_timeout`, and
           `Net::HTTP#write_timeout=`.  [Feature #13396]
@@ -257,8 +282,10 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `RSS`
 
-    * `RSS::Parser.parse`: Accept options as `Hash`. `:validate`,
-      `:ignore_unknown_element`, `:parser_class` options are available.
+    * New options:
+
+        * `RSS::Parser.parse`: Accept options as `Hash`. `:validate`,
+          `:ignore_unknown_element`, `:parser_class` options are available.
 
 * `Set`
 
@@ -268,7 +295,9 @@ sufficient information, see the ChangeLog file or Redmine
 
 * `URI`
 
-    * Add `URI::File` to handle file URI scheme.  [Feature #14035]
+    * New constant:
+
+        * Add `URI::File` to handle file URI scheme.  [Feature #14035]
 
 ### Compatibility issues (excluding feature bug fixes)