erb 6.0.4 → 6.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b25d5fdfe9fee1fe6ecfb1e2e065899b51e0c1c4db0ad2d77684234b68483660
-  data.tar.gz: cd8460dbde78e4a3989a45bc2f1ac355f8ab949d2f5b15e26fbe4f049da1458b
+  metadata.gz: f484b23ae67a9dd0f0e5038f8de3e10b470478d631efea2a5da0f3d26fe393dd
+  data.tar.gz: a294f6023602b66ad54e99a39fa90024301964f39e7f6ca68fead5802095c289
 SHA512:
-  metadata.gz: dc41315bc958e50efdc1db906e998e9a6808410381be3ec70ffb0f9330b5520c89a5652fa0cf3e605caa237f52c8c5b05c9435d2a77fd08806664fdf769c56a9
-  data.tar.gz: 9937928ce2742fe22dd16317ea011984046a227782ea71b50c57b8c2d00e41534ae9f548ca8d14d2dc2a87a0fd42367462a75b56ea9e8678783c86ad0d57827a
+  metadata.gz: 508eee6aee771568c731d256b165500ea862d969e7d906f758cec61801b4a0d6963d431e86a808036c1be546448fb5b8e9207180e7625c165a6ea304ffa5994d
+  data.tar.gz: e4fd77e01b81307eb28af44959ad1974f4d8b4018e1d4d2923ae850c33569f313b0dbcf0124f279bd7312e74dcb0894ea79d472f4ea5be940f5fd5f634a2f22b

data/Gemfile

@@ -5,7 +5,12 @@ gemspec
 group :development do
   gem 'rake'
   gem 'rake-compiler'
-  gem 'rdoc'
+  if RUBY_ENGINE == 'jruby'
+    # RDoc 8 pulls in RBS 4, which attempts to build a native extension on JRuby.
+    gem 'rdoc', '< 8'
+  else
+    gem 'rdoc'
+  end
   gem 'test-unit'
   gem "test-unit-ruby-core"
 end

data/NEWS.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 6.0.6
+
+* Fix `-h` CLI option
+
+## 6.0.5
+
+* Avoid overridable method dispatch in the initialization guard
+
 ## 6.0.4
 
 * Prohibit `def_method` on marshal-loaded ERB instances
@@ -12,6 +20,10 @@
 
 * Freeze `src` in `ERB#initialize` for Ractor compatibility https://github.com/ruby/erb/pull/105
 
+## 6.0.1.1
+
+* Prohibit `def_method` on marshal-loaded ERB instances
+
 ## 6.0.1
 
 * Freeze `ERB::Compiler::TrimScanner::ERB_STAG` for Ractor compatibility
