Java doc fixes

Multiple Javadoc fixes to make 

*mvn javadoc:javadoc* 

work again in the args4j project. In the state before, the mvn target refused to build the Javadoc API docs.
There are a bunch of smaller issues that are fixed by this pull request.