rbs 4.0.0.dev.5 → 4.0.1.dev.1

data/src/util/rbs_constant_pool.c

@@ -95,10 +95,6 @@ rbs_constant_pool_resize(rbs_constant_pool_t *pool) {
     return true;
 }
 
-// This storage is initialized by `Init_rbs_extension()` in `main.c`.
-static rbs_constant_pool_t RBS_GLOBAL_CONSTANT_POOL_STORAGE = { 0 };
-rbs_constant_pool_t *RBS_GLOBAL_CONSTANT_POOL = &RBS_GLOBAL_CONSTANT_POOL_STORAGE;
-
 /**
  * Initialize a new constant pool with a given capacity.
  */

data/stdlib/bigdecimal/0/big_decimal.rbs

@@ -1278,7 +1278,7 @@ class Integer
   #     4 / Complex(3, 0)  # => ((4/3)+0i)
   #
   def /: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=numeric.c
@@ -1294,7 +1294,7 @@ class Integer
   #     4 * Complex(2, 0)  # => (8+0i)
   #
   def *: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=numeric.c
@@ -1314,7 +1314,7 @@ class Integer
   #     1 + 3.14           # => 4.140000000000001
   #
   def +: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=numeric.c
@@ -1330,7 +1330,7 @@ class Integer
   #     4 - Complex(2, 0)  # => (2+0i)
   #
   def -: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 end
 
 %a{annotate:rdoc:skip}
@@ -1369,7 +1369,7 @@ class Float
   #     f / Complex(2, 0)  # => (1.57+0.0i)
   #
   def /: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=numeric.c
@@ -1384,7 +1384,7 @@ class Float
   #     f * Complex(2, 0)  # => (6.28+0.0i)
   #
   def *: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=numeric.c
@@ -1404,7 +1404,7 @@ class Float
   #     3.14 + Rational(1, 1)  # => 4.140000000000001
   #
   def +: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=numeric.c
@@ -1419,7 +1419,7 @@ class Float
   #     f - Complex(1, 0)     # => (2.14+0i)
   #
   def -: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 end
 
 %a{annotate:rdoc:skip}
@@ -1476,7 +1476,7 @@ class Rational
   #     Rational(20, 9) / 9.8              #=> 0.22675736961451246
   #
   def /: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=rational.c
@@ -1492,7 +1492,7 @@ class Rational
   #     Rational(-2, 9) * Rational(-9, 2) #=> (1/1)
   #
   def *: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=rational.c
@@ -1517,7 +1517,7 @@ class Rational
   #     Rational(2, 3) + Complex(1.0, 0.0) # => (1.6666666666666665+0.0i)
   #
   def +: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=rational.c
@@ -1532,7 +1532,7 @@ class Rational
   #     Rational(20, 9) - 9.8              #=> -7.577777777777778
   #
   def -: (BigDecimal) -> BigDecimal
-    | ...
+       | ...
 end
 
 %a{annotate:rdoc:skip}
@@ -1571,7 +1571,7 @@ class Complex
   #     Complex.rect(20, 9) / 9.8                 # => (2.0408163265306123+0.9183673469387754i)
   #
   def /: (BigDecimal) -> Complex
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=complex.c
@@ -1587,7 +1587,7 @@ class Complex
   #     Complex.rect(9, 8)  * Rational(2, 3)      # => ((6/1)+(16/3)*i)
   #
   def *: (BigDecimal) -> Complex
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=complex.c
@@ -1612,7 +1612,7 @@ class Complex
   #     Complex(1, 2) + 3.14 # => (4.140000000000001+2i)
   #
   def +: (BigDecimal) -> Complex
-    | ...
+       | ...
 
   # <!--
   #   rdoc-file=complex.c
@@ -1627,7 +1627,7 @@ class Complex
   #     Complex.rect(20, 9) - 9.8                 # => (10.2+9i)
   #
   def -: (BigDecimal) -> Complex
-    | ...
+       | ...
 end
 
 %a{annotate:rdoc:skip}

data/stdlib/cgi-escape/0/escape.rbs

@@ -25,7 +25,7 @@ class CGI
     #   - escape(string)
     # -->
     # URL-encode a string into application/x-www-form-urlencoded. Space characters
-    # (`" "`) are encoded with plus signs (`"+"`)
+    # (<code>" "</code>) are encoded with plus signs (<code>"+"</code>)
     #     url_encoded_string = CGI.escape("'Stop!' said Fred")
     #        # => "%27Stop%21%27+said+Fred"
     #
