[DOCS] Clean up Java-API docs

Fixed some wording and subject/verb agreement while reading through the Java API documentation.
[DOCS] Fixed typo in object-type.asciidoc
[DOCS] Fixed typos in aggregations.asciidoc

Fix plural/singular forms.
Core: switch to the new ConcurrentHashMap implementation coming in Java 8

The new implementation has lower RAM overhead and better concurrency
in some cases.

Closes #6400
[DOCS] fixed typo in date-format.asciidoc
[DOCS] Fixed the fuzzy query docs with correct default value max_expansion option
[DOCS] Fixed typo in put-mapping docs

split backwardscompatibility to backwards compatibility
make this new test a bit less stressful for nightly; catch FlushNotAllowedEngineException
[DOCS] Reworded note about shorthand suggest syntax

The existing Note about the shorthand suggest syntax was poorly worded and confusing. Please check whether the way I've phrased it now is still correct as to what the shorthand form actually does and doesn't do: the original wording did not provide me enough information to be sure.
Thanks!
Compilation: don't warn about using Sun proprietary APIs

E.g. we use Unsafe in quite a few places and this generates lots of
warnings, which we now suppress using the undocumented
-XDignore.symbol.file command-line option to javac.

Closes #6423
FileSystem: Use XNativeFSLockFactory instead of the buggy Lucene 4.8.1 version

There is a pretty nasty bug in the lock factory we use that can cause
nodes to use the same data dir wiping each others data. Luckily this is
unlikely to happen if the nodes are running in different JVM which they
do unless they are embedded.

See LUCENE-5738

Closes #6424
Put index template api: unified PUT/POST behaviour in relation to create parameter

The put index template api supports the create parameter (defaults to false), which tells whether the template can replace an existing one with same name or not. Unified its behaviour between PUT and POST method, whereas the POST would previously force create to true.

Added create parameter to the rest spec (was missing before) and a REST test for create true scenario.
Aggregations optimisation for memory usage. Added changes to core Aggregator class to support a new mode of deferred collection.
A new "breadth_first" results collection mode allows upper branches of aggregation tree to be calculated and then pruned
to a smaller selection before advancing into executing collection on child branches.

Closes #6128
Bulk request which try and fail to create multiple indices may never return

This is caused by an NPE in the error handling code. All is well if only 1 index creation fails (or none).

Closes #6436
Guard against improper auto_expand_replica values

Previously if the user provided a non-conforming string, it would blow up with
`java.lang.StringIndexOutOfBoundsException: String index out of range: -1`
which is not a *helpful* error message.

Also updated the documentation to make the possible setting values more clear.

Close #5752
fixing recovery debug logging param mismatch
[Test] Enabled trace logging to  testAutoGenerateIdNoDuplicates

also increased iterations some, to increase chance of identifying bad shards
make test less evil
[TEST] Added backwards compatibility check to control whether to enable client nodes or not within TestCluster

Our REST backwards compatibility tests need to be able to disable client nodes within the TestCluster when running older tests that assume client nodes are not around.
Docs: Documented the cjk_width and cjk_bigram token filters