Hi,
I'm trying to add both site and aggregate javadoc generation
nightly builds to GeoServer (I'll discuss site in a separate mail).
The javadoc generation should help people that try to contribute
to GeoServer and that are not used to use the IDE for javadoc
inspection (apparently there are still quite a few around)
plus help anyone interested in good docs to double check
how they actually look like.
For the javadocs I was thinking that adding them to the normal
nightly build is probably the quickest approach?
The following (un-tested) modification to the trunk nightly build should
do the trick:
----------------------------------------------------------------
ver=trunk
dist=/var/www/html/geoserver/$ver
datestamp=`date +%Y-%m-%d`
cd geoserver_trunk/src
mvn -DskipTests -P release clean install && mvn assembly:attached
mvn -P release javadoc:aggregate
cp target/release/geoserver*-war.zip $dist/geoserver-$ver-$datestamp-war.zip
cp target/release/geoserver*-bin.zip $dist/geoserver-$ver-$datestamp-bin.zip
cp target/release/geoserver*-war.zip $dist/geoserver-$ver-latest-war.zip
cp target/release/geoserver*-bin.zip $dist/geoserver-$ver-latest-bin.zip
# copy the extensions over
if [ ! -e $dist/ext-$datestamp ]; then
mkdir $dist/ext-$datestamp
fi
cp target/release/geoserver-*-plugin.zip $dist/ext-$datestamp
rm -rf $dist/ext-latest
mkdir $dist/ext-latest
cp target/release/geoserver-*-plugin.zip $dist/ext-latest
# copy the javadocs over
if [ ! -e $dist/apidocs-$datestamp ]; then
mkdir $dist/apidocs-$datestamp
fi
cp -r target/site/apidocs $dist/apidocs-$datestamp
rm -rf $dist/apidocs-latest
mkdir $dist/apidocs-latest
cp -r target/site/apidocs $dist/apidocs-latest
# remove older copies of the nightly build
find $dist -depth -name 'geoserver*bin.zip' -mtime +6 -exec rm {} \;
find $dist -depth -name 'geoserver*war.zip' -mtime +6 -exec rm {} \;
find $dist -depth -name 'ext-*' -type d -mtime +6 -exec rm -rf {} \;
find $dist -depth -name 'apidocs-*' -type d -mtime +6 -exec rm -rf {} \;
echo "Done"
----------------------------------------------------------------
I've checked the size of the apidocs, they should be around 55MB
including all the extensions.
What do you think, good to go?
Cheers
Andrea
--
Andrea Aime
OpenGeo - http://opengeo.org
Expert service straight from the developers.