@@ -55,9 +67,17 @@
 * Drop `cgi` from runtime dependencies [#59](https://github.com/ruby/erb/pull/59)
 * Make `ERB::VERSION` public
 
+## 4.0.4.1
+
+* Prohibit `def_method` on marshal-loaded ERB instances
+
 ## 4.0.4
 
-* Skip building the C extension for JRuby [#52](https://github.com/ruby/erb/pull/52)
+* Skip building the C extension for JRuby
+
+## 4.0.3.1
+
+* Prohibit `def_method` on marshal-loaded ERB instances
 
 ## 4.0.3
 

data/README.md

@@ -8,14 +8,14 @@ ERB is commonly used to produce:
 - Customized or personalized web pages.
 - Software code (in code-generating applications).
 
-Like method [sprintf][sprintf], ERB can format run-time data into a string.
-ERB, however, is *much more powerful*
+Like method [`sprintf`][sprintf], ERB can format run-time data into a string.
+ERB, however, is *much more powerful*.
 
 ## How ERB Works
 
 Using ERB, you can create a *template*: a plain-text string that has specially-formatted *tags*,
 then store it into an ERB object;
-when ERB produces _result_ string, it:
+when ERB produces the _result_ string, it:
 
 - Inserts run-time-evaluated expressions into the result.
 - Executes snippets of Ruby code.
@@ -31,30 +31,32 @@ There are three types of tags:
 
 | Tag            |                 Form                 |                Action                 |    Text in Result    |
 |----------------|:------------------------------------:|:-------------------------------------:|:--------------------:|
-| Expression tag | <tt>'<%= _ruby_expression_ %>'</tt>  | Evaluates <tt>_ruby_expression_</tt>. | Value of expression. |       
-| Execution tag  |     <tt>'<% _ruby_code_ %>'</tt>     |     Execute <tt>_ruby_code_</tt>.     |        None.         |                 
-| Comment tag    |   <tt>'<%# _comment_text_ %>'</tt>   |                 None.                 |        None.         |
+| Expression tag |       `<%= ruby_expression %>`       |     Evaluates `ruby_expression`.      | Value of expression. |
+| Execution tag  |          `<% ruby_code %>`           |         Executes `ruby_code`.         |        None.         |
+| Comment tag    |        `<%# comment_text %>`         |                 None.                 |        None.         |
 
 These examples use `erb`, the ERB command-line interface;
 each "echoes" a string template and pipes it to `erb` as input:
 
 
 - Expression tag:
+    ```bash
+    $ echo "<%= \$VERBOSE %>" | erb
+    false
 
-        $ echo "<%= $VERBOSE %>" | erb
-        "false"
-        $ echo "<%= 2 + 2 %>" | erb
-        "4"
-
+    $ echo "<%= 2 + 2 %>" | erb
+    4
+    ```
 - Execution tag:
-
-        echo "<% if $VERBOSE %> Long message. <% else %> Short message. <% end %>" | erb
-        " Short message. "
-
+    ```bash
+    $ echo "<% if \$VERBOSE %> Long message. <% else %> Short message. <% end %>" | erb
+     Short message.
+    ```
 - Comment tag:
-
-        echo "<%# TODO: Fix this nonsense. %> Nonsense." | erb
-        " Nonsense."
+    ```bash
+    $ echo "<%# TODO: Fix this nonsense. %> Nonsense." | erb
+     Nonsense.
+    ```
 
 ## How to Use ERB
 
@@ -95,4 +97,4 @@ of the [2-Clause BSD License][2-clause bsd license].
 [ruby/erb]:             https://github.com/ruby/erb
 [ruby toolbox]:         https://www.ruby-toolbox.com/categories/template_engines
 [sprintf]:              https://docs.ruby-lang.org/en/master/Kernel.html#method-i-sprintf
-[template processor]:   https://en.wikipedia.org/wiki/Template_processor_
+[template processor]:   https://en.wikipedia.org/wiki/Template_processor

data/_doc/erb_executable.md

@@ -10,12 +10,10 @@ For a quick summary, type:
 $ erb --help
 ```
 
-The format of the command is
-`erb [_options_] [_filepaths_]`,
-where:
+The format of the command is `erb [options] [filepaths]`, where:
 
 - _options_ are zero or more [options][options].
-- _filepaths_ are zero or more paths to files, each containing an plain text
+- _filepaths_ are zero or more paths to files, each containing plain text
   that can include \ERB tags.
 
 ## Filepaths
@@ -27,10 +25,12 @@ that is, `erb` processes multiple files into a single result:
 $ cat t.erb
 <%= RUBY_VERSION %>
 <%= Time.now %>
+
 $ cat u.erb
 % Encoding.list.take(4).each do |encoding|
 * <%= encoding %>
 % end
+
 $ erb t.erb u.erb
 3.4.5
 2025-09-24 00:23:00 +0100
@@ -66,21 +66,22 @@ $ echo "<%= RUBY_VERSION %>" | erb # Prints the ERB version string.
 Use option `-d` or `--debug` to turn on debugging output:
 
 ```bash
-$ echo "<%= $DEBUG %>" | erb
-"false"
-$echo "<%= $DEBUG %>" | erb --debug
-"true"
+$ echo "<%= \$DEBUG %>" | erb
+false
+
+$ echo "<%= \$DEBUG %>" | erb --debug
+true
 ```
 
 ### `-E`, `--encoding`: Set Encodings
 
-Use option `-E` or `--encoding` to set the default external encoding to `_ex_`
-and, if `_in_` is given, to set the default internal encoding to `_in_`.
+Use option `-E ex[:in]` or `--encoding ex[:in]` to set the default external encoding to `ex` and,
+if `in` is given, to set the default internal encoding to `in`.
 
 Each encoding, `ex` and `in`, must be the name of an Encoding:
 
-```
-erb  -E ASCII-8BIT:ASCII-8BIT t.erb
+```bash
+$ erb -E ASCII-8BIT:ASCII-8BIT t.erb
 ```
 
 ### `-h`, `--help`: Print Help
@@ -100,6 +101,7 @@ with numbered lines:
 $ cat t.erb
 <%= RUBY_VERSION %>
 <%= Time.now %>
+
 $ erb -n -x t.erb
   1 #coding:UTF-8
   2 _erbout = +''; _erbout.<<(( RUBY_VERSION ).to_s); _erbout.<< "\n".freeze
@@ -119,11 +121,12 @@ $ erb -n t.erb
 
 By default, `erb` enables [execution tag shorthand][execution tag shorthand]:
 
-```
+```bash
 $ cat u.erb
 % Encoding.list.take(4).each do |encoding|
 * <%= encoding %>
 % end
+
 $ erb u.erb
 * ASCII-8BIT
 * UTF-8
@@ -133,7 +136,7 @@ $ erb u.erb
 
 You can use option `-P` to disable the shorthand:
 
-```
+```bash
 $ erb -P u.erb # Raises NameError: "undefined local variable or method 'encoding'"
 ```
 
@@ -142,7 +145,7 @@ $ erb -P u.erb # Raises NameError: "undefined local variable or method 'encoding
 You can use option `-r` to load a library;
 the option may be given multiple times, to load multiple libraries:
 
-```
+```bash
 $ erb -r csv -r bigdecimal t.erb
 ```
 
@@ -182,13 +185,14 @@ $ erb -U t.erb
 Use option `-v` to turn on verbose output:
 
 ```bash
-$ $ "<%= $VERBOSE %>" | erb
-"false"
-$ echo "<%= $VERBOSE %>" | erb -v
-"true"
+$ echo "<%= \$VERBOSE %>" | erb
+false
+
+$ echo "<%= \$VERBOSE %>" | erb -v
+true
 ```
 
-### `-v`: Print \ERB Version
+### `--version`: Print \ERB Version
 
 Use option `--version` to print the \ERB version string:
 
@@ -205,6 +209,7 @@ which is the Ruby code that is to be run when ERB#result is called:
 $ cat t.erb
 <%= RUBY_VERSION %>
 <%= Time.now %>
+
 $ erb -x t.erb
 #coding:UTF-8
 _erbout = +''; _erbout.<<(( RUBY_VERSION ).to_s); _erbout.<< "\n".freeze
@@ -230,11 +235,11 @@ The option may be given multiple times to set multiple variables:
 
 ```bash
 $ echo "<%= foo %> <%= bar %>" | erb foo=1 bar=2
-"1 2"
+1 2
 ```
 
 [erb.new]: https://docs.ruby-lang.org/en/master/ERB.html#method-c-new.
 [execution tag shorthand]: rdoc-ref:ERB@Shorthand+Format+for+Execution+Tags
 [options]: rdoc-ref:erb_executable.md@Options
 [suppressing unwanted blank lines]: rdoc-ref:ERB@Suppressing+Unwanted+Blank+Lines
-[suppressing unwanted newlines]: rdoc-ref:ERB@Suppressing+Unwanted+Newlines
+[suppressing unwanted newlines]: rdoc-ref:ERB@Suppressing+Unwanted+Newlines

data/lib/erb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 class ERB
   # The string \ERB version.
-  VERSION = '6.0.4'
+  VERSION = '6.0.6'
 end

data/lib/erb.rb

@@ -53,7 +53,7 @@ require 'erb/util'
 #
 # Here's how \ERB works:
 #
-# - You can create a *template*: a plain-text string that includes specially formatted *tags*..
+# - You can create a *template*: a plain-text string that includes specially formatted *tags*.
 # - You can create an \ERB object to store the template.
 # - You can call instance method ERB#result to get the *result*.
 #
@@ -63,10 +63,12 @@ require 'erb/util'
 #   each begins with `'<%='`, ends with `'%>'`; contains a Ruby expression;
 #   in the result, the value of the expression replaces the entire tag:
 #
-#         template = 'The magic word is <%= magic_word %>.'
-#         erb = ERB.new(template)
-#         magic_word = 'xyzzy'
-#         erb.result(binding) # => "The magic word is xyzzy."
+#     ```
+#     template = 'The magic word is <%= magic_word %>.'
+#     erb = ERB.new(template)
+#     magic_word = 'xyzzy'
+#     erb.result(binding) # => "The magic word is xyzzy."
+#     ```
 #
 #     The above call to #result passes argument `binding`,
 #     which contains the binding of variable `magic_word` to its string value `'xyzzy'`.
@@ -74,21 +76,27 @@ require 'erb/util'
 #     The below call to #result need not pass a binding,
 #     because its expression `Date::DAYNAMES` is globally defined.
 #
-#         ERB.new('Today is <%= Date::DAYNAMES[Date.today.wday] %>.').result # => "Today is Monday."
+#     ```
+#     ERB.new('Today is <%= Date::DAYNAMES[Date.today.wday] %>.').result # => "Today is Monday."
+#     ```
 #
 # - [Execution tags][execution tags]:
 #   each begins with `'<%'`, ends with `'%>'`; contains Ruby code to be executed:
 #
-#          template = '<% File.write("t.txt", "Some stuff.") %>'
-#          ERB.new(template).result
-#          File.read('t.txt') # => "Some stuff."
+#     ```
+#     template = '<% File.write("t.txt", "Some stuff.") %>'
+#     ERB.new(template).result
+#     File.read('t.txt') # => "Some stuff."
+#     ```
 #
 # - [Comment tags][comment tags]:
 #   each begins with `'<%#'`, ends with `'%>'`; contains comment text;
 #   in the result, the entire tag is omitted.
 #
-#          template = 'Some stuff;<%# Note to self: figure out what the stuff is. %> more stuff.'
-#          ERB.new(template).result # => "Some stuff; more stuff."
+#     ```
+#     template = 'Some stuff;<%# Note to self: figure out what the stuff is. %> more stuff.'
+#     ERB.new(template).result # => "Some stuff; more stuff."
+#     ```
 #
 # ## Some Simple Examples
 #
@@ -106,11 +114,10 @@ require 'erb/util'
 # 1. A plain-text string is assigned to variable `template`.
 #    Its embedded [expression tag][expression tags] `'<%= Time.now %>'` includes a Ruby expression, `Time.now`.
 # 2. The string is put into a new \ERB object, and stored in variable `erb`.
-# 4. Method call `erb.result` generates a string that contains the run-time value of `Time.now`,
+# 3. Method call `erb.result` generates a string that contains the run-time value of `Time.now`,
 #    as computed at the time of the call.
 #
-# The
-# \ERB object may be re-used:
+# The \ERB object may be re-used:
 #
 # ```
 # erb.result
@@ -148,14 +155,14 @@ require 'erb/util'
 # ## Bindings
 #
 # A call to method #result, which produces the formatted result string,
-# requires a [Binding object][binding object] as its argument.
+# requires a [`Binding` object][binding object] as its argument.
 #
 # The binding object provides the bindings for expressions in [expression tags][expression tags].
 #
 # There are three ways to provide the required binding:
 #
-# - [Default binding][default binding].
-# - [Local binding][local binding].
+# - [Default binding][default binding]
+# - [Local binding][local binding]
 # - [Augmented binding][augmented binding]
 #
 # ### Default Binding
@@ -174,6 +181,9 @@ require 'erb/util'
 # The current process is <%= $0 %>.
 # TEMPLATE
 # puts ERB.new(template).result
+# ```
+#
+# ```
 # The Ruby copyright is "ruby - Copyright (C) 1993-2025 Yukihiro Matsumoto".
 # The current process is irb.
 # ```
@@ -183,7 +193,7 @@ require 'erb/util'
 # ### Local Binding
 #
 # The default binding is *not* sufficient for an expression
-# that refers to a a constant or variable that is not defined there:
+# that refers to a constant or variable that is not defined there:
 #
 # ```
 # Foo = 1 # Defines local constant Foo.
@@ -209,6 +219,9 @@ require 'erb/util'
 #
 # ```
 # puts erb.result(binding)
+# ```
+#
+# ```
 # The current value of constant Foo is 1.
 # The current value of variable foo is 2.
 # The Ruby copyright is "ruby - Copyright (C) 1993-2025 Yukihiro Matsumoto".
@@ -246,6 +259,9 @@ require 'erb/util'
 # ```
 # hash = {bar: 3, baz: 4}
 # puts erb.result_with_hash(hash)
+# ```
+#
+# ```
 # The current value of variable bar is 3.
 # The current value of variable baz is 4.
 # The Ruby copyright is "ruby - Copyright (C) 1993-2025 Yukihiro Matsumoto".
@@ -268,7 +284,7 @@ require 'erb/util'
 #
 # You can embed a Ruby expression in a template using an *expression tag*.
 #
-# Its syntax is `<%= _expression_ %>`,
+# Its syntax is `<%= expression %>`,
 # where *expression* is any valid Ruby expression.
 #
 # When you call method #result,
@@ -298,7 +314,7 @@ require 'erb/util'
 #
 # You can embed Ruby executable code in template using an *execution tag*.
 #
-# Its syntax is `<% _code_ %>`,
+# Its syntax is `<% code %>`,
 # where *code* is any valid Ruby code.
 #
 # When you call method #result,
@@ -306,17 +322,17 @@ require 'erb/util'
 # (generating no text in the result):
 #
 # ```
-# ERB.new('foo <% Dir.chdir("C:/") %> bar').result # => "foo  bar"
+# ERB.new('foo <% Dir.chdir(Dir.pwd) %> bar').result # => "foo  bar"
 # ```
 #
 # Whitespace before and after the embedded code is optional:
 #
 # ```
-# ERB.new('foo <%Dir.chdir("C:/")%> bar').result   # => "foo  bar"
+# ERB.new('foo <%Dir.chdir(Dir.pwd)%> bar').result   # => "foo  bar"
 # ```
 #
 # You can interleave text with execution tags to form a control structure
-# such as a conditional, a loop, or a `case` statements.
+# such as a conditional, a loop, or a `case` statement.
 #
 # Conditional:
 #
@@ -386,7 +402,7 @@ require 'erb/util'
 # #### Shorthand Format for Execution Tags
 #
 # You can use keyword argument `trim_mode: '%'` to enable a shorthand format for execution tags;
-# this example uses the shorthand format `% _code_` instead of `<% _code_ %>`:
+# this example uses the shorthand format `% code` instead of `<% code %>`:
 #
 # ```
 # template = <<TEMPLATE
@@ -399,6 +415,9 @@ require 'erb/util'
 #                'Document Modules',
 #                'Answer Questions on Ruby Talk' ]
 # puts erb.result(binding)
+# ```
+#
+# ```
 #   * Run Ruby Quiz
 #   * Document Modules
 #   * Answer Questions on Ruby Talk
@@ -419,12 +438,15 @@ require 'erb/util'
 # <% end %>
 # TEMPLATE
 # ERB.new(template).result.lines.each {|line| puts line.inspect }
+# ```
+#
+# ```
 # "\n"
 # "3.4.5\n"
 # "\n"
 # ```
 #
-# You can give `trim_mode: '-'`, you can suppress each blank line
+# If you give `trim_mode: '-'`, you can suppress each blank line
 # whose source line ends with `-%>` (instead of `%>`):
 #
 # ```
@@ -434,6 +456,9 @@ require 'erb/util'
 # <% end -%>
 # TEMPLATE
 # ERB.new(template, trim_mode: '-').result.lines.each {|line| puts line.inspect }
+# ```
+#
+# ```
 # "3.4.5\n"
 # ```
 #
@@ -460,6 +485,9 @@ require 'erb/util'
 #
 # ```
 # ERB.new(template).result.lines.each {|line| puts line.inspect }
+# ```
+#
+# ```
 # "\n"
 # "3.4.5\n"
 # "foo \n"
@@ -471,6 +499,9 @@ require 'erb/util'
 #
 # ```
 # ERB.new(template, trim_mode: '>').result.lines.each {|line| puts line.inspect }
+# ```
+#
+# ```
 # "3.4.5foo foo 3.4.5"
 # ```
 #
@@ -479,6 +510,9 @@ require 'erb/util'
 #
 # ```
 # ERB.new(template, trim_mode: '<>').result.lines.each {|line| puts line.inspect }
+# ```
+#
+# ```
 # "3.4.5foo \n"
 # "foo 3.4.5\n"
 # ```
@@ -494,7 +528,7 @@ require 'erb/util'
 # ### Comment Tags
 #
 # You can embed a comment in a template using a *comment tag*;
-# its syntax is `<%# _text_ %>`,
+# its syntax is `<%# text %>`,
 # where *text* is the text of the comment.
 #
 # When you call method #result,
@@ -570,7 +604,7 @@ require 'erb/util'
 # erb.filename # => nil
 # erb.lineno   # => 0
 # erb.result
-# (erb):1:in '<main>': undefined local variable or method 'nosuch' for main (NameError)
+# # => (erb):1:in '<main>': undefined local variable or method 'nosuch' for main (NameError)
 # ```
 #
 # You can use methods #filename= and #lineno= to assign values
@@ -580,7 +614,7 @@ require 'erb/util'
 # erb.filename = 't.txt'
 # erb.lineno = 555
 # erb.result
-# t.txt:556:in '<main>': undefined local variable or method 'nosuch' for main (NameError)
+# # => t.txt:556:in '<main>': undefined local variable or method 'nosuch' for main (NameError)
 # ```
 #
 # You can use method #location= to set both values:
@@ -588,7 +622,7 @@ require 'erb/util'
 # ```
 # erb.location = ['u.txt', 999]
 # erb.result
-# u.txt:1000:in '<main>': undefined local variable or method 'nosuch' for main (NameError)
+# # => u.txt:1000:in '<main>': undefined local variable or method 'nosuch' for main (NameError)
 # ```
 #
 # ## Plain Text with Embedded Ruby
@@ -632,12 +666,14 @@ require 'erb/util'
 #                'Answer Questions on Ruby Talk' ]
 # ```
 #
-# Finally, create the \ERB object and get the result
+# Finally, create the \ERB object and get the result:
 #
 # ```
 # erb = ERB.new(template, trim_mode: '%<>')
 # puts erb.result(binding)
+# ```
 #
+# ```
 # From:  James Edward Gray II <james@grayproductions.net>
 # To:  Community Spokesman <spokesman@ruby_community.org>
 # Subject:  Addressing Needs
@@ -683,7 +719,6 @@ require 'erb/util'
 #   def get_binding
 #     binding
 #   end
-#
 # end
 # ```
 #
@@ -693,8 +728,7 @@ require 'erb/util'
 # toy = Product.new('TZ-1002',
 #                   'Rubysapien',
 #                   "Geek's Best Friend!  Responds to Ruby commands...",
-#                   999.95
-#                   )
+#                   999.95)
 # toy.add_feature('Listens for verbal commands in the Ruby language!')
 # toy.add_feature('Ignores Perl, Java, and all C variants.')
 # toy.add_feature('Karate-Chop Action!!!')
@@ -733,6 +767,9 @@ require 'erb/util'
 # ```
 # erb = ERB.new(template)
 # puts erb.result(toy.get_binding)
+# ```
+#
+# ```html
 # <html>
 #   <head><title>Ruby Toys -- Rubysapien</title></head>
 #   <body>
@@ -758,7 +795,7 @@ require 'erb/util'
 # Various Ruby projects have their own template processors.
 # The Ruby Processing System [RDoc][rdoc], for example, has one that can be used elsewhere.
 #
-# Other popular template processors may found in the [Template Engines][template engines] page
+# Other popular template processors may be found in the [Template Engines][template engines] page
 # of the Ruby Toolbox.
 #
 # [%q literals]: https://docs.ruby-lang.org/en/master/syntax/literals_rdoc.html#label-25q-3A+Non-Interpolable+String+Literals
@@ -778,6 +815,9 @@ require 'erb/util'
 # [template processor]: https://en.wikipedia.org/wiki/Template_processor
 #
 class ERB
+  IDENTITY_METHOD = BasicObject.instance_method(:equal?) # :nodoc:
+  private_constant :IDENTITY_METHOD
+
   # :markup: markdown
   #
   # :call-seq:
@@ -793,7 +833,7 @@ class ERB
   # :call-seq:
   #   ERB.new(template, trim_mode: nil, eoutvar: '_erbout')
   #
-  # Returns a new \ERB object containing the given string +template+.
+  # Returns a new \ERB object containing the given string `template`.
   #
   # For details about `template`, its embedded tags, and generated results, see ERB.
   #
@@ -874,13 +914,16 @@ class ERB
   # In a more readable format:
   #
   # ```
-  #   # puts erb.src.split('; ')
-  #   # #coding:UTF-8
-  #   # _erbout = +''
-  #   # _erbout.<< "The time is ".freeze
-  #   # _erbout.<<(( Time.now ).to_s)
-  #   # _erbout.<< ".".freeze
-  #   # _erbout
+  # puts erb.src.split('; ')
+  # ```
+  #
+  # ```
+  # #coding:UTF-8
+  # _erbout = +''
+  # _erbout.<< "The time is ".freeze
+  # _erbout.<<(( Time.now ).to_s)
+  # _erbout.<< ".".freeze
+  # _erbout
   # ```
   #
   # Variable `_erbout` is used to store the intermediate results in the code;
@@ -889,7 +932,10 @@ class ERB
   #
   # ```
   # erb = ERB.new(template, eoutvar: '_foo')
-  # puts template.src.split('; ')
+  # puts erb.src.split('; ')
+  # ```
+  #
+  # ```
   # #coding:UTF-8
   # _foo = +''
   # _foo.<< "The time is ".freeze
@@ -952,6 +998,9 @@ class ERB
   # template = ERB.new('')
   # compiler = template.make_compiler(nil)
   # pp compiler
+  # ```
+  #
+  # ```
   # #<ERB::Compiler:0x000001cff8a9aa00
   #  @insert_cmd="print",
   #  @percent=false,
@@ -959,8 +1008,14 @@ class ERB
   #  @pre_cmd=[],
   #  @put_cmd="print",
   #  @trim_mode=nil>
+  # ```
+  #
+  # ```
   # template.set_eoutvar(compiler, '_foo') # => ["_foo"]
   # pp compiler
+  # ```
+  #
+  # ```
   # #<ERB::Compiler:0x000001cff8a9aa00
   #  @insert_cmd="_foo.<<",
   #  @percent=false,
@@ -1007,7 +1062,7 @@ class ERB
   # [local binding]: rdoc-ref:ERB@Local+Binding
   #
   def result(b=new_toplevel)
-    unless @_init.equal?(self.class.singleton_class)
+    unless initialized_by_new?
       raise ArgumentError, "not initialized"
     end
     eval(@src, b, (@filename || '(erb)'), @lineno)
@@ -1061,6 +1116,11 @@ class ERB
   end
   private :new_toplevel
 
+  def initialized_by_new? # :nodoc:
+    IDENTITY_METHOD.bind_call(@_init, self.class.singleton_class)
+  end
+  private :initialized_by_new?
+
   # :markup: markdown
   #
   # :call-seq:
@@ -1083,11 +1143,12 @@ class ERB
   # MyModule = Module.new
   # erb.def_method(MyModule, 'render(arg1, arg2)') # => :render
   # class MyClass; include MyModule; end
-  # MyClass.new.render('foo', 123)                      # => "foo 123"
+  # MyClass.new.render('foo', 123)
+  # # => "foo 123"
   # ```
   #
   def def_method(mod, methodname, fname='(ERB)')
-    unless @_init.equal?(self.class.singleton_class)
+    unless initialized_by_new?
       raise ArgumentError, "not initialized"
     end
     src = self.src.sub(/^(?!#|$)/) {"def #{methodname}\n"} << "\nend\n"
@@ -1106,7 +1167,7 @@ class ERB
   # ```
   # template = '<%= arg1 %> <%= arg2 %>'
   # erb = ERB.new(template)
-  # MyModule = template.def_module('render(arg1, arg2)')
+  # MyModule = erb.def_module('render(arg1, arg2)')
   # class MyClass
   #   include MyModule
   # end
@@ -1163,6 +1224,9 @@ class ERB
   #
   # ```
   # puts MySubClass.new('foo', 123).render
+  # ```
+  #
+  # ```html
   # <html>
   # <body>
   #   <p>foo</p>

data/libexec/erb

@@ -89,7 +89,7 @@ class ERB
             set_encoding(Encoding::UTF_8, Encoding::UTF_8)
           when '-P'
             disable_percent = true
-          when '--help'
+          when '-h', '--help'
             raise ''
           when /\A-/
             raise "Unknown switch: #{switch.dump}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: erb
 version: !ruby/object:Gem::Version
-  version: 6.0.4
+  version: 6.0.6
 platform: ruby
 authors:
 - Masatoshi SEKI
@@ -50,7 +50,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ruby/erb
   source_code_uri: https://github.com/ruby/erb
-  changelog_uri: https://github.com/ruby/erb/blob/v6.0.4/NEWS.md
+  changelog_uri: https://github.com/ruby/erb/blob/v6.0.6/NEWS.md
 rdoc_options: []
 require_paths:
 - lib