Sha256: b70eb328d82414f00ed3abb46e7326872fbd1a044a6f75026926cf21cbe7b87b

Contents?: true

Size: 1.08 KB

Versions: 9

Compression:

Stored size: 1.08 KB

Contents

def init
  return if object.docstring.blank?
  sections :index, [:private, :deprecated, :abstract, :todo, :note, :returns_void, :text], T('tags')
end

def private
  return unless object.has_tag?(:api) && object.tag(:api).text == 'private'
  erb(:private)
end

def abstract
  return unless object.has_tag?(:abstract)
  erb(:abstract)
end

def deprecated
  return unless object.has_tag?(:deprecated)
  erb(:deprecated)
end

def todo
  return unless object.has_tag?(:todo)
  erb(:todo)
end

def note
  return unless object.has_tag?(:note)
  erb(:note)
end

def returns_void
  return unless object.type == :method
  return if object.name == :initialize && object.scope == :instance
  return unless object.tags(:return).size == 1 && object.tag(:return).types == ['void']
  erb(:returns_void)
end

def docstring_text
  text = ""
  unless object.tags(:overload).size == 1 && object.docstring.empty?
    text = object.docstring
  end
  
  if text.strip.empty? && object.tags(:return).size == 1 && object.tag(:return).text
    text = object.tag(:return).text.gsub(/\A([a-z])/) {|x| x.upcase }
  end
  
  text.strip
end

Version data entries

9 entries across 9 versions & 1 rubygems

Version Path
yard-0.6.4 templates/default/docstring/setup.rb
yard-0.6.3 templates/default/docstring/setup.rb
yard-0.6.2 templates/default/docstring/setup.rb
yard-0.6.1 templates/default/docstring/setup.rb
yard-0.6.0 templates/default/docstring/setup.rb
yard-0.5.8 templates/default/docstring/setup.rb
yard-0.5.7 templates/default/docstring/setup.rb
yard-0.5.6 templates/default/docstring/setup.rb
yard-0.5.5 templates/default/docstring/setup.rb