# HG changeset patch
# User Sverre Rabbelier <srabbelier@gmail.com>
# Date 1221168608 0
# Node ID 63248d9db484c4114013b3e9a86ef49fd3866401
# Parent  d9543d181c370e65c0d3415260df005a32a96f80
Updated the script to:
* Include a comment describing what it does
* Use variables for anything non-standard
* Use the --parse-only flag of epydoc
* Exclude all 'django' modules through --exclude=
* Run on '../app' by default, no more arguments needed
* Clean up the output directory before running

diff -r d9543d181c37 -r 63248d9db484 scripts/build_epydocs.sh
--- a/scripts/build_epydocs.sh	Thu Sep 11 20:50:58 2008 +0000
+++ b/scripts/build_epydocs.sh	Thu Sep 11 21:30:08 2008 +0000
@@ -1,10 +1,27 @@
 #!/bin/bash
+# Generates epydoc for $target to $outdir, while ignoring $exclude
+# WARNING: The contents of $outdir are -deleted- before the running epydoc
+# This way there are no 'stale files' when the script finishes.
+
+ outdir="../../wiki/html/epydoc"
+ target="../app ../tests"
+exclude="django"
+
+echo "Cleaning out $outdir..."
+rm -f $outdir/*
+echo "Done."
+echo
 
 echo "Running epydoc..."
-echo $1
+echo "$target -> $outdir"
+echo "================="
 
 epydoc --html -v --show-private --inheritance=included --graph=all \
-  -o ../../wiki/html/epydoc $1
+  --parse-only --exclude=$exclude -o $outdir $target
 
+echo "================="
 echo "Done."
+echo
 
+echo "Goodbye."
+