RubyGems - yard - Versions diffs - 0.7.5 → 0.8.0 - Mend

yard 0.7.5 → 0.8.0

Potentially problematic release.

This version of yard might be problematic. Click here for more details.

Files changed (339) hide show

data/.yardopts +10 -2
data/ChangeLog +1263 -38
data/LEGAL +5 -5
data/LICENSE +1 -1
data/README.md +91 -82
data/Rakefile +6 -6
data/benchmarks/builtins_vs_eval.rb +1 -1
data/benchmarks/erb_vs_erubis.rb +4 -4
data/benchmarks/generation.rb +5 -5
data/benchmarks/parsing.rb +2 -2
data/benchmarks/registry_store_types.rb +48 -0
data/bin/yard +9 -1
data/bin/yardoc +9 -1
data/bin/yri +10 -2
data/docs/CodeObjects.md +10 -10
data/docs/GettingStarted.md +85 -83
data/docs/Handlers.md +21 -21
data/docs/Overview.md +7 -7
data/docs/Parser.md +30 -30
data/docs/Tags.md +250 -554
data/docs/TagsArch.md +123 -0
data/docs/Templates.md +58 -80
data/docs/WhatsNew.md +378 -133
data/docs/templates/default/fulldoc/html/full_list_tag.erb +7 -0
data/docs/templates/default/fulldoc/html/setup.rb +6 -0
data/docs/templates/default/layout/html/setup.rb +8 -0
data/docs/templates/default/layout/html/tag_list.erb +11 -0
data/docs/templates/default/yard_tags/html/list.erb +18 -0
data/docs/templates/default/yard_tags/html/setup.rb +27 -0
data/docs/templates/plugin.rb +65 -0
data/lib/yard.rb +1 -10
data/lib/yard/autoload.rb +75 -27
data/lib/yard/cli/command.rb +5 -2
data/lib/yard/cli/command_parser.rb +3 -2
data/lib/yard/cli/diff.rb +1 -1
data/lib/yard/cli/i18n.rb +69 -0
data/lib/yard/cli/list.rb +1 -1
data/lib/yard/cli/server.rb +30 -7
data/lib/yard/cli/stats.rb +5 -6
data/lib/yard/cli/yardoc.rb +95 -45
data/lib/yard/cli/yri.rb +24 -3
data/lib/yard/code_objects/base.rb +35 -4
data/lib/yard/code_objects/extra_file_object.rb +1 -1
data/lib/yard/code_objects/macro_object.rb +56 -99
data/lib/yard/code_objects/method_object.rb +44 -6
data/lib/yard/config.rb +18 -8
data/lib/yard/core_ext/symbol_hash.rb +1 -1
data/lib/yard/docstring.rb +45 -85
data/lib/yard/docstring_parser.rb +269 -0
data/lib/yard/handlers/base.rb +129 -118
data/lib/yard/handlers/c/alias_handler.rb +15 -0
data/lib/yard/handlers/c/attribute_handler.rb +13 -0
data/lib/yard/handlers/c/base.rb +110 -0
data/lib/yard/handlers/c/class_handler.rb +26 -0
data/lib/yard/handlers/c/constant_handler.rb +12 -0
data/lib/yard/handlers/c/handler_methods.rb +165 -0
data/lib/yard/handlers/c/init_handler.rb +16 -0
data/lib/yard/handlers/c/method_handler.rb +35 -0
data/lib/yard/handlers/c/mixin_handler.rb +13 -0
data/lib/yard/handlers/c/module_handler.rb +16 -0
data/lib/yard/handlers/c/override_comment_handler.rb +22 -0
data/lib/yard/handlers/c/path_handler.rb +10 -0
data/lib/yard/handlers/c/struct_handler.rb +12 -0
data/lib/yard/handlers/c/symbol_handler.rb +7 -0
data/lib/yard/handlers/processor.rb +41 -30
data/lib/yard/handlers/ruby/alias_handler.rb +0 -2
data/lib/yard/handlers/ruby/attribute_handler.rb +16 -17
data/lib/yard/handlers/ruby/base.rb +10 -6
data/lib/yard/handlers/ruby/comment_handler.rb +9 -0
data/lib/yard/handlers/ruby/dsl_handler.rb +14 -0
data/lib/yard/handlers/ruby/dsl_handler_methods.rb +71 -0
data/lib/yard/handlers/ruby/legacy/alias_handler.rb +0 -3
data/lib/yard/handlers/ruby/legacy/attribute_handler.rb +16 -17
data/lib/yard/handlers/ruby/legacy/base.rb +28 -6
data/lib/yard/handlers/ruby/legacy/comment_handler.rb +9 -0
data/lib/yard/handlers/ruby/legacy/dsl_handler.rb +16 -0
data/lib/yard/handlers/ruby/legacy/method_handler.rb +0 -2
data/lib/yard/handlers/ruby/legacy/mixin_handler.rb +1 -1
data/lib/yard/handlers/ruby/legacy/module_function_handler.rb +18 -0
data/lib/yard/handlers/ruby/method_handler.rb +10 -15
data/lib/yard/handlers/ruby/mixin_handler.rb +1 -1
data/lib/yard/handlers/ruby/module_function_handler.rb +26 -0
data/lib/yard/handlers/ruby/struct_handler_methods.rb +3 -2
data/lib/yard/i18n/pot_generator.rb +281 -0
data/lib/yard/i18n/text.rb +72 -0
data/lib/yard/logging.rb +3 -7
data/lib/yard/options.rb +216 -0
data/lib/yard/parser/c/c_parser.rb +225 -0
data/lib/yard/parser/c/comment_parser.rb +131 -0
data/lib/yard/parser/c/statement.rb +63 -0
data/lib/yard/parser/ruby/ast_node.rb +91 -1
data/lib/yard/parser/ruby/legacy/ruby_parser.rb +1 -0
data/lib/yard/parser/ruby/legacy/statement.rb +7 -2
data/lib/yard/parser/ruby/legacy/statement_list.rb +13 -22
data/lib/yard/parser/ruby/ruby_parser.rb +87 -26
data/lib/yard/parser/source_parser.rb +89 -88
data/lib/yard/rake/yardoc_task.rb +1 -1
data/lib/yard/registry.rb +21 -10
data/lib/yard/registry_store.rb +48 -0
data/lib/yard/serializers/file_system_serializer.rb +18 -20
data/lib/yard/serializers/yardoc_serializer.rb +1 -0
data/lib/yard/server/adapter.rb +2 -2
data/lib/yard/server/commands/base.rb +1 -1
data/lib/yard/server/commands/display_object_command.rb +13 -6
data/lib/yard/server/commands/frames_command.rb +4 -21
data/lib/yard/server/commands/library_command.rb +57 -11
data/lib/yard/server/commands/list_command.rb +10 -34
data/lib/yard/server/commands/search_command.rb +8 -2
data/lib/yard/server/doc_server_helper.rb +34 -0
data/lib/yard/server/rack_adapter.rb +5 -1
data/lib/yard/server/router.rb +4 -10
data/lib/yard/server/static_caching.rb +2 -2
data/lib/yard/server/templates/default/fulldoc/html/css/custom.css +2 -2
data/lib/yard/server/templates/default/fulldoc/html/js/live.js +0 -15
data/lib/yard/server/templates/default/layout/html/breadcrumb.erb +3 -3
data/lib/yard/server/templates/default/layout/html/script_setup.erb +8 -0
data/lib/yard/server/templates/doc_server/processing/html/processing.erb +1 -1
data/lib/yard/server/templates/doc_server/search/html/setup.rb +1 -1
data/lib/yard/tags/default_factory.rb +31 -4
data/lib/yard/tags/directives.rb +593 -0
data/lib/yard/tags/library.rb +437 -35
data/lib/yard/templates/engine.rb +17 -12
data/lib/yard/templates/helpers/base_helper.rb +8 -2
data/lib/yard/templates/helpers/html_helper.rb +57 -14
data/lib/yard/templates/helpers/markup/rdoc_markup.rb +1 -1
data/lib/yard/templates/helpers/markup_helper.rb +9 -9
data/lib/yard/templates/helpers/text_helper.rb +2 -2
data/lib/yard/templates/template.rb +42 -13
data/lib/yard/templates/template_options.rb +81 -0
data/spec/cli/command_parser_spec.rb +4 -4
data/spec/cli/command_spec.rb +3 -3
data/spec/cli/config_spec.rb +13 -13
data/spec/cli/diff_spec.rb +13 -10
data/spec/cli/gems_spec.rb +12 -12
data/spec/cli/help_spec.rb +2 -2
data/spec/cli/i18n_spec.rb +111 -0
data/spec/cli/server_spec.rb +66 -18
data/spec/cli/stats_spec.rb +15 -15
data/spec/cli/yardoc_spec.rb +124 -97
data/spec/cli/yri_spec.rb +14 -12
data/spec/code_objects/base_spec.rb +104 -46
data/spec/code_objects/class_object_spec.rb +33 -33
data/spec/code_objects/code_object_list_spec.rb +5 -5
data/spec/code_objects/constants_spec.rb +4 -3
data/spec/code_objects/extra_file_object_spec.rb +19 -19
data/spec/code_objects/macro_object_spec.rb +31 -37
data/spec/code_objects/method_object_spec.rb +46 -23
data/spec/code_objects/module_object_spec.rb +16 -16
data/spec/code_objects/namespace_object_spec.rb +6 -6
data/spec/code_objects/proxy_spec.rb +19 -19
data/spec/config_spec.rb +33 -24
data/spec/core_ext/array_spec.rb +1 -1
data/spec/core_ext/file_spec.rb +8 -8
data/spec/core_ext/hash_spec.rb +1 -1
data/spec/core_ext/insertion_spec.rb +3 -3
data/spec/core_ext/module_spec.rb +1 -1
data/spec/core_ext/string_spec.rb +6 -6
data/spec/core_ext/symbol_hash_spec.rb +11 -11
data/spec/docstring_parser_spec.rb +207 -0
data/spec/docstring_spec.rb +33 -146
data/spec/handlers/alias_handler_spec.rb +14 -14
data/spec/handlers/attribute_handler_spec.rb +20 -20
data/spec/handlers/base_spec.rb +16 -16
data/spec/handlers/c/alias_handler_spec.rb +33 -0
data/spec/handlers/c/attribute_handler_spec.rb +40 -0
data/spec/handlers/c/class_handler_spec.rb +64 -0
data/spec/handlers/c/constant_handler_spec.rb +68 -0
data/spec/handlers/c/init_handler_spec.rb +36 -0
data/spec/handlers/c/method_handler_spec.rb +228 -0
data/spec/handlers/c/mixin_handler_spec.rb +27 -0
data/spec/handlers/c/module_handler_spec.rb +38 -0
data/spec/handlers/c/override_comment_handler_spec.rb +43 -0
data/spec/handlers/c/path_handler_spec.rb +35 -0
data/spec/handlers/c/spec_helper.rb +11 -0
data/spec/handlers/c/struct_handler_spec.rb +15 -0
data/spec/handlers/class_condition_handler_spec.rb +10 -10
data/spec/handlers/class_handler_spec.rb +38 -38
data/spec/handlers/class_variable_handler_spec.rb +1 -1
data/spec/handlers/constant_handler_spec.rb +7 -7
data/spec/handlers/{macro_handler_spec.rb → dsl_handler_spec.rb} +72 -53
data/spec/handlers/examples/alias_handler_001.rb.txt +5 -5
data/spec/handlers/examples/class_condition_handler_001.rb.txt +9 -9
data/spec/handlers/examples/class_handler_001.rb.txt +1 -1
data/spec/handlers/examples/dsl_handler_001.rb.txt +110 -0
data/spec/handlers/examples/exception_handler_001.rb.txt +14 -14
data/spec/handlers/examples/method_condition_handler_001.rb.txt +2 -2
data/spec/handlers/examples/method_handler_001.rb.txt +16 -16
data/spec/handlers/examples/mixin_handler_001.rb.txt +8 -4
data/spec/handlers/examples/private_constant_handler_001.rb.txt +1 -1
data/spec/handlers/examples/visibility_handler_001.rb.txt +3 -3
data/spec/handlers/examples/yield_handler_001.rb.txt +13 -14
data/spec/handlers/exception_handler_spec.rb +9 -9
data/spec/handlers/extend_handler_spec.rb +2 -2
data/spec/handlers/legacy_base_spec.rb +34 -34
data/spec/handlers/method_condition_handler_spec.rb +2 -2
data/spec/handlers/method_handler_spec.rb +33 -33
data/spec/handlers/mixin_handler_spec.rb +13 -9
data/spec/handlers/module_function_handler_spec.rb +82 -0
data/spec/handlers/module_handler_spec.rb +6 -6
data/spec/handlers/private_constant_handler_spec.rb +3 -3
data/spec/handlers/processor_spec.rb +5 -5
data/spec/handlers/ruby/base_spec.rb +10 -6
data/spec/handlers/ruby/legacy/base_spec.rb +11 -7
data/spec/handlers/spec_helper.rb +2 -3
data/spec/handlers/visibility_handler_spec.rb +6 -6
data/spec/handlers/yield_handler_spec.rb +8 -8
data/spec/i18n/pot_generator_spec.rb +244 -0
data/spec/i18n/text_spec.rb +69 -0
data/spec/options_spec.rb +160 -0
data/spec/parser/base_spec.rb +3 -3
data/spec/parser/c_parser_spec.rb +31 -257
data/spec/parser/examples/array.c.txt +187 -187
data/spec/parser/examples/extrafile.c.txt +1 -1
data/spec/parser/examples/override.c.txt +1 -1
data/spec/parser/ruby/ast_node_spec.rb +1 -1
data/spec/parser/ruby/legacy/statement_list_spec.rb +24 -24
data/spec/parser/ruby/legacy/token_list_spec.rb +7 -7
data/spec/parser/ruby/ruby_parser_spec.rb +56 -34
data/spec/parser/source_parser_spec.rb +125 -65
data/spec/parser/tag_parsing_spec.rb +4 -4
data/spec/rake/yardoc_task_spec.rb +10 -8
data/spec/registry_spec.rb +65 -36
data/spec/registry_store_spec.rb +90 -40
data/spec/serializers/file_system_serializer_spec.rb +12 -12
data/spec/serializers/yardoc_serializer_spec.rb +2 -2
data/spec/server/adapter_spec.rb +3 -3
data/spec/server/commands/base_spec.rb +8 -8
data/spec/server/commands/library_command_spec.rb +3 -3
data/spec/server/commands/static_file_command_spec.rb +7 -7
data/spec/server/doc_server_helper_spec.rb +1 -1
data/spec/server/doc_server_serializer_spec.rb +6 -6
data/spec/server/rack_adapter_spec.rb +3 -3
data/spec/server/router_spec.rb +19 -19
data/spec/server/static_caching_spec.rb +4 -4
data/spec/spec_helper.rb +7 -7
data/spec/tags/default_factory_spec.rb +24 -16
data/spec/tags/directives_spec.rb +422 -0
data/spec/tags/library_spec.rb +15 -4
data/spec/tags/overload_tag_spec.rb +6 -6
data/spec/tags/ref_tag_list_spec.rb +8 -8
data/spec/templates/class_spec.rb +7 -7
data/spec/templates/constant_spec.rb +7 -7
data/spec/templates/engine_spec.rb +28 -36
data/spec/templates/examples/class001.html +108 -108
data/spec/templates/examples/class002.html +17 -17
data/spec/templates/examples/constant001.txt +1 -1
data/spec/templates/examples/method001.html +45 -45
data/spec/templates/examples/method002.html +25 -25
data/spec/templates/examples/method003.html +60 -60
data/spec/templates/examples/method004.html +7 -7
data/spec/templates/examples/method005.html +28 -28
data/spec/templates/examples/module001.html +321 -321
data/spec/templates/examples/module001.txt +1 -1
data/spec/templates/examples/module002.html +130 -130
data/spec/templates/examples/module003.html +74 -74
data/spec/templates/examples/module004.html +388 -0
data/spec/templates/helpers/base_helper_spec.rb +32 -32
data/spec/templates/helpers/html_helper_spec.rb +87 -68
data/spec/templates/helpers/html_syntax_highlight_helper_spec.rb +9 -9
data/spec/templates/helpers/markup/rdoc_markup_spec.rb +16 -16
data/spec/templates/helpers/markup_helper_spec.rb +31 -28
data/spec/templates/helpers/method_helper_spec.rb +7 -7
data/spec/templates/helpers/shared_signature_examples.rb +9 -7
data/spec/templates/helpers/text_helper_spec.rb +3 -3
data/spec/templates/method_spec.rb +13 -13
data/spec/templates/module_spec.rb +70 -24
data/spec/templates/onefile_spec.rb +32 -15
data/spec/templates/section_spec.rb +23 -23
data/spec/templates/spec_helper.rb +31 -1
data/spec/templates/tag_spec.rb +5 -5
data/spec/templates/template_spec.rb +54 -46
data/spec/verifier_spec.rb +5 -5
data/templates/default/class/setup.rb +2 -2
data/templates/default/docstring/html/abstract.erb +1 -1
data/templates/default/docstring/html/note.erb +1 -1
data/templates/default/docstring/html/private.erb +1 -1
data/templates/default/docstring/html/todo.erb +1 -1
data/templates/default/docstring/setup.rb +2 -2
data/templates/default/fulldoc/html/css/full_list.css +4 -2
data/templates/default/fulldoc/html/css/style.css +50 -44
data/templates/default/fulldoc/html/frames.erb +21 -6
data/templates/default/fulldoc/html/full_list.erb +5 -3
data/templates/default/fulldoc/html/{full_list_files.erb → full_list_file.erb} +0 -0
data/templates/default/fulldoc/html/js/app.js +29 -26
data/templates/default/fulldoc/html/js/full_list.js +9 -9
data/templates/default/fulldoc/html/js/jquery.js +4 -16
data/templates/default/fulldoc/html/setup.rb +42 -38
data/templates/default/layout/dot/header.erb +1 -1
data/templates/default/layout/html/breadcrumb.erb +6 -6
data/templates/default/layout/html/files.erb +1 -1
data/templates/default/layout/html/footer.erb +1 -1
data/templates/default/layout/html/headers.erb +3 -6
data/templates/default/layout/html/index.erb +1 -1
data/templates/default/layout/html/layout.erb +3 -7
data/templates/default/layout/html/objects.erb +1 -1
data/templates/default/layout/html/script_setup.erb +5 -0
data/templates/default/layout/html/search.erb +4 -1
data/templates/default/layout/html/setup.rb +8 -8
data/templates/default/method_details/html/method_signature.erb +10 -3
data/templates/default/method_details/setup.rb +1 -0
data/templates/default/module/dot/info.erb +1 -1
data/templates/default/module/dot/setup.rb +2 -2
data/templates/default/module/html/attribute_details.erb +1 -1
data/templates/default/module/html/children.erb +1 -1
data/templates/default/module/html/defines.erb +1 -1
data/templates/default/module/html/inherited_methods.erb +5 -4
data/templates/default/module/html/item_summary.erb +15 -5
data/templates/default/module/html/method_details_list.erb +2 -2
data/templates/default/module/setup.rb +25 -12
data/templates/default/module/text/setup.rb +1 -1
data/templates/default/onefile/html/layout.erb +1 -1
data/templates/default/onefile/html/setup.rb +2 -2
data/templates/default/tags/html/example.erb +4 -2
data/templates/default/tags/html/option.erb +1 -1
data/templates/default/tags/html/overload.erb +1 -1
data/templates/default/tags/html/see.erb +1 -1
data/templates/default/tags/html/tag.erb +1 -1
data/templates/default/tags/setup.rb +4 -3
data/templates/guide/fulldoc/html/css/style.css +8 -8
data/templates/guide/fulldoc/html/js/app.js +6 -6
data/templates/guide/fulldoc/html/setup.rb +12 -12
data/templates/guide/layout/html/layout.erb +11 -11
data/templates/guide/layout/html/setup.rb +9 -9
data/templates/guide/method/html/header.erb +2 -2
data/templates/guide/method/html/setup.rb +1 -1
metadata +68 -18
data/bin/yard-graph +0 -4
data/bin/yard-server +0 -4
data/docs/Glossary.md +0 -12
data/lib/yard/handlers/ruby/legacy/macro_handler.rb +0 -39
data/lib/yard/handlers/ruby/macro_handler.rb +0 -40
data/lib/yard/handlers/ruby/macro_handler_methods.rb +0 -131
data/lib/yard/parser/c_parser.rb +0 -497
data/lib/yard/server/templates/default/layout/html/headers.erb +0 -16
data/lib/yard/server/templates/doc_server/frames/html/frames.erb +0 -13
data/lib/yard/server/templates/doc_server/frames/html/setup.rb +0 -3
data/lib/yard/server/templates/doc_server/full_list/html/full_list.erb +0 -34
data/lib/yard/server/templates/doc_server/full_list/html/setup.rb +0 -20
data/spec/handlers/examples/macro_handler_001.rb.txt +0 -83

