Merge remote-tracking branch 'elastic/master' into geoshape-doc-values

Author: talevy

docs/reference/aggregations/metrics/geocentroid-aggregation.asciidoc

@@ -143,3 +143,17 @@ The response for the above aggregation:
 }
 --------------------------------------------------
 // TESTRESPONSE[s/\.\.\./"took": $body.took,"_shards": $body._shards,"hits":$body.hits,"timed_out":false,/]
+
+[WARNING]
+.Using `geo_centroid` as a sub-aggregation of `geohash_grid`
+====
+The <<search-aggregations-bucket-geohashgrid-aggregation,`geohash_grid`>>
+aggregation places documents, not individual geo-points, into buckets. If a
+document's `geo_point` field contains <<array,multiple values>>, the document
+could be assigned to multiple buckets, even if one or more of its geo-points are
+outside the bucket boundaries.
+    
+If a `geocentroid` sub-aggregation is also used, each centroid is calculated
+using all geo-points in a bucket, including those outside the bucket boundaries.
+This can result in centroids outside of bucket boundaries.
+====

docs/reference/cat/nodes.asciidoc

@@ -285,18 +285,6 @@ Number of suggest operations, such as `0`.
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
 
-include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
-+
---
-`local`::
-(Optional, boolean) If `true`, the request computes the list of selected nodes
-from the local cluster state. Defaults to `false`, which means the list of
-selected nodes is computed from the cluster state on the master node. In either
-case the coordinating node sends a request for further information to each
-selected node. deprecated::[8.0,This parameter does not cause this API to act
-locally. It will be removed in version 8.0.]
---
-
 include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
 
 include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]

docs/reference/index-docinfo.xml

@@ -65,6 +65,9 @@ there>>. {ccr-cap} will not function if soft deletes are disabled.
   configured at index creation and only on indices created on or after 6.5.0.
   The default value is `true`.
 
+  deprecated::[7.6, Creating indices with soft-deletes disabled is
+  deprecated and will be removed in future Elasticsearch versions.]
+
 `index.soft_deletes.retention_lease.period`::
 
   The maximum length of time to retain a shard history retention lease before

docs/reference/index-modules/history-retention.asciidoc

@@ -30,6 +30,7 @@ coming[8.0.0]
 * <<breaking_80_search_changes>>
 * <<breaking_80_settings_changes>>
 * <<breaking_80_indices_changes>>
+* <<breaking_80_api_changes>>
 
 //NOTE: The notable-breaking-changes tagged regions are re-used in the
 //Installation and Upgrade Guide
@@ -81,3 +82,4 @@ include::migrate_8_0/reindex.asciidoc[]
 include::migrate_8_0/search.asciidoc[]
 include::migrate_8_0/settings.asciidoc[]
 include::migrate_8_0/indices.asciidoc[]
+include::migrate_8_0/api.asciidoc[]

docs/reference/index.x-docinfo.xml

@@ -0,0 +1,19 @@
+[float]
+[[breaking_80_api_changes]]
+=== REST API changes
+
+//NOTE: The notable-breaking-changes tagged regions are re-used in the
+//Installation and Upgrade Guide
+//tag::notable-breaking-changes[]
+
+// end::notable-breaking-changes[]
+
+[float]
+==== Deprecated `?local` parameter removed from `GET _cat/nodes` API
+
+The `?local` parameter to the `GET _cat/nodes` API was deprecated in 7.x and is
+rejected in 8.0. This parameter caused the API to use the local cluster state
+to determine the nodes returned by the API rather than the cluster state from
+the master, but this API requests information from each selected node
+regardless of the `?local` parameter which means this API does not run in a
+fully node-local fashion.

docs/reference/migration/migrate_8_0.asciidoc

@@ -26,229 +26,6 @@ index that make warmers not necessary anymore.
 The types exists endpoint has been removed. See <<removal-of-types>> for
 more details.
 