@@ -55,7 +55,7 @@ class CGI
     #   rdoc-file=lib/cgi/escape.rb
     #   - escapeHTML(string)
     # -->
-    # Escape special characters in HTML, namely `'&\"<>`
+    # Escape special characters in HTML, namely <code>'&\"<></code>
     #     CGI.escapeHTML('Usage: foo "bar" <baz>')
     #        # => "Usage: foo &quot;bar&quot; &lt;baz&gt;"
     #
@@ -65,8 +65,8 @@ class CGI
     #   rdoc-file=lib/cgi/escape.rb
     #   - escapeURIComponent(string)
     # -->
-    # URL-encode a string following RFC 3986 Space characters (`" "`) are encoded
-    # with (`"%20"`)
+    # URL-encode a string following RFC 3986 Space characters (<code>" "</code>) are
+    # encoded with (<code>"%20"</code>)
     #     url_encoded_string = CGI.escapeURIComponent("'Stop!' said Fred")
     #        # => "%27Stop%21%27%20said%20Fred"
     #

data/stdlib/coverage/0/coverage.rbs

@@ -159,7 +159,7 @@ module Coverage
   #   - Coverage.peek_result  => hash
   # -->
   # Returns a hash that contains filename as key and coverage array as value. This
-  # is the same as `Coverage.result(stop: false, clear: false)`.
+  # is the same as <code>Coverage.result(stop: false, clear: false)</code>.
   #
   #     {
   #       "file.rb" => [1, 2, nil],
@@ -244,8 +244,9 @@ module Coverage
   # -->
   # Returns true if coverage measurement is supported for the given mode.
   #
-  # The mode should be one of the following symbols: `:lines`, `:oneshot_lines`,
-  # `:branches`, `:methods`, `:eval`.
+  # The mode should be one of the following symbols: <code>:lines</code>,
+  # <code>:oneshot_lines</code>, <code>:branches</code>, <code>:methods</code>,
+  # <code>:eval</code>.
   #
   # Example:
   #

data/stdlib/date/0/date.rbs

@@ -165,8 +165,8 @@ class Date
   #
   #     Date._parse('2001-02-03') # => {:year=>2001, :mon=>2, :mday=>3}
   #
-  # If `comp` is `true` and the given year is in the range `(0..99)`, the current
-  # century is supplied; otherwise, the year is taken as given:
+  # If `comp` is `true` and the given year is in the range <code>(0..99)</code>,
+  # the current century is supplied; otherwise, the year is taken as given:
   #
   #     Date._parse('01-02-03', true)  # => {:year=>2001, :mon=>2, :mday=>3}
   #     Date._parse('01-02-03', false) # => {:year=>1, :mon=>2, :mday=>3}
@@ -508,8 +508,8 @@ class Date
   #     Date.parse('20010203')     # => #<Date: 2001-02-03>
   #     Date.parse('3rd Feb 2001') # => #<Date: 2001-02-03>
   #
-  # If `comp` is `true` and the given year is in the range `(0..99)`, the current
-  # century is supplied; otherwise, the year is taken as given:
+  # If `comp` is `true` and the given year is in the range <code>(0..99)</code>,
+  # the current century is supplied; otherwise, the year is taken as given:
   #
   #     Date.parse('01-02-03', true)  # => #<Date: 2001-02-03>
   #     Date.parse('01-02-03', false) # => #<Date: 0001-02-03>
@@ -800,7 +800,7 @@ class Date
   # -->
   # Compares `self` and `other`, returning:
   #
-  # *   `-1` if `other` is larger.
+  # *   <code>-1</code> if `other` is larger.
   # *   `0` if the two are equal.
   # *   `1` if `other` is smaller.
   # *   `nil` if the two are incomparable.
@@ -822,7 +822,7 @@ class Date
   #         d <=> DateTime.new(2022, 7, 27) # => 0
   #         d <=> DateTime.new(2022, 7, 28) # => -1
   #
-  # *   A numeric (compares `self.ajd` to `other`):
+  # *   A numeric (compares <code>self.ajd</code> to `other`):
   #
   #         d <=> 2459788 # => -1
   #         d <=> 2459787 # => 1
@@ -859,7 +859,7 @@ class Date
   #         d === DateTime.new(2022, 7, 27) # => true
   #         d === DateTime.new(2022, 7, 28) # => false
   #
-  # *   A numeric (compares `self.jd` to `other`):
+  # *   A numeric (compares <code>self.jd</code> to `other`):
   #
   #         d === 2459788 # => true
   #         d === 2459787 # => false
@@ -928,9 +928,10 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - asctime -> string
   # -->
