Information on deprecations.
Javadoc fixes and fixes broken Lucene links.
Merge pull request #737 from nawroth/deprecations

Deprecations and javadoc + link fixes,