data/spec/templates/examples/method004.html CHANGED Viewed

@@ -10,20 +10,20 @@
 <div class="method_details_list">
   <div id="method_details">
     <div class="method_details first">
-  <p class="signature first" id="m-instance_method">
-    - (<tt>void</tt>) <strong>m</strong>(*args)
+  <h3 class="signature first" id="m-instance_method">
-</p><div class="docstring">
+    - (<tt>void</tt>) <strong>m</strong>(*args)
+</h3><div class="docstring">
   <div class="discussion">
     <p class="note returns_void">This method returns an undefined value.</p>
   </div>
 </div>
 <div class="tags">
 </div><table class="source_code">
   <tr>
     <td>

data/spec/templates/examples/method005.html CHANGED Viewed

@@ -10,28 +10,28 @@
 <div class="method_details_list">
   <div id="method_details">
     <div class="method_details first">
-  <p class="signature first" id="m-instance_method">
+  <h3 class="signature first" id="m-instance_method">
       <span class="overload">- (<tt>void</tt>) <strong>m</strong>(a) </span>
       <span class="overload">- <strong>m</strong>(b) </span>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
   </div>
 </div>
 <div class="tags">
-  <h3>Overloads:</h3>
+  <p class="tag_title">Overloads:</p>
   <ul class="overload">
       <li class="overload_item">
         <span class="signature">- (<tt>void</tt>) <strong>m</strong>(a) </span>
         <div class="docstring">