-[role="exclude",id="xpack-api"]
-=== X-Pack APIs
-
-{es} {xpack} APIs are now documented in <<rest-apis, REST APIs>>.
-
-[role="exclude",id="ml-calendar-resource"]]
-=== Calendar resources
-
-See <<ml-get-calendar>> and
-{ml-docs}/ml-calendars.html[Calendars and scheduled events].
-
-[role="exclude",id="ml-filter-resource"]
-=== Filter resources
-
-See <<ml-get-filter>> and
-{ml-docs}/ml-rules.html[Machine learning custom rules].
-
-[role="exclude",id="ml-event-resource"]
-=== Scheduled event resources
-
-See <<ml-get-calendar-event>> and
-{ml-docs}/ml-calendars.html[Calendars and scheduled events].
-
-[role="exclude",id="index-apis"]
-=== Index APIs
-{es} index APIs are now documented in <<indices>>.
-
-[role="exclude",id="search-request-docvalue-fields"]
-=== Doc value fields parameter for request body search API
-See <<request-body-search-docvalue-fields>>.
-
-[role="exclude",id="search-request-explain"]
-=== Explain parameter for request body search API
-See <<request-body-search-explain>>.
-
-[role="exclude",id="search-request-collapse"]
-=== Collapse parameter for request body search API
-See <<request-body-search-collapse>>.
-
-[role="exclude",id="search-request-from-size"]
-=== From and size parameters for request body search API
-See <<request-body-search-from-size>>.
-
-[role="exclude",id="search-request-highlighting"]
-=== Highlight parameter for request body search API
-See <<request-body-search-highlighting>>.
-
-[role="exclude",id="search-request-index-boost"]
-=== Index boost parameter for request body search API
-See <<request-body-search-index-boost>>.
-
-[role="exclude",id="search-request-inner-hits"]
-=== Inner hits parameter for request body search API
-See <<request-body-search-inner-hits>>.
-
-[role="exclude",id="search-request-min-score"]
-=== Minimum score parameter for request body search API
-See <<request-body-search-min-score>>.
-
-[role="exclude",id="search-request-named-queries-and-filters"]
-=== Named query parameter for request body search API
-See <<request-body-search-queries-and-filters>>.
-
-[role="exclude",id="search-request-post-filter"]
-=== Post filter parameter for request body search API
-See <<request-body-search-post-filter>>.
-
-[role="exclude",id="search-request-preference"]
-=== Preference parameter for request body search API
-See <<request-body-search-preference>>.
-
-[role="exclude",id="search-request-query"]
-=== Query parameter for request body search API
-See <<request-body-search-query>>.
-
-[role="exclude",id="search-request-rescore"]
-=== Rescoring parameter for request body search API
-See <<request-body-search-rescore>>.
-
-[role="exclude",id="search-request-script-fields"]
-=== Script fields parameter for request body search API
-See <<request-body-search-script-fields>>.
-
-[role="exclude",id="search-request-scroll"]
-=== Scroll parameter for request body search API
-See <<request-body-search-scroll>>.
-
-[role="exclude",id="search-request-search-after"]
-=== Search after parameter for request body search API
-See <<request-body-search-search-after>>.
-
-[role="exclude",id="search-request-search-type"]
-=== Search type parameter for request body search API
-See <<request-body-search-search-type>>.
-
-[role="exclude",id="search-request-seq-no-primary-term"]
-=== Sequence numbers and primary terms parameter for request body search API
-See <<request-body-search-search-type>>.
-
-[role="exclude",id="search-request-sort"]
-=== Sort parameter for request body search API
-See <<request-body-search-sort>>.
-
-[role="exclude",id="search-request-source-filtering"]
-=== Source filtering parameter for request body search API
-See <<request-body-search-source-filtering>>.
-
-[role="exclude",id="search-request-stored-fields"]
-=== Stored fields parameter for request body search API
-See <<request-body-search-stored-fields>>.
-
-[role="exclude",id="search-request-track-total-hits"]
-=== Track total hits parameter for request body search API
-See <<request-body-search-track-total-hits>>.
-
-[role="exclude",id="search-request-version"]
-=== Version parameter for request body search API
-See <<request-body-search-version>>.
-
-[role="exclude",id="search-suggesters-term"]
-=== Term suggester
-See <<term-suggester>>.
-
-[role="exclude",id="search-suggesters-phrase"]
-=== Phrase suggester
-See <<phrase-suggester>>.
-
-[role="exclude",id="search-suggesters-completion"]
-=== Completion suggester
-See <<completion-suggester>>.
-
-[role="exclude",id="suggester-context"]
-=== Context suggester
-See <<context-suggester>>.
-
-[role="exclude",id="returning-suggesters-type"]
-=== Return suggester type
-See <<return-suggesters-type>>.
-
-[role="exclude",id="search-profile-queries"]
-=== Profiling queries
-See <<profiling-queries>>.
-
-[role="exclude",id="search-profile-aggregations"]
-=== Profiling aggregations
-See <<profiling-aggregations>>.
-
-[role="exclude",id="search-profile-considerations"]
-=== Profiling considerations
-See <<profiling-considerations>>.
-
-[role="exclude",id="_explain_analyze"]
-=== Explain analyze API
-See <<explain-analyze-api>>.
-
-[role="exclude",id="indices-synced-flush"]
-=== Synced flush API
-See <<indices-synced-flush-api>>.
-
-[role="exclude",id="_repositories"]
-=== Snapshot repositories
-See <<snapshots-repositories>>.
-
-[role="exclude",id="_snapshot"]
-=== Snapshot
-See <<snapshots-take-snapshot>>.
-
-[role="exclude",id="getting-started-explore"]
-=== Exploring your cluster
-See <<cat>>.
-
-[role="exclude",id="getting-started-cluster-health"]
-=== Cluster health
-See <<cat-health>>.
-
-[role="exclude", id="getting-started-list-indices"]
-=== List all indices
-See <<cat-indices>>.
-
-[role="exclude", id="getting-started-create-index"]
-=== Create an index
-See <<indices-create-index>>.
-
-[role="exclude", id="getting-started-query-document"]
-=== Index and query a document
-See <<getting-started-index>>.
-
-[role="exclude", id="getting-started-delete-index"]
-=== Delete an index
-See <<indices-delete-index>>.
-
-[role="exclude", id="getting-started-modify-data"]
-== Modifying your data
-See <<docs-update>>.
-
-[role="exclude", id="indexing-replacing-documents"]
-=== Indexing/replacing documents
-See <<docs-index_>>.
-
-[role="exclude", id="getting-started-explore-data"]
-=== Exploring your data
-See <<getting-started-search>>.
-
-[role="exclude", id="getting-started-search-API"]
-=== Search API
-See <<getting-started-search>>.
-
-[role="exclude", id="getting-started-conclusion"]
-=== Conclusion
-See <<getting-started-next-steps>>.
-
-[role="exclude",id="ccs-reduction"]
-=== {ccs-cap} reduction
-See <<ccs-works>>.
-
-[role="exclude",id="administer-elasticsearch"]
-=== Administering {es}
-See <<high-availability>>.
-
-[role="exclude",id="slm-api"]
-=== Snapshot lifecycle management API
-See <<snapshot-lifecycle-management-api>>.
-
 [role="exclude",id="delete-data-frame-transform"]
 ===  Delete {transforms} API
 

