integrating the examples in the navigation menus added make tests, updated

* doc/*: integrating the examples in the navigation menus
* doc/examples/*: added make tests, updated the navigation,
  added a new test, cleanups, updates.
Daniel
diff --git a/doc/examples/index.py b/doc/examples/index.py
index cbf66a0..be8b4e0 100755
--- a/doc/examples/index.py
+++ b/doc/examples/index.py
@@ -14,6 +14,7 @@
 
 examples = []
 extras = ['examples.xsl', 'index.py']
+tests = []
 sections = {}
 symbols = {}
 api_dict = None
@@ -110,6 +111,7 @@
     try:
         usage = info['usage']
 	output.write("    <usage>%s</usage>\n" % usage);
+	tests.append(usage)
     except:
         print "Example %s lacks an usage description" % (filename)
     try:
@@ -233,6 +235,10 @@
     for example in examples:
         Makefile = Makefile + "%s_SOURCES=%s.c\n%s_LDFLAGS=\n%s_DEPENDENCIES= $(DEPS)\n%s_LDADD= @RDL_LIBS@ $(LDADDS)\n\n" % (example, example, example,
 	       example, example)
+    Makefile = Makefile + "tests: $(noinst_PROGRAMS)\n"
+    for test in tests:
+        Makefile = Makefile + "\t%s\n" % (test)
+    Makefile = Makefile + "\n\n"
     try:
 	old = open("Makefile.am", "r").read()
 	if old != Makefile: