diff --git a/doc/hoxsl.texi b/doc/hoxsl.texi
index b5761b2..eb1a7d8 100644
--- a/doc/hoxsl.texi
+++ b/doc/hoxsl.texi
@@ -41,6 +41,8 @@ Free Documentation License".
 @top Main
 @end ifnottex
 
+@include macros.texi
+
 @menu
 * Higher-Order Functions::  XSLT 2.0 compatible higher-order functions
 * License::                 Document License
diff --git a/doc/macros.texi b/doc/macros.texi
new file mode 100644
index 0000000..ce37996
--- /dev/null
+++ b/doc/macros.texi
@@ -0,0 +1,25 @@
+@c Hoxsl documentation macros
+@c
+@c These macros are used in the woven documentation.
+@c
+@c  Copyright (C) 2014, 2015 LoVullo Assoicates, Inc.
+@c
+@c  This program is free software: you can redistribute it and/or modify
+@c  it under the terms of the GNU General Public License as published by
+@c  the Free Software Foundation, either version 3 of the License, or
+@c  (at your option) any later version.
+@c
+@c  This program is distributed in the hope that it will be useful,
+@c  but WITHOUT ANY WARRANTY; without even the implied warranty of
+@c  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+@c  GNU General Public License for more details.
+@c
+@c  You should have received a copy of the GNU General Public License
+@c  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+@c
+
+@c XML comments cannot be nested, so this allows us to include comments
+@c within docblocks
+@macro xmlcomment{comment}
+<!-- \comment\ -->
+@end macro