docs/reference/migration/migrate_8_0/api.asciidoc

@@ -21,7 +21,6 @@
 
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.Version;
-import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.geometry.utils.GeographyValidator;
 import org.elasticsearch.geometry.utils.WellKnownText;
 import org.elasticsearch.test.AbstractWireTestCase;
@@ -42,12 +41,6 @@ protected final T createTestInstance() {
 
     protected abstract T createTestInstance(boolean hasAlt);
 
-    @Override
-    protected Writeable.Reader<T> instanceReader() {
-        throw new IllegalStateException("shouldn't be called in this test");
-    }
-
-
     @SuppressWarnings("unchecked")
     @Override
     protected T copyInstance(T instance, Version version) throws IOException {

docs/reference/redirects.asciidoc

@@ -53,7 +53,7 @@
 import static org.elasticsearch.discovery.ec2.AwsEc2Service.HostType.TAG_PREFIX;
 
 class AwsEc2SeedHostsProvider implements SeedHostsProvider {
-    
+
     private static final Logger logger = LogManager.getLogger(AwsEc2SeedHostsProvider.class);
 
     private final TransportService transportService;
@@ -221,22 +221,13 @@ private DescribeInstancesRequest buildDescribeInstancesRequest() {
 
     private final class TransportAddressesCache extends SingleObjectCache<List<TransportAddress>> {
 
-        private boolean empty = true;
-
         protected TransportAddressesCache(TimeValue refreshInterval) {
             super(refreshInterval,  new ArrayList<>());
         }
 
-        @Override
-        protected boolean needsRefresh() {
-            return (empty || super.needsRefresh());
-        }
-
         @Override
         protected List<TransportAddress> refresh() {
-            final List<TransportAddress> nodes = fetchDynamicNodes();
-            empty = nodes.isEmpty();
-            return nodes;
+            return fetchDynamicNodes();
         }
     }
 }