Remove comment markup if it has no content

Author: sebastian-lenz

bin/themes/default/partials/comment.hbs

@@ -1,18 +1,22 @@
-<div class="tsd-comment tsd-typography">
-    {{#if comment.shortText}}
-        <div class="lead">
-            {{#markdown}}{{{comment.shortText}}}{{/markdown}}
+{{#with comment}}
+    {{#if hasVisibleComponent}}
+        <div class="tsd-comment tsd-typography">
+            {{#if comment.shortText}}
+                <div class="lead">
+                    {{#markdown}}{{{comment.shortText}}}{{/markdown}}
+                </div>
+            {{/if}}
+            {{#if comment.text}}
+                {{#markdown}}{{{comment.text}}}{{/markdown}}
+            {{/if}}
+            {{#if comment.tags}}
+                <dl class="tsd-comment-tags">
+                    {{#each comment.tags}}
+                        <dt>{{tagName}}</dt>
+                        <dd>{{#markdown}}{{{text}}}{{/markdown}}</dd>
+                    {{/each}}
+                </dl>
+            {{/if}}
         </div>
     {{/if}}
-    {{#if comment.text}}
-        {{#markdown}}{{{comment.text}}}{{/markdown}}
-    {{/if}}
-    {{#if comment.tags}}
-        <dl class="tsd-comment-tags">
-            {{#each comment.tags}}
-                <dt>{{tagName}}</dt>
-                <dd>{{#markdown}}{{{text}}}{{/markdown}}</dd>
-            {{/each}}
-        </dl>
-    {{/if}}
-</div>
+{{/with}}

src/typedoc/Settings.ts

@@ -1,12 +1,30 @@
 module TypeDoc
 {
+    /**
+     * Alias to TypeScript.LanguageVersion
+     *
+     * @resolve
+     */
+    export var CodeGenTarget = TypeScript.LanguageVersion;
+
+    /**
+     * Alias to TypeScript.ModuleGenTarget
+     *
+     * @resolve
+     */
+    export var ModuleGenTarget = TypeScript.ModuleGenTarget;
+
+
     /**
      * Holds all settings used by TypeDoc.
      */
     export class Settings
     {
         /**
          * The settings used by the TypeScript compiler.
+         *
+         * @see [[CodeGenTarget]]
+         * @see [[ModuleGenTarget]]
          */
         compiler:TypeScript.CompilationSettings;
 

src/typedoc/models/comments/Comment.ts

@@ -40,6 +40,16 @@ module TypeDoc.Models
         }
 
 
+        /**
+         * Has this comment a visible component?
+         *
+         * @returns TRUE when this comment has a visible component.
+         */
+        hasVisibleComponent():boolean {
+            return <boolean>(this.shortText || this.text || this.tags);
+        }
+
+
         /**
          * Test whether this comment contains a tag with the given name.
          *

src/typedoc/models/reflections/BaseReflection.ts

@@ -220,7 +220,7 @@ module TypeDoc.Models
          * @returns TRUE when this reflection has a visible comment.
          */
         hasComment():boolean {
-            return <boolean>(this.comment && (this.comment.shortText || this.comment.text || this.comment.tags));
+            return <boolean>(this.comment && this.comment.hasVisibleComponent());
         }