-  # Equivalent to #strftime with argument `'%a %b %e %T %Y'` (or its [shorthand
+  # Equivalent to #strftime with argument <code>'%a %b %e %T %Y'</code> (or its
+  # [shorthand
   # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
-  # rs) `'%c'`):
+  # rs) <code>'%c'</code>):
   #
   #     Date.new(2001, 2, 3).asctime # => "Sat Feb  3 00:00:00 2001"
   #
@@ -939,9 +940,10 @@ class Date
   def asctime: () -> String
 
   # <!-- rdoc-file=ext/date/date_core.c -->
-  # Equivalent to #strftime with argument `'%a %b %e %T %Y'` (or its [shorthand
+  # Equivalent to #strftime with argument <code>'%a %b %e %T %Y'</code> (or its
+  # [shorthand
   # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
-  # rs) `'%c'`):
+  # rs) <code>'%c'</code>):
   #
   #     Date.new(2001, 2, 3).asctime # => "Sat Feb  3 00:00:00 2001"
   #
@@ -993,7 +995,8 @@ class Date
   #   - deconstruct_keys(array_of_names_or_nil) -> hash
   # -->
   # Returns a hash of the name/value pairs, to use in pattern matching. Possible
-  # keys are: `:year`, `:month`, `:day`, `:wday`, `:yday`.
+  # keys are: <code>:year</code>, <code>:month</code>, <code>:day</code>,
+  # <code>:wday</code>, <code>:yday</code>.
   #
   # Possible usages:
   #
@@ -1026,7 +1029,7 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - downto(min){|date| ... } -> self
   # -->
-  # Equivalent to #step with arguments `min` and `-1`.
+  # Equivalent to #step with arguments `min` and <code>-1</code>.
   #
   def downto: (Date min) { (Date) -> untyped } -> Date
             | (Date min) -> Enumerator[Date, Date]
@@ -1071,8 +1074,8 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - httpdate -> string
   # -->
-  # Equivalent to #strftime with argument `'%a, %d %b %Y %T GMT'`; see [Formats
-  # for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
+  # Equivalent to #strftime with argument <code>'%a, %d %b %Y %T GMT'</code>; see
+  # [Formats for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   #     Date.new(2001, 2, 3).httpdate # => "Sat, 03 Feb 2001 00:00:00 GMT"
   #
@@ -1093,9 +1096,10 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - iso8601    ->  string
   # -->
-  # Equivalent to #strftime with argument `'%Y-%m-%d'` (or its [shorthand
+  # Equivalent to #strftime with argument <code>'%Y-%m-%d'</code> (or its
+  # [shorthand
   # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
-  # rs) `'%F'`);
+  # rs) <code>'%F'</code>);
   #
   #     Date.new(2001, 2, 3).iso8601 # => "2001-02-03"
   #
@@ -1268,7 +1272,7 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - next_year(n = 1) -> new_date
   # -->
-  # Equivalent to #>> with argument `n * 12`.
+  # Equivalent to #>> with argument <code>n * 12</code>.
   #
   def next_year: (?Integer year) -> Date
 
@@ -1292,7 +1296,7 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - prev_year(n = 1) -> new_date
   # -->
-  # Equivalent to #<< with argument `n * 12`.
+  # Equivalent to #<< with argument <code>n * 12</code>.
   #
   def prev_year: (?Integer year) -> Date
 
@@ -1300,8 +1304,8 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - rfc2822 -> string
   # -->
-  # Equivalent to #strftime with argument `'%a, %-d %b %Y %T %z'`; see [Formats
-  # for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
+  # Equivalent to #strftime with argument <code>'%a, %-d %b %Y %T %z'</code>; see
+  # [Formats for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   #     Date.new(2001, 2, 3).rfc2822 # => "Sat, 3 Feb 2001 00:00:00 +0000"
   #
@@ -1311,8 +1315,8 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - rfc3339 -> string
   # -->
-  # Equivalent to #strftime with argument `'%FT%T%:z'`; see [Formats for Dates and
-  # Times](rdoc-ref:language/strftime_formatting.rdoc):
+  # Equivalent to #strftime with argument <code>'%FT%T%:z'</code>; see [Formats
+  # for Dates and Times](rdoc-ref:language/strftime_formatting.rdoc):
   #
   #     Date.new(2001, 2, 3).rfc3339 # => "2001-02-03T00:00:00+00:00"
   #
@@ -1373,8 +1377,8 @@ class Date
   # Calls the block with specified dates; returns `self`.
   #
   # *   The first `date` is `self`.
