@@ -7,7 +7,21 @@ module YARD before_section :todo, :has_todo? def sections_for(object) - [:header, [:example, :param, :yield, :yieldparam, :yieldreturn, :return, :raise, :todo, :author, :version, :since, :see]] + sections = [ + :header, [ :example, :param, :yield, :yieldparam, :yieldreturn, + :return, :raise, :todo, :author, :version, :since, :see ] + ] + if object.tags(:overload).size == 1 + size = sections.last.size + sections.last.reverse.each_with_index do |item, index| + sections.last[size - index - 1, 1] = [:with_overload, [item]] + end + end + sections + end + + def with_overload(object) + yield(object.tag(:overload)) + yield(object) end def yield(object) @@ -45,7 +59,9 @@ module YARD protected def has_params?(object) - object.is_a?(CodeObjects::MethodObject) && tags_by_param(object).size > 0 + (object.is_a?(Tags::OverloadTag) || + object.is_a?(CodeObjects::MethodObject)) && + tags_by_param(object).size > 0 end def has_tags?(object) lib/yard/generators/tags_generator.rb @@ -2,7 +2,7 @@ module YARD module Tags class OverloadTag < Tag attr_reader :signature, :parameters, :docstring - undef_method :is_a?, :kind_of?, :==, :===, :to_s, :inspect + undef_method :to_s, :inspect def initialize(tag_name, text, raw_text) super(tag_name, nil) lib/yard/tags/overload_tag.rb 517754f4882256e91facc106f668410406fa688f Loren Segal lsegal@soen.ca http://github.com/lsegal/yard/commit/77ff41b4fffb74729cb79c3a6d24a1f177428a10 77ff41b4fffb74729cb79c3a6d24a1f177428a10 2009-07-04T13:50:48-07:00 2009-07-04T13:50:48-07:00 If there's only one overload, try to merge tags with regular object tags a4de640f1a1bbd723cdab7ff9a34190d0a2c5195 Loren Segal lsegal@soen.ca