Better generated configuration docs.

* Generates docs from more settings classes.
* Extracts information on valid values, deprecated or mandatory settings and default values.
* Makes every setting easy to link to.
* Uses new annotations @Internal and @Obsoleted to add information to settings.
* Cleans up language and formatting in settings descriptions.
* Upgrade of doctools, including moving to a JVM-based DocBook validation and better support for mobile devices.
Merge pull request #3380 from nawroth/docgen

Better generated configuration docs.
Expose a way to ask a lucene index to sample index selectivity

o Scan a sample of index entries and compute uniqueSampledValues / sampleSize
Add a new CountsKey for index entry counts
Maintain index update counts from index proxies

o OnlineIndexProxy will ensure that the index counts are updated
o Fix bug when generate LazyIndexUpdates to never construct 'overlapping updates'
o Cleanup code in LazyIndexUpdates
o Make sure we update index update counts during population
Add minor version to CountsStore such that we can flush safely on index flip (outside of log rotation)

o Ensure we compare CountsKeys correctly by type
o Fix reading of index keys
o Add flushIndexCounts() to IndexStoreView
Remove index counts when dropping an index
Make index stats part of SchemaRead and add indexNumberOfEntries

Rationale: For planning to be sane, indices shouldn't appear or disappear out of nowhere, hence we need to be tied to the schema read lock
Add IndexStatisticsTest
Pass on transaction id to index updaters
Pull out and refactor IndexCountVisitor from CountingIndexUpdater
Only apply index count updates for unprocessed transactions during recovery

o Rename updateXYZ to incrementXYZ CountsStore related methods
o Push transactionId down to IndexUpdaters (and couple them to process only updates for a single transaction)
Replace use of LongRegister with DoubleLongRegister in counts store
Add new type of IndexKey for storing sampling results
Refactored counts package

o CountsAcceptor is now called CountsAccessor and also has read methods
o CountsState => CountsRecordState
o IndexKey is now split into Index{Size|Sample}Key
o CountsTrackerState now uses explicit calls per key type
Support index samples in counts tracker
Implement index sampling
- initial index counts are computed during population
- index sampling is scheduled every 10 seconds
Hook index selectivity into Cypher
Make max unique elements per sampling configurable
Check that the index is still online before storing index selectivity values in the CountsStore