-  # *   Each successive `date` is `date + step`, where `step` is the numeric step
-  #     size in days.
+  # *   Each successive `date` is <code>date + step</code>, where `step` is the
+  #     numeric step size in days.
   # *   The last date is the last one that is before or equal to `limit`, which
   #     should be a Date object.
   #
@@ -1462,7 +1466,7 @@ class Date
   # Returns a string representation of the date in `self` in [ISO 8601 extended
   # date
   # format](rdoc-ref:language/strftime_formatting.rdoc@ISO+8601+Format+Specificati
-  # ons) (`'%Y-%m-%d'`):
+  # ons) (<code>'%Y-%m-%d'</code>):
   #
   #     Date.new(2001, 2, 3).to_s # => "2001-02-03"
   #
@@ -1516,9 +1520,10 @@ class Date
   def wednesday?: () -> bool
 
   # <!-- rdoc-file=ext/date/date_core.c -->
-  # Equivalent to #strftime with argument `'%Y-%m-%d'` (or its [shorthand
+  # Equivalent to #strftime with argument <code>'%Y-%m-%d'</code> (or its
+  # [shorthand
   # form](rdoc-ref:language/strftime_formatting.rdoc@Shorthand+Conversion+Specifie
-  # rs) `'%F'`);
+  # rs) <code>'%F'</code>);
   #
   #     Date.new(2001, 2, 3).iso8601 # => "2001-02-03"
   #

data/stdlib/date/0/date_time.rbs

@@ -24,10 +24,10 @@
 #                         #=> #<DateTime: 2001-02-03T12:00:00+00:00 ...>
 #
 # An optional argument, the offset, indicates the difference between the local
-# time and UTC. For example, `Rational(3,24)` represents ahead of 3 hours of
-# UTC, `Rational(-5,24)` represents behind of 5 hours of UTC. The offset should
-# be -1 to +1, and its precision is assumed at most second. The default value is
-# zero (equals to UTC).
+# time and UTC. For example, <code>Rational(3,24)</code> represents ahead of 3
+# hours of UTC, <code>Rational(-5,24)</code> represents behind of 5 hours of
+# UTC. The offset should be -1 to +1, and its precision is assumed at most
+# second. The default value is zero (equals to UTC).
 #
 #     DateTime.new(2001,2,3,4,5,6,Rational(3,24))
 #                         #=> #<DateTime: 2001-02-03T04:05:06+03:00 ...>
@@ -39,7 +39,7 @@
 #
 # An optional argument, the day of calendar reform (`start`), denotes a Julian
 # day number, which should be 2298874 to 2426355 or negative/positive infinity.
-# The default value is `Date::ITALY` (2299161=1582-10-15).
+# The default value is <code>Date::ITALY</code> (2299161=1582-10-15).
 #
 # A DateTime object has various methods. See each reference.
 #
@@ -183,8 +183,8 @@ class DateTime < Date
   #                               #=> #<DateTime: 2001-02-03T04:05:06+00:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.httpdate: (String str, ?Integer start) -> DateTime
 
@@ -203,8 +203,8 @@ class DateTime < Date
   #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.iso8601: (String str, ?Integer start) -> DateTime
 
@@ -237,8 +237,8 @@ class DateTime < Date
   #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.jisx0301: (String str, ?Integer start) -> DateTime
 
@@ -288,8 +288,8 @@ class DateTime < Date
   #                               #=> #<DateTime: 2001-02-03T16:05:06+00:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.parse: (String str, ?boolish complete, ?Integer start) -> DateTime
 
@@ -305,8 +305,8 @@ class DateTime < Date
   #                              #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.rfc2822: (String str, ?Integer start) -> DateTime
 
@@ -321,8 +321,8 @@ class DateTime < Date
   #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.rfc3339: (String str, ?Integer start) -> DateTime
 
@@ -338,8 +338,8 @@ class DateTime < Date
   #                              #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.rfc822: (String str, ?Integer start) -> DateTime
 
@@ -383,8 +383,8 @@ class DateTime < Date
   #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
   #
   # Raise an ArgumentError when the string length is longer than *limit*. You can
-  # stop this check by passing `limit: nil`, but note that it may take a long time
-  # to parse.
+  # stop this check by passing <code>limit: nil</code>, but note that it may take
+  # a long time to parse.
   #
   def self.xmlschema: (String str, ?Integer start) -> DateTime
 
@@ -393,8 +393,9 @@ class DateTime < Date
   #   - deconstruct_keys(array_of_names_or_nil) -> hash
   # -->
   # Returns a hash of the name/value pairs, to use in pattern matching. Possible