@@ -41,42 +41,42 @@
   </div>
 </div>
 <div class="tags">
 </div>
       </li>
       <li class="overload_item">
         <span class="signature">- <strong>m</strong>(b) </span>
         <div class="docstring">
   <div class="discussion">
   </div>
 </div>
 <div class="tags">
-  <h3>Parameters:</h3>
+  <p class="tag_title">Parameters:</p>
 <ul class="param">
     <li>
         <span class='name'>b</span>
         <span class='type'>(<tt>String</tt>)</span>
         &mdash;
         <div class='inline'>hi</div>
     </li>
 </ul>
 </div>
       </li>
   </ul>
 </div><table class="source_code">

data/spec/templates/examples/module001.html CHANGED Viewed

@@ -1,29 +1,29 @@
 <h1>Module: A
 </h1>
 <dl class="box">
       <dt class="r1">Includes:</dt>
       <dd class="r1">B, BaseMod</dd>
     <dt class="r2">Included in:</dt>
     <dd class="r2">TMP, TMP2</dd>
     <dt class="r1 last">Defined in:</dt>
     <dd class="r1 last">(stdin)</dd>
 </dl>
 <div class="clear"></div>
@@ -34,24 +34,24 @@
   </div>
 </div>
 <div class="tags">
 </div><h2>Defined Under Namespace</h2>
 <p class="children">
       <strong class="modules">Modules:</strong> Z
       <strong class="classes">Classes:</strong> Q, X, Y
 </p>
   <h2>Constant Summary</h2>
     <dl class="constants">
         <dt id="CONSTANT-constant" class="">CONSTANT =
           <div class="docstring">
   <div class="discussion">
