Changed the documentation structure

.gitignore

@@ -3,5 +3,3 @@ archived
 Makefile.local.mk
 test/test_*
 nbproject
-docs/*.html
-docs/index.txt

docs/.gitignore

@@ -0,0 +1,2 @@
+*.html
+index.txt

docs/Makefile

@@ -1,9 +1,8 @@
 
 ASCIIDOC = asciidoc
 
-SOURCE_DOCS = $(subst index.txt,,$(wildcard *.txt))
+DOCS = $(filter-out index.txt, $(wildcard *.txt))
-
+TECH_DOCS = $(filter-out technical/index.txt, $(wildcard technical/*.txt))
-HTML_DOCS = index.html $(patsubst %.txt,%.html,$(SOURCE_DOCS))
 
 ifndef VERBOSE
 	QUIET_ASCIIDOC = @echo '   ' GEN $@;
@@ -12,13 +11,17 @@ endif
 
 .PHONY : clean
 all : html
-html : $(HTML_DOCS)
+html : index.html
+technical : technical/index.html
 
 %.html : %.txt
 	$(QUIET_ASCIIDOC)$(ASCIIDOC) -b xhtml11 -o $@ $<
 
-index.txt : $(SOURCE_DOCS)
+index.txt : $(patsubst %.txt,%.html,$(DOCS))
 	$(QUIET_SCRIPT)$(shell ./genindex.sh index.txt)
 
+technical/index.txt : $(patsubst %.txt,%.html,$(TECH_DOCS))
+	$(QUIET_SCRIPT)cd technical && ./genindex.sh index.txt
+
 clean :
-	$(RM) index.txt *.html
+	$(RM) index.txt *.html technical/index.txt technical/*.html

docs/technical/.gitignore

@@ -0,0 +1,2 @@
+*.html
+index.txt

docs/technical/genindex.sh

@@ -0,0 +1,21 @@
+
+#!/bin/sh
+
+if [ $# -lt 1 ]; then
+    exit 1
+fi
+
+(
+    echo "Archived API Documentation"
+    echo "--------------------------"
+
+    for DOC in `ls *.txt`; do
+        if [ "$DOC" = "$1" ]; then
+            continue
+        fi
+        display=$(sed -e 1q "${DOC}")
+        link=${DOC%.txt}.html
+        echo "* link:${link}[${display}]"
+    done
+
+) > $1