Java 8 compliant Javadoc

[snodnipper]

The Java 8 doc lint is pretty strict with Javadoc.

This commit should resolve problems that result in failure and help us avoid having to turn off the lint tool.

Please comment on any TODOs and I can rebase.

[ColeFerrier]

Would it be possible to get this merged before the next release? this might need updated due to changes on master? what is Esri's thoughts on getting this merged?

[randallwhitman]

Unfortunately, conflicts have arisen - that would have to be resolved.

@alocke @stolstov Had you any comments on the changes?

[snodnipper]

perhaps if folk could raise any comments with the view to merge then I could rebase.

[stolstov]

This fixes will get in eventually, we'll try to make it for next release (after 1.3). They will have to be merged into another branch.

[stolstov]

@snodnipper It's just we have certain internal code that needs to be updated manually. I'll try to make the process easier.

[monezz]

you could add this property to the pom in the main branch as quick fix:
<additionalparam>-Xdoclint:none</additionalparam>