@@ -61,11 +61,11 @@ and newlines.
   </div>
 </div>
 <div class="tags">
 </div>
         </dt>
         <dd><pre class="code">'value'</pre></dd>
         <dt id="cvar-classvariable" class="deprecated">@@cvar =
           <div class="docstring">
   <div class="discussion">
@@ -75,302 +75,302 @@ and newlines.
   </div>
 </div>
 <div class="tags">
 </div>
         </dt>
         <dd><pre class="code">'value'</pre></dd>
     </dl>
   <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
   <ul class="summary">
       <li class="public ">
   <span class="summary_signature">
       <a  title="#attr1 (instance method)">- <strong>attr1</strong> </a>
   </span>
     <span class="summary_desc"><div class='inline'>Returns the value of attribute attr1.</div></span>
 </li>
       <li class="public ">
   <span class="summary_signature">
       <a  title="#attr2 (instance method)">- <strong>attr2</strong> </a>
   </span>
     <span class="note title readonly">readonly</span>
     <span class="summary_desc"><div class='inline'>Returns the value of attribute attr2.</div></span>
 </li>
       <li class="public ">
   <span class="summary_signature">
       <a  title="#attr3 (instance method)">- <strong>attr3</strong> </a>
   </span>
     <span class="summary_desc"><div class='inline'></div></span>
 </li>
       <li class="public ">
   <span class="summary_signature">
       <a  title="#attr4= (instance method)">- <strong>attr4</strong> </a>
   </span>
     <span class="note title writeonly">writeonly</span>
     <span class="summary_desc"><div class='inline'>Sets the attribute attr4.</div></span>
 </li>
   </ul>
   <h3 class="inherited">Attributes included from BaseMod</h3>
   <p class="inherited">#base_attr1, #base_attr2, #base_attr3</p>
     <h2>
       Class Method Summary
       <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
     </h2>
     <ul class="summary">
         <li class="public ">
   <span class="summary_signature">
       <a  title="a (class method)">+ <strong>a</strong> </a>
   </span>
     <span class="summary_desc"><div class='inline'></div></span>
 </li>
     </ul>
     <h2>
       Instance Method Summary
       <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
     </h2>
     <ul class="summary">
         <li class="public ">
   <span class="summary_signature">
       <a  title="#a (instance method)">- <strong>a</strong> </a>
       (also: #b)
   </span>
     <span class="summary_desc"><div class='inline'></div></span>
 </li>
         <li class="public ">
   <span class="summary_signature">
       <a  title="#test_multi_overload (instance method)">- <strong>test_multi_overload</strong>(*args) </a>
   </span>
     <span class="summary_desc"><div class='inline'></div></span>
 </li>
         <li class="public ">
   <span class="summary_signature">
       <a  title="#test_overload (instance method)">- <strong>test_overload</strong>(a) </a>
   </span>
     <span class="summary_desc"><div class='inline'>hello2.</div></span>
 </li>
         <li class="public ">
   <span class="summary_signature">
       <a  title="#void_meth (instance method)">- <strong>void_meth</strong> </a>
   </span>
     <span class="summary_desc"><div class='inline'></div></span>
 </li>
     </ul>
   <h3 class="inherited">Methods included from B</h3>
   <p class="inherited">#c, #d</p>
   <div id="instance_attr_details" class="attr_details">
     <h2>Instance Attribute Details</h2>
       <span id="attr1=-instance_method"></span>
       <span id="attr1-instance_method"></span>
       <div class="method_details first">
-  <p class="signature first" id="attr1-instance_method">
-    - <strong>attr1</strong>
+  <h3 class="signature first" id="attr1-instance_method">
+    - <strong>attr1</strong>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
     Returns the value of attribute attr1
   </div>
 </div>
 <div class="tags">
 </div><table class="source_code">
   <tr>
     <td>
@@ -391,25 +391,25 @@ end</pre>
   </tr>
 </table>
 </div>
       <span id=""></span>
       <span id="attr2-instance_method"></span>
       <div class="method_details ">
-  <p class="signature " id="attr2-instance_method">
+  <h3 class="signature " id="attr2-instance_method">
     - <strong>attr2</strong>  <span class="extras">(readonly)</span>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
     Returns the value of attribute attr2
   </div>
 </div>
 <div class="tags">
 </div><table class="source_code">
   <tr>
     <td>
@@ -430,33 +430,33 @@ end</pre>
   </tr>
 </table>
 </div>
       <span id="attr3=-instance_method"></span>
       <span id="attr3-instance_method"></span>
       <div class="method_details ">
-  <p class="signature " id="attr3-instance_method">
+  <h3 class="signature " id="attr3-instance_method">
       <span class="overload">- (<tt>String</tt>) <strong>attr3</strong> </span>
       <span class="overload">- <strong>attr3=</strong>(value) </span>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
   </div>
 </div>
 <div class="tags">
-  <h3>Overloads:</h3>
+  <p class="tag_title">Overloads:</p>
   <ul class="overload">
       <li class="overload_item">
         <span class="signature">- (<tt>String</tt>) <strong>attr3</strong> </span>
         <div class="docstring">
@@ -466,27 +466,27 @@ end</pre>
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  <p class="tag_title">Returns:</p>
 <ul class="return">
     <li>
         <span class='type'>(<tt>String</tt>)</span>
         &mdash;
         <div class='inline'>a string</div>
     </li>
 </ul>
 </div>
       </li>
       <li class="overload_item">
         <span class="signature">- <strong>attr3=</strong>(value) </span>
         <div class="docstring">
@@ -496,28 +496,28 @@ end</pre>
   </div>
 </div>
 <div class="tags">
-  <h3>Parameters:</h3>
+  <p class="tag_title">Parameters:</p>
 <ul class="param">
     <li>
         <span class='name'>value</span>
         <span class='type'>(<tt>String</tt>)</span>
         &mdash;
         <div class='inline'>sets the string</div>
     </li>
 </ul>
 </div>
       </li>
   </ul>
 </div><table class="source_code">
@@ -540,41 +540,41 @@ end</pre>
   </tr>
 </table>
 </div>
       <span id="attr4=-instance_method"></span>
       <span id=""></span>
       <div class="method_details ">
-  <p class="signature " id="attr4=-instance_method">
+  <h3 class="signature " id="attr4=-instance_method">
     - <strong>attr4=</strong>(value)  <span class="extras">(writeonly)</span>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
     Sets the attribute attr4
   </div>
 </div>
 <div class="tags">
-  <h3>Parameters:</h3>
+  <p class="tag_title">Parameters:</p>
 <ul class="param">
     <li>
         <span class='name'>value</span>
         <span class='type'></span>
         &mdash;
         <div class='inline'>the value to set the attribute attr4 to.</div>
     </li>
 </ul>
 </div><table class="source_code">
@@ -597,22 +597,22 @@ end</pre>
   </tr>
 </table>
 </div>
   </div>
   <div id="class_method_details" class="method_details_list">
     <h2>Class Method Details</h2>
       <div class="method_details first">
-  <p class="signature first" id="a-class_method">
-    + <strong>a</strong>
+  <h3 class="signature first" id="a-class_method">
-</p><table class="source_code">
+    + <strong>a</strong>
+</h3><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
@@ -628,25 +628,25 @@ def self.a; end</pre>
   </tr>
 </table>
 </div>
   </div>
   <div id="instance_method_details" class="method_details_list">
     <h2>Instance Method Details</h2>
       <div class="method_details first">
-  <p class="signature first" id="a-instance_method">
-    - <strong>a</strong>
+  <h3 class="signature first" id="a-instance_method">
+    - <strong>a</strong>
     <span class="aliases">Also known as:
     <span class="names"><span id='b-instance_method'>b</span></span>
     </span>
-</p><table class="source_code">
+</h3><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
@@ -662,26 +662,26 @@ def a; end</pre>
   </tr>
 </table>
 </div>
       <div class="method_details ">
-  <p class="signature " id="test_multi_overload-instance_method">
+  <h3 class="signature " id="test_multi_overload-instance_method">
       <span class="overload">- <strong>test_multi_overload</strong>(a) </span>
       <span class="overload">- <strong>test_multi_overload</strong>(a, b) </span>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
   </div>
 </div>
 <div class="tags">
 </div><table class="source_code">
   <tr>
     <td>
@@ -698,22 +698,22 @@ def test_multi_overload(*args) end</pre>
   </tr>
 </table>
 </div>
       <div class="method_details ">
-  <p class="signature " id="test_overload-instance_method">
-    - <strong>test_overload</strong>(a)
+  <h3 class="signature " id="test_overload-instance_method">
+    - <strong>test_overload</strong>(a)
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
   </div>
 </div>
 <div class="tags">
   <div class="docstring">
   <div class="discussion">
     hello2
@@ -721,23 +721,23 @@ def test_multi_overload(*args) end</pre>
   </div>
 </div>
 <div class="tags">
-  <h3>Parameters:</h3>
+  <p class="tag_title">Parameters:</p>
 <ul class="param">
     <li>
         <span class='name'>a</span>
         <span class='type'>(<tt>String</tt>)</span>
         &mdash;
         <div class='inline'>hi</div>
     </li>
 </ul>
 </div>
@@ -758,22 +758,22 @@ def test_overload(*args) end</pre>
   </tr>
 </table>
 </div>
       <div class="method_details ">
-  <p class="signature " id="void_meth-instance_method">
-    - <strong>void_meth</strong>
+  <h3 class="signature " id="void_meth-instance_method">
+    - <strong>void_meth</strong>
-</p><div class="docstring">
+</h3><div class="docstring">
   <div class="discussion">
     <p class="note returns_void">This method returns an undefined value.</p>
   </div>
 </div>
 <div class="tags">
 </div><table class="source_code">
   <tr>
     <td>
@@ -790,6 +790,6 @@ def void_meth; end</pre>
   </tr>
 </table>
 </div>
   </div>