Javadoc comments lead to warnings and they are not Java 8 compatible

[swesemeyer]

building the current master branch results in a failed build for the javadocs.

[prasser]

Dear swesemeyer,

thanks for your interest in ARX and for reporting this issue!

We cannot reproduce the problem. On our machines everything works just fine. Can you please provide us with more details about the errors that you are seeing?

Thanks Fabian

[swesemeyer]

Hiya,

The attached log shows the output I get on my setup. This is on Xubuntu 16.04.1 with

arxtester@hattest:~/Downloads/arx$ java -version java version "1.8.0_101" Java(TM) SE Runtime Environment (build 1.8.0_101-b13) Java HotSpot(TM) 64-Bit Server VM (build 25.101-b13, mixed mode)

ant_build.txt

[prasser]

The reason for the errors that you are seeing is that Javadoc is much more strict in Java 8 than in previous versions.

We have just committed a fix to the current master branch. Can you confirm that this resolves the issue for you?

Thanks for reporting this! Fabian

[swesemeyer]

Yes, it works but don't you think the fix is a bit too easy?? The reported errors were mistakes in the documentation and should probably be fixed to ensure that the generated API docs are correct. There are more options to doclint and "none" is probably not the best first choice... http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html Anyway, thanks for the quick response.

[prasser]

Of course you are absolutely right that this is not a perfect fix and that it would be much better to handle the underlying issues. However, we don't have the time and resources to do this right now and the fix at least provides a temporary workaround.

ARX is an open source project and this is a great opportunity for interested individuals to start contributing to the project...

I labeled the issue with "enhancement", changed the title and I will leave it open for now.