added some comments regarding the generation of the dependencies diagram and the pom template files
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/batik/branches/submodules_cyclic_deps@1664016 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/builddeps.sh b/builddeps.sh
index 944bc44..29d1b15 100755
--- a/builddeps.sh
+++ b/builddeps.sh
@@ -1,4 +1,8 @@
#!/bin/bash
+# This scripts generates a diagram of the dependencies between the different jars.
+# To run it both jdeps (comes with jdk 1.8) and dot (comes with graphviz) need to
+# be present. The diagram, batik-jars-deps.svg, can be found in the checkdeps folder.
+# NOTE: Before running the script run "ant jars maven-artifacts".
rm -rf checkdeps
mkdir checkdeps
ls -l batik-svn-trunk/maven/batik-*/*/*.jar | awk '{printf("cp %s checkdeps/\n", $9)}' > cp.sh
diff --git a/buildpom.sh b/buildpom.sh
index a4a3d76..3aa6c0c 100755
--- a/buildpom.sh
+++ b/buildpom.sh
@@ -1,4 +1,5 @@
#!/bin/bash
+# See buildpoms script. This is an auxiliar script used by buildpoms.sh.
desc="Batik module description"
case "$1" in
'batik-anim')
diff --git a/buildpoms.sh b/buildpoms.sh
index a81e45e..1ee98ba 100755
--- a/buildpoms.sh
+++ b/buildpoms.sh
@@ -1,4 +1,8 @@
#!/bin/bash
+# This script is used to generate the pom files needed to build the maven jars.
+# After running the script the new pom template files are in the checkpoms directory;
+# check them and if they look OK move them to the sources directory. Note that
+# this script runs builddeps first.
./builddeps.sh
rm -rf checkpoms
mkdir checkpoms
