From ef7d968fe0208f224b0d54008c9f1a8966ae7291 Mon Sep 17 00:00:00 2001
From: Mike Gerwitz <gerwitzm@lovullo.com>
Date: Fri, 19 Dec 2014 14:30:37 -0500
Subject: [PATCH] Proper handling of non-docblock comments

---
 src/xsltexi.xsl | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/src/xsltexi.xsl b/src/xsltexi.xsl
index 0efc5da..ab1ea09 100644
--- a/src/xsltexi.xsl
+++ b/src/xsltexi.xsl
@@ -40,7 +40,8 @@
 -->
 <template match="xsl:stylesheet|xsl:transform">
   <apply-templates mode="xt:doc-gen"
-                   select="preceding-sibling::comment()|*" />
+                   select="preceding-sibling::comment()
+                           |node()" />
 </template>
 
 
@@ -105,6 +106,22 @@
 </template>
 
 
+<!--
+  Determine whether the given comment node is a docblock
+-->
+<function name="xt:is-docblock" as="xs:boolean">
+  <param name="node" as="comment()" />
+
+  <variable name="next" as="node()?"
+            select="($node/following-sibling::*
+                    |$node/following-sibling::comment())[ 1 ]" />
+
+  <!-- FIXME: this will be a maintenance burden -->
+  <sequence select="$next instance of element( xsl:template )
+                    or $next instance of element( xsl:function )" />
+</function>
+
+
 <!--
   Echo comment blocks
 
@@ -124,6 +141,13 @@
 </template>
 
 
+<!--
+  Ignore docblock comments (handled in respective templates)
+-->
+<template mode="xt:doc-gen" priority="7"
+          match="comment()[ xt:is-docblock( . ) ]" />
+
+
 <!--
   Generate typed parameter list from @var{params}