# HG changeset patch
# User Chris Cannam <chris.cannam@soundsoftware.ac.uk>
# Date 1296578605 0
# Node ID c1e9f2dab1d545d9081b035b657b7b29f568ce24
# Parent  170b8a96b2133cef4e02d9f9c8d096115c0417c0
* Start on script for extracting Doxygen/Javadoc

diff -r 170b8a96b213 -r c1e9f2dab1d5 extra/soundsoftware/extract-javadoc.sh
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/extra/soundsoftware/extract-javadoc.sh	Tue Feb 01 16:43:25 2011 +0000
@@ -0,0 +1,37 @@
+#!/bin/sh
+
+# Run this script from /var/doc/<project-name>
+
+# Find Hg repo and update it
+
+docdir=$(pwd)
+name=$(basename $(pwd))
+hgdir="/var/hg/$name"
+echo "Extracting doc for $name"
+if [ ! -d "$hgdir" ]; then
+   echo "Error: No $hgdir found for project $name"
+   exit 1
+fi
+( cd "$hgdir" ; hg update ) || exit 1
+
+# Identify either a Doxyfile or some Java packages
+
+# TODO: Doxyfile
+
+
+# This is very rough; check what is actually permitted for package
+# declarations
+
+java_packages=`find "$hgdir" -type f -name \*.java -print | \
+     xargs grep -h '^ *package [a-zA-Z][a-zA-Z0-9\._-]* *; *' | sort | uniq | \
+     sed -e 's/^ *package //' -e 's/ *; *$//'`
+
+echo "This project contains java packages:"
+echo "$java_packages"
+
+# This won't work if code is in a subdir, e.g. src/com/example/project/Hello.java
+
+javadoc -sourcepath "$hgdir" -d . -subpackages $java_packages -verbose
+
+# If we have just written something to a doc directory that was
+# previously empty, we should switch on Embedded for this project