lib/yard/handlers/ruby/legacy/method_handler.rb in yard-0.6.8 vs lib/yard/handlers/ruby/legacy/method_handler.rb in yard-0.7.0

- old
+ new

@@ -1,9 +1,9 @@ # (see Ruby::MethodHandler) class YARD::Handlers::Ruby::Legacy::MethodHandler < YARD::Handlers::Ruby::Legacy::Base handles TkDEF - + process do nobj = namespace mscope = scope if statement.tokens.to_s =~ /^def\s+(#{METHODMATCH})(?:(?:\s+|\s*\()(.*)(?:\)\s*$)?)?/m @@ -21,51 +21,51 @@ if prefix =~ /^[a-z]/ && prefix != "self" raise YARD::Parser::UndocumentableError, 'method defined on object instance' end nobj = P(namespace, prefix) unless prefix == "self" end - + nobj = P(namespace, nobj.value) while nobj.type == :constant - obj = register MethodObject.new(nobj, meth, mscope) do |o| - o.visibility = visibility + obj = register MethodObject.new(nobj, meth, mscope) do |o| + o.visibility = visibility o.source = statement o.explicit = true o.parameters = args end - + # delete any aliases referencing old method nobj.aliases.each do |aobj, name| next unless name == obj.name nobj.aliases.delete(aobj) end if nobj.is_a?(NamespaceObject) - + if mscope == :instance && meth == "initialize" unless obj.has_tag?(:return) - obj.docstring.add_tag(YARD::Tags::Tag.new(:return, + obj.docstring.add_tag(YARD::Tags::Tag.new(:return, "a new instance of #{namespace.name}", namespace.name.to_s)) end - elsif mscope == :class && obj.docstring.blank? && %w(inherited included + elsif mscope == :class && obj.docstring.blank? && %w(inherited included extended method_added method_removed method_undefined).include?(meth) obj.docstring.add_tag(YARD::Tags::Tag.new(:private, nil)) elsif meth.to_s =~ /\?$/ if obj.tag(:return) && (obj.tag(:return).types || []).empty? obj.tag(:return).types = ['Boolean'] elsif obj.tag(:return).nil? obj.docstring.add_tag(YARD::Tags::Tag.new(:return, "", "Boolean")) end end - + if obj.has_tag?(:option) # create the options parameter if its missing obj.tags(:option).each do |option| expected_param = option.name unless obj.tags(:param).find {|x| x.name == expected_param } new_tag = YARD::Tags::Tag.new(:param, "a customizable set of options", "Hash", expected_param) obj.docstring.add_tag(new_tag) end end end - + if info = obj.attr_info if meth.to_s =~ /=$/ # writer info[:write] = obj if info[:read] else info[:read] = obj if info[:write]