-  # keys are: `:year`, `:month`, `:day`, `:wday`, `:yday`, `:hour`, `:min`,
-  # `:sec`, `:sec_fraction`, `:zone`.
+  # keys are: <code>:year</code>, <code>:month</code>, <code>:day</code>,
+  # <code>:wday</code>, <code>:yday</code>, <code>:hour</code>, <code>:min</code>,
+  # <code>:sec</code>, <code>:sec_fraction</code>, <code>:zone</code>.
   #
   # Possible usages:
   #

data/stdlib/did_you_mean/0/did_you_mean.rbs

@@ -38,7 +38,7 @@
 #
 # Occasionally, you may want to disable the `did_you_mean` gem for e.g.
 # debugging issues in the error object itself. You can disable it entirely by
-# specifying `--disable-did_you_mean` option to the `ruby` command:
+# specifying <code>--disable-did_you_mean</code> option to the `ruby` command:
 #
 #     $ ruby --disable-did_you_mean -e "1.zeor?"
 #     -e:1:in `<main>': undefined method `zeor?' for 1:Integer (NameError)
@@ -55,7 +55,7 @@
 #
 # Sometimes, you do not want to disable the gem entirely, but need to get the
 # original error message without suggestions (e.g. testing). In this case, you
-# could use the `#original_message` method on the error object:
+# could use the <code>#original_message</code> method on the error object:
 #
 #     no_method_error = begin
 #                         1.zeor?
@@ -92,9 +92,9 @@ module DidYouMean
   end
 
   # <!-- rdoc-file=lib/did_you_mean/formatter.rb -->
-  # The `DidYouMean::Formatter` is the basic, default formatter for the gem. The
-  # formatter responds to the `message_for` method and it returns a human readable
-  # string.
+  # The <code>DidYouMean::Formatter</code> is the basic, default formatter for the
+  # gem. The formatter responds to the `message_for` method and it returns a human
+  # readable string.
   #
   class Formatter
     # <!--
@@ -170,15 +170,16 @@ module DidYouMean
     NAMES_TO_EXCLUDE: Hash[untyped, Array[Symbol]]
 
     # <!-- rdoc-file=lib/did_you_mean/spell_checkers/method_name_checker.rb -->
-    # `MethodNameChecker::RB_RESERVED_WORDS` is the list of reserved words in Ruby
-    # that take an argument. Unlike `VariableNameChecker::RB_RESERVED_WORDS`, these
-    # reserved words require an argument, and a `NoMethodError` is raised due to the
-    # presence of the argument.
+    # <code>MethodNameChecker::RB_RESERVED_WORDS</code> is the list of reserved
+    # words in Ruby that take an argument. Unlike
+    # <code>VariableNameChecker::RB_RESERVED_WORDS</code>, these reserved words
+    # require an argument, and a `NoMethodError` is raised due to the presence of
+    # the argument.
     #
     # The `MethodNameChecker` will use this list to suggest a reversed word if a
     # `NoMethodError` is raised and found closest matches.
     #
-    # Also see `VariableNameChecker::RB_RESERVED_WORDS`.
+    # Also see <code>VariableNameChecker::RB_RESERVED_WORDS</code>.
     #
     RB_RESERVED_WORDS: Array[Symbol]
 
@@ -295,19 +296,19 @@ module DidYouMean
     NAMES_TO_EXCLUDE: Hash[String, Array[Symbol]]
 
     # <!-- rdoc-file=lib/did_you_mean/spell_checkers/name_error_checkers/variable_name_checker.rb -->
-    # `VariableNameChecker::RB_RESERVED_WORDS` is the list of all reserved words in
-    # Ruby. They could be declared like methods are, and a typo would cause Ruby to
-    # raise a `NameError` because of the way they are declared.
+    # <code>VariableNameChecker::RB_RESERVED_WORDS</code> is the list of all
+    # reserved words in Ruby. They could be declared like methods are, and a typo
+    # would cause Ruby to raise a `NameError` because of the way they are declared.
     #
-    # The `:VariableNameChecker` will use this list to suggest a reversed word if a
-    # `NameError` is raised and found closest matches, excluding:
+    # The <code>:VariableNameChecker</code> will use this list to suggest a reversed
+    # word if a `NameError` is raised and found closest matches, excluding:
     #
     #     * +do+
     #     * +if+
     #     * +in+
     #     * +or+
     #
-    # Also see `MethodNameChecker::RB_RESERVED_WORDS`.
+    # Also see <code>MethodNameChecker::RB_RESERVED_WORDS</code>.
     #
     RB_RESERVED_WORDS: Array[Symbol]