challah 1.0.0.beta2 → 1.0.0.beta3

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/constant_summary.erb

@@ -0,0 +1,13 @@
+<% if constant_listing.size > 0 || object.constants.size > 0 %>
+  <h2>Constant Summary</h2>
+  <% if constant_listing.size > 0 %>
+    <dl class="constants">
+      <% constant_listing.each do |cnst| %>
+        <dt id="<%= anchor_for(cnst) %>" class="<%= cnst.has_tag?(:deprecated) ? 'deprecated' : '' %>"><%= cnst.name %> =
+          <%= yieldall :object => cnst %>
+        </dt>
+        <dd><pre class="code"><%= format_constant cnst.value %></pre></dd>
+      <% end %>
+    </dl>
+  <% end %>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/defines.erb

@@ -0,0 +1,3 @@
+<%= object.file ? object.file : '(unknown)' %><% if object.files.size > 1 %><span class="defines">,<br />
+  <%= object.files[1..-1].map {|f| f.first }.join(",<br /> ") %></span>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/header.erb

@@ -0,0 +1,5 @@
+<h1><%= format_object_title(object) %>
+  <% if object.has_tag?(:abstract) %><span class="abstract note title">Abstract</span><% end %>
+  <% if object.has_tag?(:deprecated) %><span class="deprecated note title">Deprecated</span><% end %>
+  <% if object.has_tag?(:api) && object.tag(:api).text == 'private' %><span class="private note title">Private</span><% end %>
+</h1>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/inherited_attributes.erb

@@ -0,0 +1,14 @@
+<% found_method = false %>
+<% inherited_attr_list do |superclass, attribs| %>
+  <% if attr_listing.size == 0 && !found_method %><h2>Instance Attribute Summary</h2><% end %>
+  <% found_method = true %>
+  <h3 class="inherited">Attributes <%= superclass.type == :class ? 'inherited' : 'included' %> from <%= linkify superclass %></h3>
+  <p class="inherited"><%= attribs.map do |method|
+      name = method.name(true).gsub(/=$/, '')
+      if superclass.type == :module && object.instance_mixins.include?(superclass)
+        name = "##{name}" unless name =~ /^#/
+      end
+      linkify(method, name)
+    end.join(", ")
+  %></p>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/inherited_constants.erb

@@ -0,0 +1,8 @@
+<% found_const = false %>
+<% inherited_constant_list do |superclass, consts| %>
+  <% if constant_listing.size == 0 && !found_const %><h2>Constant Summary</h2><% end %>
+  <% found_const = true %>
+  <h3 class="inherited">Constants <%= superclass.type == :class ? 'inherited' : 'included' %>
+     from <%= linkify superclass %></h3>
+  <p class="inherited"><%= consts.map {|c| linkify c }.join(", ") %></p>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/inherited_methods.erb

