Sha256: 9ecc653f475e46c4ce9b6947d2393c420ea03b917d89ca18f70f9054cc252150

Contents?: true

Size: 1.23 KB

Versions: 51

Compression:

Stored size: 1.23 KB

Contents

def init
  return if object.docstring.blank? && !object.has_tag?(:api)
  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.downcase }
    text = "Returns #{text}" unless text.empty? || text =~ /^\s*return/i
    text = text.gsub(/\A([a-z])/) {|x| x.upcase }
  end

  text.strip
end

Version data entries

51 entries across 47 versions & 8 rubygems

Version Path
my_yard-0.0.8 home_my_yard/templates/visualruby/docstring/setup.rb
my_yard-0.0.7 home_my_yard/templates/visualruby/docstring/setup.rb
enumerable-statistics-2.0.7 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.6 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.5 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.3 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.2 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.1 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.0 yard/templates/mathjax/docstring/setup.rb
enumerable-statistics-2.0.0.pre yard/templates/mathjax/docstring/setup.rb
abaci-0.3.0 vendor/bundle/gems/yard-0.9.1/templates/default/docstring/setup.rb
abaci-0.3.0 vendor/bundle/gems/yard-0.9.2/templates/default/docstring/setup.rb
enumerable-statistics-1.0.1 yard/templates/mathjax/docstring/setup.rb
my_yard-0.0.3 home_my_yard/templates/visualruby/docstring/setup.rb
my_yard-0.0.2 home_my_yard/templates/visualruby/docstring/setup.rb
yard-0.9.5 templates/default/docstring/setup.rb
yard-0.9.4 templates/default/docstring/setup.rb
yard-0.9.3 templates/default/docstring/setup.rb
yard-0.9.2 templates/default/docstring/setup.rb
yard-0.9.1 templates/default/docstring/setup.rb