improved foocanvas doc generation

scripts/zmap_make_docs.sh

@@ -20,25 +20,32 @@ zmap_message_out "Running in $INITIAL_DIR on $(hostname) under $(uname)"
 
 zmap_message_out "cmd line options = '$*'"
 
-ZMAP_BUILD_CONTAINER=$1
-
-zmap_check ${ZMAP_BUILD_CONTAINER:=$INITIAL_DIR}
+zmap_cd $BASE_DIR
 
 zmap_goto_cvs_module_root 
 
+ZMAP_CHECKOUT_ROOT=$(pwd)
+
 zmap_cd src
 
 if [ "x$ZMAP_MASTER_BUILD_DOXYGEN_DOCS" == "x$ZMAP_TRUE" ]; then
     zmap_message_out "Running make docs ..."
 
+    # need to find a Makefile to run make against
+    MAKEFILE_LOC=$(find . -name Makefile | head -1)
+    SAVE_DIR=$(pwd)
+    zmap_cd $(dirname $MAKEFILE_LOC)
+
     make docs || zmap_message_exit "Failed making documentation."
+
+    zmap_cd $SAVE_DIR
 fi
 
 if [ "x$ENSCRIPT_EXE" != "x" ]; then
 
     zmap_check ${ENSCRIPT_OUTPUT_FLAG:=-w}
 
-    CANVAS_DOCS_OUT_DIR=$ZMAP_BUILD_CONTAINER/$FOOCANVAS_DOC_TARGET
+    CANVAS_DOCS_OUT_DIR=$ZMAP_CHECKOUT_ROOT/$FOOCANVAS_DOC_TARGET
     
     mkdir -p $CANVAS_DOCS_OUT_DIR || zmap_message_exit "Failed creating output directory."
     
@@ -60,14 +67,98 @@ if [ "x$ENSCRIPT_EXE" != "x" ]; then
 	zmap_cd $foo_headers_dir
     
 	foo_headers=`find . -name 'foo*.h'`
-    
+
+	touch $CANVAS_DOCS_OUT_DIR/this_links.ini
+	touch $CANVAS_DOCS_OUT_DIR/index.shtml
+
+	c=$(date "+%S%N")
+
+	cat > $CANVAS_DOCS_OUT_DIR/this_links.ini <<LINKS
+# Auto generated by $0
+Include$c=<<INC
+	<span class="barhead">Foocanvas Interface</span>
+INC
+LINKS
+
+cat > $CANVAS_DOCS_OUT_DIR/index.shtml <<SHTML
+<!-- Auto generated by $0. Do not edit! -->
+<!--#set var="banner" value="ZMap Developer Site"-->
+<!--#include virtual="/perl/header"-->
+<!--#set var="author" value="edgrif@sanger.ac.uk" -->
+
+<h5>FooCanvas Interface</h5>
+
+<p>Documentation for the FooCanvas Interface generated by enscript.
+<pre>
+$ENSCRIPT_EXE --color $ENSCRIPT_OUTPUT_FLAG html -Ec -o [FILENAME].shtml [FILENAME]
+</pre>
+</p>
+
+<ul>
+SHTML
+
+
+# -------------------------------------------------------- #
+# Create the html pages and the navigation for them        #
+# -------------------------------------------------------- #
+
 	for header in $foo_headers ;
 	  do
 	  header=$(basename $header)
 	  zmap_message_out "Creating enscript doc for FooCanvas file $header"
 	  $ENSCRIPT_EXE --color $ENSCRIPT_OUTPUT_FLAG html -Ec -o $CANVAS_DOCS_OUT_DIR/$header.shtml $header || zmap_message_exit "Failed to $enscript $header"
+
+	  (cat - $CANVAS_DOCS_OUT_DIR/$header.shtml <<SHTML
+<!-- Automatically added by $0. Do not edit! -->
+<!-- $ENSCRIPT_EXE generated most of this file. Do not edit! -->
+<!--#include virtual="/perl/header"-->
+<!--#set var="author" value="edgrif@sanger.ac.uk" -->
+SHTML
+) > tmp && mv tmp $CANVAS_DOCS_OUT_DIR/$header.shtml
+
+	  perl -i -lne 'print if !/HTML/'  $CANVAS_DOCS_OUT_DIR/$header.shtml
+	  perl -i -lne 'print if !/HEAD/'  $CANVAS_DOCS_OUT_DIR/$header.shtml
+	  perl -i -lne 'print if !/TITLE/' $CANVAS_DOCS_OUT_DIR/$header.shtml
+	  perl -i -lne 'print if !/BODY/'  $CANVAS_DOCS_OUT_DIR/$header.shtml
+	  perl -i -lne 'print if !/NAME/'  $CANVAS_DOCS_OUT_DIR/$header.shtml
+
+	  cat >> $CANVAS_DOCS_OUT_DIR/this_links.ini <<LINKS
+$header=$header.shtml
+LINKS
+
+	  cat >> $CANVAS_DOCS_OUT_DIR/index.shtml <<SHTML
+  <li><a href="$header.shtml">$header</a></li>
+SHTML
+
+	  cat >> $CANVAS_DOCS_OUT_DIR/$header.shtml <<SHTML
+<!-- Automatically added by $0. Do not edit! -->
+
+<p>Authors: <a href="mailto:edgrif@sanger.ac.uk">Ed Griffiths &lt;edgrif@sanger.ac.uk&gt;</a>
+&amp; <a href="mailto:rds@sanger.ac.uk">Roy Storey &lt;rds@sanger.ac.uk&gt;</a>
+<p>
+<!--#include virtual="/perl/footer"-->
+SHTML
+
+
 	done
     
+
+
+
+
+
+cat >> $CANVAS_DOCS_OUT_DIR/index.shtml <<SHTML
+<!-- Automatically added by $0. Do not edit! -->
+
+</ul>
+
+<p>Authors: <a href="mailto:edgrif@sanger.ac.uk">Ed Griffiths &lt;edgrif@sanger.ac.uk&gt;</a>
+&amp; <a href="mailto:rds@sanger.ac.uk">Roy Storey &lt;rds@sanger.ac.uk&gt;</a>
+<p>
+<!--#include virtual="/perl/footer"-->
+SHTML
+
+
 	zmap_cd $this_dir
     else
 	zmap_message_err "Failed to find libfoocanvas directory under $GTK_PREFIX/include. Is it installed there?"