API Docs

[Felix Meschberger <fm...@adobe.com>]

Hi

I played around a bit with JavaDoc generation now ...

I have generated a structure under /apidocs like this:

  /apidocs
     +-- index.html
     +-- configadmin
             +-- 1.0.0
             +-- 1.0.2
     +-- scr
     ....

The index.html file is automatically generated from a simple list:

   configadmin|Configuration Admin|/docurl.html
   ....

The versions are extracted from the folder and everything is put into a table at http://felix.apache.org/apidocs/

If even have a dead-simple script to create JavaDoc from existing releases:

> PROJECT=scr
> mkdir -p /usr/src/felix/site/trunk/content/apidocs/$PROJECT
> for name in org.apache.felix.$PROJECT-* ; do
>   VERSION=`echo $name | cut -f2 -d"-"`
>   cd $name
>   mvn -7 -DexcludePackageNames='*.impl:*.internal:' \
>       clean org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:javadoc
>   cp -a target/site/apidocs /usr/src/felix/site/trunk/content/apidocs/$PROJECT/$VERSION
>   cd -
> done


WDYT ?

Regards
Felix