Support deprecated tag

Author: tmcw

default_theme/section._

@@ -24,7 +24,7 @@
       <%= formatType(section.type) %>
     </p>
   <% } %>
-  <% if (section.augments) { %>
+  <% if (section.augments.length) { %>
     <p>
       Extends
       <% if (section.augments) { %>
@@ -35,13 +35,14 @@
     </p>
   <% } %>
 
+  <% if (section.deprecated) { %><div>Deprecated: <%= md(section.deprecated, true) %></div><% }%>
   <% if (section.version) { %><div>Version: <%- section.version %></div><% }%>
   <% if (section.license) { %><div>License: <%- section.license %></div><% }%>
   <% if (section.author) { %><div>Author: <%- section.author %></div><% }%>
-  <% if (section.copyright) { %><div>Copyright: <%- section.copyright %></div><% }%>
+  <% if (section.copyright) { %><div>Copyright: <%= md(section.copyright, true) %></div><% }%>
   <% if (section.since) { %><div>Since: <%- section.since %></div><% }%>
 
-  <% if (section.params) { %>
+  <% if (section.params.length) { %>
     <div class='py1 quiet mt1 prose-big'>Parameters</div>
     <div class='prose'>
       <% section.params.forEach(function(param) { %>
@@ -81,7 +82,7 @@
     </div>
   <% } %>
 
-  <% if (section.properties) { %>
+  <% if (section.properties.length) { %>
     <div class='py1 quiet mt1 prose-big'>Properties</div>
     <div>
       <% section.properties.forEach(function(property) { %>
@@ -108,7 +109,7 @@
     </div>
   <% } %>
 
-  <% if (section.returns) { %>
+  <% if (section.returns.length) { %>
     <% section.returns.forEach(function(ret) { %>
       <div class='py1 quiet mt1 prose-big'>Returns</div>
       <code><%= formatType(ret.type) %></code><% if (ret.description) { %>:
@@ -117,7 +118,7 @@
     <% }) %>
   <% } %>
 
-  <% if (section.throws) { %>
+  <% if (section.throws.length) { %>
     <div class='py1 quiet mt1 prose-big'>Throws</div>
     <ul>
       <% section.throws.forEach(function(throws) { %>
@@ -126,7 +127,7 @@
     </ul>
   <% } %>
 
-  <% if (section.examples) { %>
+  <% if (section.examples.length) { %>
     <div class='py1 quiet mt1 prose-big'>Example</div>
     <% section.examples.forEach(function(example) { %>
       <% if (example.caption) { %><p><%= md(example.caption) %></p><% } %>

lib/output/markdown_ast.js

@@ -174,14 +174,14 @@ function buildMarkdownAST(comments/*: Array<Comment> */, config/*: Documentation
     }
 
     function metaSection(comment/*: Comment */) {
-      let meta = ['version', 'since', 'copyright', 'author', 'license']
+      let meta = ['version', 'since', 'copyright', 'author', 'license', 'deprecated']
         .filter(tag => comment[tag]);
       return !!meta.length && [u('strong', [u('text', 'Meta')])].concat(
         u('list', { ordered: false },
           meta
           .map(tag => {
             let metaContent;
-            if (tag === 'copyright') {
+            if (tag === 'copyright' || tag === 'deprecated') {
               metaContent = comment[tag];
             } else {
               metaContent = u('text', comment[tag]);

lib/parse.js

@@ -77,7 +77,11 @@ var flatteners = {
   'copyright': flattenMarkdownDescription,
   'default': todo,
   'defaultvalue': synonym('default'),
-  'deprecated': flattenMarkdownDescription,
+  deprecated(result, tag) {
+    let description = tag.description || 'This is deprecated.';
+    result.deprecated = parseMarkdown(description);
+  },
+  flattenMarkdownDescription,
   'desc': synonym('description'),
   'description': flattenMarkdownDescription,
   'emits': synonym('fires'),