3 files changed, 46 insertions, 2 deletions
diff --git a/docs/Makefile b/docs/Makefile
index f340323..355f0bc 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -3,11 +3,16 @@ TXT=$(wildcard *.txt)
 MAN=$(shell ls *.txt|xargs -n 1 head -n 1|sed "s,\(.*\)(\([0-9]\)),\1.\2,")
 HTML=$(patsubst %.txt,%.html,$(TXT))
 
-all: $(HTML) $(MAN)
+all: html man
+
+html: $(HTML)
+man: $(MAN)
+
+.PHONY: html man
 
 %.html: %.txt
 	@echo asciidoc $<
-	@asciidoc -f asciidoc.conf --backend=html5 $<
+	@asciidoc -f asciidoc.conf --backend=xhtml11 -aappsh_version=0.2-dev $<
 
 %.1: %.txt
 	$(call man,$<)
diff --git a/docs/appinternals.txt b/docs/appinternals.txt
index ce19923..330d151 100644
--- a/docs/appinternals.txt
+++ b/docs/appinternals.txt
@@ -5,6 +5,10 @@ NAME
 ----
 appinternals - Appsh internals
 
+SYNOPSIS
+--------
+appinternals
+
 DESCRIPTION
 -----------
 
diff --git a/docs/asciidoc.conf b/docs/asciidoc.conf
index 724524a..57eaf59 100644
--- a/docs/asciidoc.conf
+++ b/docs/asciidoc.conf
@@ -1,6 +1,31 @@
+# https://github.com/marcelocantos/zeromq2-1/blob/master/doc/asciidoc.conf
+# http://lxr.free-electrons.com/source/tools/perf/Documentation/asciidoc.conf
+
 [macros]
 (?su)[\\]?(?P<name>linkman):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
 
+ifdef::doctype-manpage[]
+ifdef::backend-docbook[]
+[header]
+template::[header-declarations]
+<refentry>
+  <refmeta>
+    <refentrytitle>{mantitle}</refentrytitle>
+    <manvolnum>{manvolnum}</manvolnum>
+    <refmiscinfo class="source">app.sh</refmiscinfo>
+    <!-- doesn't seem to have any effect
+    <refmiscinfo class="version">version={appsh_version}</refmiscinfo>
+    -->
+    <refmiscinfo class="manual">App.sh Manual</refmiscinfo>
+  </refmeta>
+  <refnamediv>
+    <refname>{manname}</refname>
+    <refpurpose>{manpurpose}</refpurpose>
+  </refnamediv>
+# No ending refentry, asciidoc takes care of that.
+endif::backend-docbook[]
+endif::doctype-manpage[]
+
 ifdef::backend-docbook[]
 [linkman-inlinemacro]
 {0%{target}}
@@ -18,3 +43,13 @@ relative-ext=.html
 <a href="{target}.html">{target}{0?({0})}</a>
 
 endif::backend-html5[]
+
+ifdef::backend-xhtml11[]
+
+[attributes]
+relative-ext=.html
+
+[linkman-inlinemacro]
+<a href="{target}.html">{target}{0?({0})}</a>
+
+endif::backend-xhtml11[]