rdoc-markdown 0.20.1 → 0.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ae68a40db5d99f60034820bab835a6a6d17c9db00dd3d38d3d47bd7da73743b
-  data.tar.gz: 65a59f988b16411b5914dc5d7de8496efac2a12a67b835ac50b9fa478c1492fd
+  metadata.gz: 867481b03e8cfa3279b67d5344e3d95dfed1c23b4a885cef33bf2cf0992d2df8
+  data.tar.gz: f1bea8f39ecc1ccfdb9363c8c1071fa01099cf48596c1e4d90b01dee4cd000b1
 SHA512:
-  metadata.gz: c8c080f1704dff5d1a4ca256676fbf5f1a69d51a9ec0223e952cceb37837f840274a2bb39e44c70801379ef72d7a70d3811e96810de1d5a568341f6ec2a74875
-  data.tar.gz: 10a07e634578b0ac0290d91e4b1f52f6af36e0cb30349fa8d519970020b55246e719dec427f64c8ad59f6505def782e8709e98b6ff4be01f5494637af5cb265c
+  metadata.gz: 9eb94354e06c97eb71c9bf4defc1c4f4b7f62489d1ac5d9170cb2d091ab126f181b6f84457d9f2f78a324814ed417d78a9dba67f3d2a995cacfabc276cab3eba
+  data.tar.gz: 2caa21c1f0968226a68dddfb115f9dd6c8750ed08db856fb94dce541100eb7b0c2fb36ef7da355f54f5b50e15129c9b65cd19ff5e0aa597e9a65c4a955eb2e33

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.20.2
+
+- Preserve documented bracket lookup and assignment arguments in method headings without changing their anchors.
+
 ## 0.20.1
 
 - Don't offset headings for commets 

data/lib/rdoc/generator/markdown/signatures.rb

@@ -11,34 +11,54 @@ module RDoc::Generator::Markdown::Signatures
   #
   # @param method [RDoc::AnyMethod] Method object to render.
   #
-  # @return [String] Normalized method signature.
+  # @return [String] Complete signature including the method name or documented receiver.
   def method_signature(method)
     RDoc::Generator::Markdown::Signatures.render_method_signature(method, store)
   end
 
   private :method_signature
 
-  # Builds a method signature from RDoc and store metadata.
+  # Builds a complete method heading signature from RDoc and store metadata.
   #
   # @param method [RDoc::AnyMethod] Method object to render.
   # @param store [RDoc::Store] Documentation store with sidecar signatures.
   #
-  # @return [String] Normalized method signature.
+  # @return [String] Complete signature including the method name or documented receiver.
   def self.render_method_signature(method, store)
-    signatures = method.type_signature_lines || store.rbs_signature_for(method) || [method.param_seq]
+    signatures = method.type_signature_lines || store.rbs_signature_for(method)
+    if !signatures && (call_seq = bracket_call_sequence(method))
+      return call_seq.lines.map { |line| normalize_signature(line) }.join(" | ")
+    end
+    signatures ||= [method.param_seq]
 
     signatures = signatures.filter_map do |signature|
       next unless signature&.match?(/\S/)
 
-      signature = signature.gsub("->", " -> ")
-      signature = signature.gsub(/\s+/, " ").strip
+      signature = normalize_signature(signature)
       signature = " #{signature}" if signature.start_with?("->")
       merge_method_signature_arguments(signature, method.params)
     end
 
-    return "()" if signatures.empty?
+    signature = signatures.empty? ? "()" : signatures.join(" | ")
+    "#{method.name}#{signature}"
+  end
 
-    signatures.join(" | ")
+  # Returns the original call syntax for bracket operators, when documented.
+  #
+  # @param method [RDoc::AnyMethod] Method object to render.
+  #
+  # @return [String, nil] Documented bracket calls, or nil for other signatures.
+  def self.bracket_call_sequence(method)
+    method.call_seq if ["[]", "[]="].include?(method.name)
+  end
+
+  # Normalizes spacing in a signature without changing its call syntax.
+  #
+  # @param signature [String] Signature or complete call sequence.
+  #
+  # @return [String] Signature with consistent arrow and whitespace formatting.
+  def self.normalize_signature(signature)
+    signature.gsub("->", " -> ").gsub(/\s+/, " ").strip
   end
 
   # Merges RDoc parameter names into a type-only signature.

data/lib/rdoc/markdown/version.rb

@@ -5,6 +5,6 @@ module Rdoc
   # @private
   module Markdown
     # @private
-    VERSION = "0.20.1"
+    VERSION = "0.20.2"
   end
 end

data/lib/templates/classfile.md.erb

@@ -61,7 +61,7 @@
 
 <%= "#" * group_heading_level %> <%= visibility.capitalize %> <%= type.capitalize %> Methods
 <% methods.each do |method| -%>
-<%= "#" * member_heading_level %> `<%= method.name %><%= method_signature(method) %>`<%= anchor(method.aref) %>
+<%= "#" * member_heading_level %> `<%= method_signature(method) %>`<%= anchor(method.aref) %>
 <%= method_description(method, current_class: klass, heading_level_offset: member_heading_level) %>
 <% end -%>
 <% end -%>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rdoc-markdown
 version: !ruby/object:Gem::Version
-  version: 0.20.1
+  version: 0.20.2
 platform: ruby
 authors:
 - Stanislav (Stas) Katkov