From d95cbdd9c95fedec3a989fbb61e50b41c1eb011f Mon Sep 17 00:00:00 2001
From: Jeff Williams <jeffrey.l.williams@gmail.com>
Date: Fri, 7 Jul 2017 19:48:08 -0700
Subject: [PATCH] support namespaces that are also functions (#955)

---
 templates/default/publish.js                      |  6 ++++++
 templates/default/static/styles/jsdoc-default.css |  4 ++--
 templates/default/tmpl/container.tmpl             | 11 ++++++-----
 templates/default/tmpl/method.tmpl                |  2 ++
 4 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/templates/default/publish.js b/templates/default/publish.js
index a7e80fd6..d62c8a47 100644
--- a/templates/default/publish.js
+++ b/templates/default/publish.js
@@ -66,6 +66,12 @@ function needsSignature(doclet) {
             }
         }
     }
+    // and namespaces that are functions get a signature (but finding them is a
+    // bit messy)
+    else if (doclet.kind === 'namespace' && doclet.meta && doclet.meta.code &&
+        doclet.meta.code.type && doclet.meta.code.type.match(/[Ff]unction/)) {
+        needsSig = true;
+    }
 
     return needsSig;
 }
diff --git a/templates/default/static/styles/jsdoc-default.css b/templates/default/static/styles/jsdoc-default.css
index c4238bca..9207bc82 100644
--- a/templates/default/static/styles/jsdoc-default.css
+++ b/templates/default/static/styles/jsdoc-default.css
@@ -222,8 +222,8 @@ thead tr
 th { border-right: 1px solid #aaa; }
 tr > th:last-child { border-right: 1px solid #ddd; }
 
-.ancestors { color: #999; }
-.ancestors a
+.ancestors, .attribs { color: #999; }
+.ancestors a, .attribs a
 {
     color: #999 !important;
     text-decoration: none;
diff --git a/templates/default/tmpl/container.tmpl b/templates/default/tmpl/container.tmpl
index 4bbe3e26..7491fd42 100644
--- a/templates/default/tmpl/container.tmpl
+++ b/templates/default/tmpl/container.tmpl
@@ -21,13 +21,14 @@
 
 <header>
     <?js if (!doc.longname || doc.kind !== 'module') { ?>
-        <h2><?js if (doc.ancestors && doc.ancestors.length) { ?>
+        <h2><?js if (doc.attribs) { ?><span class="attribs"><?js= doc.attribs ?></span><?js }
+            if (doc.ancestors && doc.ancestors.length) { ?>
             <span class="ancestors"><?js= doc.ancestors.join('') ?></span><?js
-         } 
+         }
         ?><?js= doc.name ?><?js
          if (doc.variation) { ?>
-            <sup class="variation"><?js= doc.variation ?></sup>
-        <?js } ?></h2>
+            <sup class="variation"><?js= doc.variation ?></sup><?js }
+         if (doc.signature) { ?><?js= doc.signature ?><?js } ?></h2>
         <?js if (doc.classdesc) { ?>
             <div class="class-description"><?js= doc.classdesc ?></div>
         <?js } ?>
@@ -50,7 +51,7 @@
         <?js doc.modules.forEach(function(module) { ?>
             <?js= self.partial('method.tmpl', module) ?>
         <?js }) ?>
-    <?js } else if (doc.kind === 'class') { ?>
+    <?js } else if (doc.kind === 'class' || (doc.kind === 'namespace' && doc.signature)) { ?>
         <?js= self.partial('method.tmpl', doc) ?>
     <?js } else { ?>
         <?js if (doc.description) { ?>
diff --git a/templates/default/tmpl/method.tmpl b/templates/default/tmpl/method.tmpl
index e4884c8d..4dd6e0b0 100644
--- a/templates/default/tmpl/method.tmpl
+++ b/templates/default/tmpl/method.tmpl
@@ -7,8 +7,10 @@ var self = this;
     <h2>Constructor</h2>
     <?js } ?>
 
+    <?js if (data.kind !== 'namespace') { ?>
     <h4 class="name" id="<?js= id ?>"><?js= data.attribs + (kind === 'class' ? 'new ' : '') +
     name + (data.signature || '') ?></h4>
+    <?js } ?>
 
     <?js if (data.summary) { ?>
     <p class="summary"><?js= summary ?></p>