Fix documentation links

Author: olivere

CONTRIBUTORS

@@ -68,6 +68,7 @@ Sean DuBois [@Sean-Der](https://github.com/Sean-Der)
 Shalin LK [@shalinlk](https://github.com/shalinlk)
 Stephen Kubovic [@stephenkubovic](https://github.com/stephenkubovic)
 Stuart Warren [@Woz](https://github.com/stuart-warren)
+Sulaiman [@salajlan](https://github.com/salajlan)
 Sundar [@sundarv85](https://github.com/sundarv85)
 Take [ww24](https://github.com/ww24)
 Tetsuya Morimoto [@t2y](https://github.com/t2y)

bulk.go

@@ -24,7 +24,7 @@ import (
 // reuse BulkService to send many batches. You do not have to create a new
 // BulkService for each batch.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for more details.
 type BulkService struct {
 	client *Client

bulk_delete_request.go

@@ -14,7 +14,7 @@ import (
 
 // BulkDeleteRequest is a request to remove a document from Elasticsearch.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for details.
 type BulkDeleteRequest struct {
 	BulkableRequest
@@ -100,7 +100,7 @@ func (r *BulkDeleteRequest) String() string {
 
 // Source returns the on-wire representation of the delete request,
 // split into an action-and-meta-data line and an (optional) source line.
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for details.
 func (r *BulkDeleteRequest) Source() ([]string, error) {
 	if r.source != nil {

bulk_index_request.go

@@ -12,7 +12,7 @@ import (
 
 // BulkIndexRequest is a request to add a document to Elasticsearch.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for details.
 type BulkIndexRequest struct {
 	BulkableRequest
@@ -65,7 +65,7 @@ func (r *BulkIndexRequest) Id(id string) *BulkIndexRequest {
 
 // OpType specifies if this request should follow create-only or upsert
 // behavior. This follows the OpType of the standard document index API.
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html#operation-type
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-index_.html#operation-type
 // for details.
 func (r *BulkIndexRequest) OpType(opType string) *BulkIndexRequest {
 	r.opType = opType
@@ -98,7 +98,7 @@ func (r *BulkIndexRequest) Version(version int64) *BulkIndexRequest {
 // VersionType specifies how versions are created. It can be e.g. internal,
 // external, external_gte, or force.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html#index-versioning
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-index_.html#index-versioning
 // for details.
 func (r *BulkIndexRequest) VersionType(versionType string) *BulkIndexRequest {
 	r.versionType = versionType
@@ -146,7 +146,7 @@ func (r *BulkIndexRequest) String() string {
 
 // Source returns the on-wire representation of the index request,
 // split into an action-and-meta-data line and an (optional) source line.
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for details.
 func (r *BulkIndexRequest) Source() ([]string, error) {
 	// { "index" : { "_index" : "test", "_type" : "type1", "_id" : "1" } }

bulk_update_request.go

@@ -12,7 +12,7 @@ import (
 
 // BulkUpdateRequest is a request to update a document in Elasticsearch.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for details.
 type BulkUpdateRequest struct {
 	BulkableRequest
@@ -23,6 +23,7 @@ type BulkUpdateRequest struct {
 	routing         string
 	parent          string
 	script          *Script
+	scriptedUpsert  *bool
 	version         int64  // default is MATCH_ANY
 	versionType     string // default is "internal"
 	retryOnConflict *int
@@ -77,15 +78,25 @@ func (r *BulkUpdateRequest) Parent(parent string) *BulkUpdateRequest {
 }
 
 // Script specifies an update script.
-// See https://www.elastic.co/guide/en/elasticsearch/reference/2.x/docs-bulk.html#bulk-update
-// and https://www.elastic.co/guide/en/elasticsearch/reference/2.x/modules-scripting.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html#bulk-update
+// and https://www.elastic.co/guide/en/elasticsearch/reference/5.2/modules-scripting.html
 // for details.
 func (r *BulkUpdateRequest) Script(script *Script) *BulkUpdateRequest {
 	r.script = script
 	r.source = nil
 	return r
 }
 
+// ScripedUpsert specifies if your script will run regardless of
+// whether the document exists or not.
+//
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-update.html#_literal_scripted_upsert_literal
+func (r *BulkUpdateRequest) ScriptedUpsert(upsert bool) *BulkUpdateRequest {
+	r.scriptedUpsert = &upsert
+	r.source = nil
+	return r
+}
+
 // RetryOnConflict specifies how often to retry in case of a version conflict.
 func (r *BulkUpdateRequest) RetryOnConflict(retryOnConflict int) *BulkUpdateRequest {
 	r.retryOnConflict = &retryOnConflict
@@ -119,7 +130,7 @@ func (r *BulkUpdateRequest) Doc(doc interface{}) *BulkUpdateRequest {
 // DocAsUpsert indicates whether the contents of Doc should be used as
 // the Upsert value.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/2.x/docs-update.html#_literal_doc_as_upsert_literal
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-update.html#_literal_doc_as_upsert_literal
 // for details.
 func (r *BulkUpdateRequest) DocAsUpsert(docAsUpsert bool) *BulkUpdateRequest {
 	r.docAsUpsert = &docAsUpsert
@@ -175,7 +186,7 @@ func (r *BulkUpdateRequest) getSourceAsString(data interface{}) (string, error)
 
 // Source returns the on-wire representation of the update request,
 // split into an action-and-meta-data line and an (optional) source line.
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-bulk.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-bulk.html
 // for details.
 func (r BulkUpdateRequest) Source() ([]string, error) {
 	// { "update" : { "_index" : "test", "_type" : "type1", "_id" : "1", ... } }
@@ -235,6 +246,9 @@ func (r BulkUpdateRequest) Source() ([]string, error) {
 	if r.upsert != nil {
 		source["upsert"] = r.upsert
 	}
+	if r.scriptedUpsert != nil {
+		source["scripted_upsert"] = *r.scriptedUpsert
+	}
 	if r.doc != nil {
 		// {"doc":{...}}
 		source["doc"] = r.doc

bulk_update_request_test.go

@@ -67,22 +67,38 @@ func TestBulkUpdateRequestSerialization(t *testing.T) {
 				`{"detect_noop":true,"doc":{"counter":42}}`,
 			},
 		},
+		// #4
+		{
+			Request: NewBulkUpdateRequest().Index("index1").Type("tweet").Id("1").
+				RetryOnConflict(3).
+				ScriptedUpsert(true).
+				Script(NewScript(`ctx._source.retweets += param1`).Lang("javascript").Param("param1", 42)).
+				Upsert(struct {
+					Counter int64 `json:"counter"`
+				}{
+					Counter: 42,
+				}),
+			Expected: []string{
+				`{"update":{"_id":"1","_index":"index1","_retry_on_conflict":3,"_type":"tweet"}}`,
+				`{"script":{"inline":"ctx._source.retweets += param1","lang":"javascript","params":{"param1":42}},"scripted_upsert":true,"upsert":{"counter":42}}`,
+			},
+		},
 	}
 
 	for i, test := range tests {
 		lines, err := test.Request.Source()
 		if err != nil {
-			t.Fatalf("case #%d: expected no error, got: %v", i, err)
+			t.Fatalf("#%d: expected no error, got: %v", i, err)
 		}
 		if lines == nil {
-			t.Fatalf("case #%d: expected lines, got nil", i)
+			t.Fatalf("#%d: expected lines, got nil", i)
 		}
 		if len(lines) != len(test.Expected) {
-			t.Fatalf("case #%d: expected %d lines, got %d", i, len(test.Expected), len(lines))
+			t.Fatalf("#%d: expected %d lines, got %d", i, len(test.Expected), len(lines))
 		}
 		for j, line := range lines {
 			if line != test.Expected[j] {
-				t.Errorf("case #%d: expected line #%d to be\n%s\nbut got:\n%s", i, j, test.Expected[j], line)
+				t.Errorf("#%d: expected line #%d to be\n%s\nbut got:\n%s", i, j, test.Expected[j], line)
 			}
 		}
 	}

clear_scroll.go

@@ -14,7 +14,7 @@ import (
 
 // ClearScrollService clears one or more scroll contexts by their ids.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-scroll.html#_clear_scroll_api
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/search-request-scroll.html#_clear_scroll_api
 // for details.
 type ClearScrollService struct {
 	client   *Client

client.go

@@ -155,7 +155,7 @@ type Client struct {
 //
 // If the sniffer is enabled (the default), the new client then sniffes
 // the cluster via the Nodes Info API
-// (see http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-nodes-info.html#cluster-nodes-info).
+// (see https://www.elastic.co/guide/en/elasticsearch/reference/5.2/cluster-nodes-info.html#cluster-nodes-info).
 // It uses the URLs specified by the caller. The caller is responsible
 // to only pass a list of URLs of nodes that belong to the same cluster.
 // This sniffing process is run on startup and periodically.
@@ -1284,7 +1284,7 @@ func (c *Client) BulkProcessor() *BulkProcessorService {
 
 // Reindex copies data from a source index into a destination index.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-reindex.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-reindex.html
 // for details on the Reindex API.
 func (c *Client) Reindex() *ReindexService {
 	return NewReindexService(c)

cluster_health.go

@@ -16,7 +16,7 @@ import (
 
 // ClusterHealthService allows to get a very simple status on the health of the cluster.
 //
-// See http://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html
+// See http://www.elastic.co/guide/en/elasticsearch/reference/5.2/cluster-health.html
 // for details.
 type ClusterHealthService struct {
 	client                    *Client

cluster_state.go

@@ -16,7 +16,7 @@ import (
 
 // ClusterStateService allows to get a comprehensive state information of the whole cluster.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-state.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/cluster-state.html
 // for details.
 type ClusterStateService struct {
 	client            *Client

cluster_stats.go

@@ -14,7 +14,8 @@ import (
 	"gopkg.in/olivere/elastic.v5/uritemplates"
 )
 
-// ClusterStatsService is documented at http://www.elasticsearch.org/guide/en/elasticsearch/reference/1.4/cluster-stats.html.
+// ClusterStatsService is documented at
+// https://www.elastic.co/guide/en/elasticsearch/reference/5.2/cluster-stats.html.
 type ClusterStatsService struct {
 	client       *Client
 	pretty       bool

delete.go

@@ -16,7 +16,7 @@ import (
 // DeleteService allows to delete a typed JSON document from a specified
 // index based on its id.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-delete.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-delete.html
 // for details.
 type DeleteService struct {
 	client              *Client

delete_by_query.go

@@ -15,7 +15,7 @@ import (
 )
 
 // DeleteByQueryService deletes documents that match a query.
-// See http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/docs-delete-by-query.html.
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-delete-by-query.html.
 type DeleteByQueryService struct {
 	client                 *Client
 	index                  []string

delete_template.go

@@ -14,7 +14,7 @@ import (
 )
 
 // DeleteTemplateService deletes a search template. More information can
-// be found at http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/search-template.html.
+// be found at https://www.elastic.co/guide/en/elasticsearch/reference/5.2/search-template.html.
 type DeleteTemplateService struct {
 	client      *Client
 	pretty      bool

doc.go

@@ -4,7 +4,7 @@
 
 /*
 Package elastic provides an interface to the Elasticsearch server
-(http://www.elasticsearch.org/).
+(https://www.elastic.co/products/elasticsearch).
 
 The first thing you do is to create a Client. If you have Elasticsearch
 installed and running with its default settings

exists.go

@@ -16,7 +16,7 @@ import (
 
 // ExistsService checks for the existence of a document using HEAD.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-get.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-get.html
 // for details.
 type ExistsService struct {
 	client     *Client

explain.go

@@ -16,7 +16,7 @@ import (
 
 // ExplainService computes a score explanation for a query and
 // a specific document.
-// See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-explain.html.
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/search-explain.html.
 type ExplainService struct {
 	client                 *Client
 	pretty                 bool

field_stats.go

@@ -23,7 +23,7 @@ const (
 // FieldStatsService allows finding statistical properties of a field without executing a search,
 // but looking up measurements that are natively available in the Lucene index.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-field-stats.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/search-field-stats.html
 // for details
 type FieldStatsService struct {
 	client            *Client

get.go

@@ -18,7 +18,7 @@ import (
 // GetService allows to get a typed JSON document from the index based
 // on its id.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-get.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-get.html
 // for details.
 type GetService struct {
 	client                        *Client

get_template.go

@@ -14,7 +14,7 @@ import (
 )
 
 // GetTemplateService reads a search template.
-// It is documented at http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/search-template.html.
+// It is documented at https://www.elastic.co/guide/en/elasticsearch/reference/5.2/search-template.html.
 type GetTemplateService struct {
 	client      *Client
 	pretty      bool

highlight.go

@@ -6,7 +6,7 @@ package elastic
 
 // Highlight allows highlighting search results on one or more fields.
 // For details, see:
-// http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-request-highlighting.html
+// https://www.elastic.co/guide/en/elasticsearch/reference/5.2/search-request-highlighting.html
 type Highlight struct {
 	fields                []*HighlighterField
 	tagsSchema            *string

index.go

@@ -16,7 +16,7 @@ import (
 // IndexService adds or updates a typed JSON document in a specified index,
 // making it searchable.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-index_.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-index_.html
 // for details.
 type IndexService struct {
 	client              *Client
@@ -173,7 +173,7 @@ func (s *IndexService) buildURL() (string, string, url.Values, error) {
 		})
 	} else {
 		// Automatic ID generation
-		// See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html#index-creation
+		// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/docs-index_.html#index-creation
 		method = "POST"
 		path, err = uritemplates.Expand("/{index}/{type}/", map[string]string{
 			"index": s.index,

indices_analyze.go

@@ -16,7 +16,7 @@ import (
 // IndicesAnalyzeService performs the analysis process on a text and returns
 // the tokens breakdown of the text.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-analyze.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/indices-analyze.html
 // for detail.
 type IndicesAnalyzeService struct {
 	client      *Client
@@ -186,7 +186,7 @@ func (s *IndicesAnalyzeService) Do(ctx context.Context) (*IndicesAnalyzeResponse
 	} else {
 		// Request parameters are deprecated in 5.1.1, and we must use a JSON
 		// structure in the body to pass the parameters.
-		// See https://www.elastic.co/guide/en/elasticsearch/reference/5.1/indices-analyze.html
+		// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/indices-analyze.html
 		body = s.request
 	}
 

indices_close.go

@@ -15,7 +15,7 @@ import (
 
 // IndicesCloseService closes an index.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-open-close.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/indices-open-close.html
 // for details.
 type IndicesCloseService struct {
 	client            *Client

indices_create.go

@@ -15,7 +15,7 @@ import (
 
 // IndicesCreateService creates a new index.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/indices-create-index.html
 // for details.
 type IndicesCreateService struct {
 	client        *Client

indices_delete.go

@@ -16,7 +16,7 @@ import (
 
 // IndicesDeleteService allows to delete existing indices.
 //
-// See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-delete-index.html
+// See https://www.elastic.co/guide/en/elasticsearch/reference/5.2/indices-delete-index.html
 // for details.
 type IndicesDeleteService struct {
 	client        *Client