@@ -0,0 +1,19 @@
+<% found_method = false %>
+<% object.inheritance_tree(true)[1..-1].each do |superclass| %>
+  <% next if superclass.is_a?(YARD::CodeObjects::Proxy) %>
+  <% next if options.embed_mixins.size > 0 && options.embed_mixins_match?(superclass) != false %>
+  <% meths = prune_method_listing(superclass.meths(:included => false, :inherited => false)) %>
+  <% meths.reject! {|m| object.child(:scope => m.scope, :name => m.name) != nil } %>
+  <% meths.reject! {|m| m.is_alias? || m.is_attribute? } %>
+  <% next if meths.size == 0 %>
+  <% if method_listing.size == 0 && !found_method %><h2>Method Summary</h2><% end %>
+  <% found_method = true %>
+  <h3 class="inherited">Methods <%= superclass.type == :class ? 'inherited' : 'included' %> from <%= linkify superclass %></h3>
+  <p class="inherited"><%=
+    meths.sort_by {|o| o.name.to_s }.map do |m|
+      name = m.name(true)
+      name = name.gsub(/^#/,'') if superclass.type == :module && object.class_mixins.include?(superclass)
+      linkify(m, name)
+    end.join(", ")
+  %></p>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/item_summary.erb

@@ -0,0 +1,40 @@
+<li class="<%= @item.visibility %> <%= @item.has_tag?(:deprecated) ? 'deprecated' : '' %>">
+  <span class="summary_signature">
+    <% if @item.tags(:overload).size == 1 %>
+      <%= signature(@item.tag(:overload), true, !@item.attr_info) %>
+    <% else %>
+      <%= signature(@item, true, false, !@item.attr_info) %>
+    <% end %>
+
+    <% if @item.aliases.size > 0 %>
+      (also: <%= @item.aliases.map {|o| h(o.name(true)) }.join(", ") %>)
+    <% end %>
+  </span>
+  <% if object != @item.namespace %>
+    <span class="note title not_defined_here">
+      <%= @item.namespace.type == :class ? 'inherited' : (@item.scope == :class ? 'extended' : 'included') %>
+      from <%= linkify @item, object.relative_path(@item.namespace) %>
+    </span>
+  <% end %>
+  <% if @item.constructor? %>
+    <span class="note title constructor">constructor</span>
+  <% end %>
+  <% if rw = @item.attr_info %>
+    <% if !run_verifier([rw[:read]].compact).empty? && run_verifier([rw[:write]].compact).empty? %>
+      <span class="note title readonly">readonly</span>
+    <% end %>
+    <% if !run_verifier([rw[:write]].compact).empty? && run_verifier([rw[:read]].compact).empty? %>
+      <span class="note title writeonly">writeonly</span>
+    <% end %>
+  <% end %>
+  <% if @item.visibility != :public %><span class="note title <%= @item.visibility %>"><%= @item.visibility %></span><% end %>
+  <% if @item.has_tag?(:abstract) %><span class="abstract note title">abstract</span><% end %>
+  <% if @item.has_tag?(:deprecated) %><span class="deprecated note title">deprecated</span><% end %>
+  <% if @item.has_tag?(:api) && @item.tag(:api).text == 'private' %><span class="private note title">private</span><% end %>
+
+  <% if @item.has_tag?(:deprecated) %>
+    <span class="summary_desc"><strong>Deprecated.</strong> <%= htmlify_line @item.tag(:deprecated).text %></span>
+  <% else %>
+    <span class="summary_desc"><%= htmlify_line docstring_summary(@item) %></span>
+  <% end %>
+</li>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/method_details_list.erb

@@ -0,0 +1,9 @@
+<% scopes(method_listing(false)) do |list, scope| %>
+  <div id="<%= scope %>_method_details" class="method_details_list">
+    <h2><%= scope.to_s.capitalize %> Method Details</h2>
+
+    <% list.each_with_index do |meth, i| %>
+      <%= yieldall :object => meth, :owner => object, :index => i %>
+    <% end %>
+  </div>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/method_summary.erb

@@ -0,0 +1,14 @@
+<% if method_listing.size > 0 %>
+  <% groups(method_listing) do |list, name| %>
+    <h2>
+      <%= name %>
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+
+    <ul class="summary">
+      <% list.each do |meth| %>
+        <%= yieldall :item => meth %>
+      <% end %>
+    </ul>
+  <% end %>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/methodmissing.erb

@@ -0,0 +1,12 @@
+<div id="method_missing_details" class="method_details_list">
+  <h2>Dynamic Method Handling</h2>
+  <p class="notice <%= @mm.namespace == object ? 'this' : 'super' %>">
+    This class handles dynamic methods through the <tt>method_missing</tt> method
+    <% if @mm.namespace != object %>
+      in the class <%= linkify @mm, @mm.namespace.path %>
+    <% end %>
+  </p>
+  <% if @mm.namespace == object %>
+    <%= yieldall :object => @mm, :index => 0 %>
+  <% end %>
+</div>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/html/pre_docstring.erb

@@ -0,0 +1 @@
+<h2>Overview</h2>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/setup.rb

@@ -0,0 +1,164 @@
+include Helpers::ModuleHelper
+
+def init
+  sections :header, :box_info, :pre_docstring, T('docstring'), :children,
+    :constant_summary, [T('docstring')], :inherited_constants,
+    :attribute_summary, [:item_summary], :inherited_attributes,
+    :method_summary, [:item_summary], :inherited_methods,
+    :methodmissing, [T('method_details')],
+    :attribute_details, [T('method_details')],
+    :method_details_list, [T('method_details')]
+end
+
+def pre_docstring
+  return if object.docstring.blank?
+  erb(:pre_docstring)
+end
+
+def children
+  @inner = [[:modules, []], [:classes, []]]
+  object.children.each do |child|
+    @inner[0][1] << child if child.type == :module
+    @inner[1][1] << child if child.type == :class
+  end
+  @inner.map! {|v| [v[0], run_verifier(v[1].sort_by {|o| o.name.to_s })] }
+  return if (@inner[0][1].size + @inner[1][1].size) == 0
+  erb(:children)
+end
+
+def methodmissing
+  mms = object.meths(:inherited => true, :included => true)
+  return unless @mm = mms.find {|o| o.name == :method_missing && o.scope == :instance }
+  erb(:methodmissing)
+end
+
+def method_listing(include_specials = true)
+  return @smeths ||= method_listing.reject {|o| special_method?(o) } unless include_specials
+  return @meths if @meths
+  @meths = object.meths(:inherited => false, :included => !options.embed_mixins.empty?)
+  if options.embed_mixins.size > 0
+    @meths = @meths.reject {|m| options.embed_mixins_match?(m.namespace) == false }
+  end
+  @meths = sort_listing(prune_method_listing(@meths))
+  @meths
+end
+
+def special_method?(meth)
+  return true if meth.name(true) == '#method_missing'
+  return true if meth.constructor?
+  false
+end
+
+def attr_listing
+  return @attrs if @attrs
+  @attrs = []
+  object.inheritance_tree(true).each do |superclass|
+    next if superclass.is_a?(CodeObjects::Proxy)
+    next if options.embed_mixins.size > 0 &&
+      options.embed_mixins_match?(superclass) == false
+    [:class, :instance].each do |scope|
+      superclass.attributes[scope].each do |name, rw|
+        attr = prune_method_listing([rw[:read], rw[:write]].compact, false).first
+        @attrs << attr if attr
+      end
+    end
+    break if options.embed_mixins.empty?
+  end
+  @attrs = sort_listing(@attrs)
+end
+
+def constant_listing
+  return @constants if @constants
+  @constants = object.constants(:included => false, :inherited => false)
+  @constants += object.cvars
+  @constants = run_verifier(@constants)
+  @constants
+end
+
+def sort_listing(list)
+  list.sort_by {|o| [o.scope.to_s, o.name.to_s.downcase] }
+end
+
+def inherited_attr_list(&block)
+  object.inheritance_tree(true)[1..-1].each do |superclass|
+    next if superclass.is_a?(YARD::CodeObjects::Proxy)
+    next if options.embed_mixins.size > 0 && options.embed_mixins_match?(superclass) != false
+    attribs = superclass.attributes[:instance]
+    attribs = attribs.reject {|name, rw| object.child(:scope => :instance, :name => name) != nil }
+    attribs = attribs.sort_by {|args| args.first.to_s }.map {|n, m| m[:read] || m[:write] }
+    attribs = prune_method_listing(attribs, false)
+    yield superclass, attribs if attribs.size > 0
+  end
+end
+
+def inherited_constant_list(&block)
+  object.inheritance_tree(true)[1..-1].each do |superclass|
+    next if superclass.is_a?(YARD::CodeObjects::Proxy)
+    next if options.embed_mixins.size > 0 && options.embed_mixins_match?(superclass) != false
+    consts = superclass.constants(:included => false, :inherited => false)
+    consts = consts.reject {|const| object.child(:type => :constant, :name => const.name) != nil }
+    consts = consts.sort_by {|const| const.name.to_s }
+    consts = run_verifier(consts)
+    yield superclass, consts if consts.size > 0
+  end
+end
+
+def docstring_full(obj)
+  docstring = ""
+  if obj.tags(:overload).size == 1 && obj.docstring.empty?
+    docstring = obj.tag(:overload).docstring
+  else
+    docstring = obj.docstring
+  end
+
+  if docstring.summary.empty? && obj.tags(:return).size == 1 && obj.tag(:return).text
+    docstring = Docstring.new(obj.tag(:return).text.gsub(/\A([a-z])/) {|x| x.upcase }.strip)
+  end
+
+  docstring
+end
+
+def docstring_summary(obj)
+  docstring_full(obj).summary
+end
+
+def groups(list, type = "Method")
+  if groups_data = object.groups
+    list.each {|m| groups_data |= [m.group] if m.group && owner != m.namespace }
+    others = list.select {|m| !m.group || !groups_data.include?(m.group) }
+    groups_data.each do |name|
+      items = list.select {|m| m.group == name }
+      yield(items, name) unless items.empty?
+    end
+  else
+    others = []
+    group_data = {}
+    list.each do |meth|
+      if meth.group
+        (group_data[meth.group] ||= []) << meth
+      else
+        others << meth
+      end
+    end
+    group_data.each {|group, items| yield(items, group) unless items.empty? }
+  end
+
+  scopes(others) {|items, scope| yield(items, "#{scope.to_s.capitalize} #{type} Summary") }
+end
+
+def scopes(list)
+  [:class, :instance].each do |scope|
+    items = list.select {|m| m.scope == scope }
+    yield(items, scope) unless items.empty?
+  end
+end
+
+def mixed_into(object)
+  unless globals.mixed_into
+    globals.mixed_into = {}
+    list = run_verifier Registry.all(:class, :module)
+    list.each {|o| o.mixins.each {|m| (globals.mixed_into[m.path] ||= []) << o } }
+  end
+
+  globals.mixed_into[object.path] || []
+end

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/children.erb

@@ -0,0 +1,10 @@
+Defined Under Namespace:
+------------------------
+
+<% @inner.each do |name, list| %>
+<% if list.size > 0 %>
+<% text = list.map {|c| c.name }.join(", ") + " (#{name})" %>
+<%= indent(wrap(text)) %>
+
+<% end %>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/class_meths_list.erb

@@ -0,0 +1,8 @@
+<% if class_meths.size > 0 %>
+Class methods:
+--------------
+
+<%= indent wrap(class_meths.map {|o| o.name.to_s }.join(", "), 68) %>
+
+
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/extends.erb

@@ -0,0 +1,8 @@
+<% if object.mixins(:class).size > 0 %>
+Extended by:
+------------
+
+<%= indent wrap(object.mixins(:class).join(", "), 68) %>
+
+
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/header.erb

@@ -0,0 +1,7 @@
+<%= title_align_right format_object_title(object) %>
+
+<%= yieldall %>
+
+<%= hr %>
+
+

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/includes.erb

@@ -0,0 +1,8 @@
+<% if object.mixins(:instance).size > 0 %>
+Includes:
+---------
+
+<%= indent wrap(object.mixins(:instance).join(", "), 68) %>
+
+
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/instance_meths_list.erb

@@ -0,0 +1,8 @@
+<% if instance_meths.size > 0 %>
+Instance methods:
+-----------------
+
+<%= indent wrap(instance_meths.map {|o| o.name.to_s }.join(", "), 68) %>
+
+
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/module/text/setup.rb

@@ -0,0 +1,12 @@
+def init
+  sections :header, [T('docstring')], :children, :includes, :extends,
+    :class_meths_list, :instance_meths_list
+end
+
+def class_meths
+  @classmeths ||= method_listing.select {|o| o.scope == :class }
+end
+
+def instance_meths
+  @instmeths ||= method_listing.select {|o| o.scope == :instance }
+end

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/onefile/html/files.erb

@@ -0,0 +1,5 @@
+<% @files.each do |file| %>
+  <% @file = file %>
+  <h2><%= file.title %></h2>
+  <%= diskfile %>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/onefile/html/headers.erb

@@ -0,0 +1,6 @@
+<style type="text/css">
+  <%= @css_data %>
+</style>
+<script type="text/javascript" charset="utf-8">
+  <%= @js_data %>
+</script>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/onefile/html/layout.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=<%= charset %>" />
+    <title><%= @title %></title>
+    <%= erb(:headers) %>
+  </head>
+  <body>
+    <div id="content">
+      <h1><%= @title %></h1>
+      <%= yieldall %>
+    </div>
+
+    <%= erb(:footer) %>
+  </body>
+</html>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/onefile/html/readme.erb

@@ -0,0 +1,3 @@
+<div id="readme">
+  <%= htmlify(parse_top_comments_from_file) %>
+</div>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/onefile/html/setup.rb

@@ -0,0 +1,61 @@
+include T('default/layout/html')
+include YARD::Parser::Ruby::Legacy
+
+def init
+  override_serializer
+  @object = YARD::Registry.root
+  @files.shift
+  @objects.delete(YARD::Registry.root)
+  @objects.unshift(YARD::Registry.root)
+  sections :layout, [:readme, :files, :all_objects]
+end
+
+def all_objects
+  @objects.map {|obj| obj.format(options) }.join("\n")
+end
+
+def layout
+  fulldoc = Object.new.extend(T('fulldoc'))
+  layout = Object.new.extend(T('layout'))
+  @css_data = layout.stylesheets.map {|sheet| read_asset(sheet) }.join("\n")
+  @js_data = layout.javascripts.map {|script| read_asset(script) }.join("")
+
+  erb(:layout)
+end
+
+def read_asset(file)
+  return unless file = T('fulldoc').find_file(file)
+  data = File.read(file)
+  superfile = self.class.find_nth_file('fulldoc', 2)
+  data.gsub!('{{{__super__}}}', superfile ? IO.read(superfile) : "")
+  data
+end
+
+private
+
+def parse_top_comments_from_file
+  return unless @readme
+  return @readme.contents unless @readme.filename =~ /\.rb$/
+  data = ""
+  tokens = TokenList.new(@readme.contents)
+  tokens.each do |token|
+    break unless token.is_a?(RubyToken::TkCOMMENT) || token.is_a?(RubyToken::TkNL)
+    data << (token.text[/\A#\s{0,1}(.*)/, 1] || "\n")
+  end
+  YARD::Docstring.new(data)
+end
+
+def override_serializer
+  return if @serializer.nil?
+  class << @serializer
+    def serialize(object, data)
+      return unless object == 'index.html'
+      super
+    end
+
+    def serialized_path(object)
+      return object if object.is_a?(String)
+      return 'index.html'
+    end
+  end
+end

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/root/dot/child.erb

@@ -0,0 +1,3 @@
+<% if inner = yieldall.gsub("\n", '') %>
+Root [label="{<%= inner %>}" rank=sink];
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/root/dot/setup.rb

@@ -0,0 +1,5 @@
+include T('default/module/dot')
+
+def format_path(object)
+  ""
+end

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/root/html/setup.rb

@@ -0,0 +1 @@
+include T('default/module/html')

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/html/example.erb

@@ -0,0 +1,11 @@
+<% if object.has_tag?(:example) %>
+  <div class="examples">
+    <p class="tag_title">Examples:</p>
+    <% object.tags(:example).each do |tag| %>
+      <% unless tag.name.empty? %>
+        <p class="example_title"><%= htmlify_line(tag.name) %></p>
+      <% end %>
+      <pre class="example code"><code><%= html_syntax_highlight(tag.text) %></code></pre>
+    <% end %>
+  </div>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/html/index.erb

@@ -0,0 +1,3 @@
+<div class="tags">
+  <%= yieldall %>
+</div>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/html/option.erb

@@ -0,0 +1,24 @@
+<% if object.has_tag?(:option) %>
+  <% object.parameters.each do |param, default| %>
+    <% tags = object.tags(:option).select {|x| x.name.to_s == param.to_s } %>
+    <% next if tags.empty? %>
+    <p class="tag_title">Options Hash (<tt><%= param %></tt>):</p>
+    <ul class="option">
+      <% for tag in tags %>
+        <li>
+          <span class="name"><%= tag.pair.name %></span>
+          <span class="type"><%= format_types(tag.pair.types || ['Object']) %></span>
+          <span class="default">
+            <% if tag.pair.defaults %>
+              &mdash; default:
+              <%= tag.pair.defaults.map {|t| "<tt>#{h t}</tt>" }.join(", ") %>
+            <% end %>
+          </span>
+          <% if tag.pair.text && tag.pair.text =~ /\S/ %>
+            &mdash; <%= htmlify_line(tag.pair.text) %>
+          <% end %>
+        </li>
+      <% end %>
+    </ul>
+  <% end %>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/html/overload.erb

@@ -0,0 +1,14 @@
+<% if object.tags(:overload).size == 1 %>
+  <%= yieldall :object => object.tag(:overload) %>
+<% elsif object.has_tag?(:overload) && object.tags(:overload).any? {|o| !o.docstring.blank? } %>
+  <p class="tag_title">Overloads:</p>
+  <ul class="overload">
+    <% object.tags(:overload).each do |overload| %>
+      <% next if overload.docstring.blank? %>
+      <li class="overload_item">
+        <span class="signature"><%= signature(overload, false, false) %></span>
+        <%= yieldall :object => overload %>
+      </li>
+    <% end %>
+  </ul>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/html/see.erb

@@ -0,0 +1,8 @@
+<% if object.has_tag?(:see) %>
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    <% for tag in object.tags(:see) %>
+      <li><%= linkify(tag.name, tag.text) %></li>
+    <% end %>
+  </ul>
+<% end %>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/html/tag.erb

@@ -0,0 +1,20 @@
+<p class="tag_title"><%= @label ? @label : YARD::Tags::Library.labels[@name] %>:</p>
+<ul class="<%= @name %>">
+  <% object.tags(@name).each do |tag| %>
+    <li>
+      <% unless @no_names %>
+        <span class='name'><%= h tag.name %></span>
+      <% end %>
+      <% unless @no_types %>
+        <span class='type'><%= format_types(tag.types) %></span>
+      <% end %>
+      <% if @name == :param && (o=object.parameters.assoc(tag.name.to_s)) && o[1] %>
+        <em class="default">(defaults to: <tt><%= h o[1] %></tt>)</em>
+      <% end %>
+      <% if tag.text && !tag.text.empty? %>
+        <% unless (@no_types || tag.types.nil? || tag.types.empty?) && @no_names %>&mdash;<% end %>
+        <%= htmlify_line(tag.text) %>
+      <% end %>
+    </li>
+  <% end %>
+</ul>

data/vendor/bundle/gems/yard-0.8.6.1/templates/default/tags/setup.rb

@@ -0,0 +1,55 @@
+def init
+  tags = Tags::Library.visible_tags - [:abstract, :deprecated, :note, :todo]
+  create_tag_methods(tags - [:example, :option, :overload, :see])
+  sections :index, tags.map {|t| t.to_s.gsub('.', '_').to_sym }
+  sections.any(:overload).push(T('docstring'))
+end
+
+def return
+  if object.type == :method
+    return if object.constructor?
+    return if object.tags(:return).size == 1 && object.tag(:return).types == ['void']
+  end
+  tag(:return)
+end
+
+def param
+  tag(:param) if object.type == :method
+end
+
+private
+
+def tag(name, opts = nil)
+  return unless object.has_tag?(name)
+  opts ||= options_for_tag(name)
+  @no_names = true if opts[:no_names]
+  @no_types = true if opts[:no_types]
+  @name = name
+  out = erb('tag')
+  @no_names, @no_types = nil, nil
+  out
+end
+
+def create_tag_methods(tags)
+  tags.each do |tag|
+    tag_meth = tag.to_s.gsub('.', '_')
+    next if respond_to?(tag_meth)
+    instance_eval(<<-eof, __FILE__, __LINE__ + 1)
+      def #{tag_meth}; tag(#{tag.inspect}) end
+    eof
+  end
+end
+
+def options_for_tag(tag)
+  opts = {:no_types => true, :no_names => true}
+  case Tags::Library.factory_method_for(tag)
+  when :with_types
+    opts[:no_types] = false
+  when :with_types_and_name
+    opts[:no_types] = false
+    opts[:no_names] = false
+  when :with_name
+    opts[:no_names] = false
+  end
+  opts
+end