Clarify Add function if a header already exists.

Author: nak3

apis/v1alpha1/httproute_types.go

@@ -437,31 +437,33 @@ type HTTPRequestHeaderFilter struct {
 	//
 	// Input:
 	//   GET /foo HTTP/1.1
-	//   My-Header: ABC
+	//   my-header: foo
 	//
 	// Config:
-	//   set: {"my-header": "XYZ"}
+	//   set: {"my-header": "bar"}
 	//
 	// Output:
 	//   GET /foo HTTP/1.1
-	//   my-header: XYZ
+	//   my-header: bar
 	//
 	// Support: Extended
 	// +optional
 	Set map[string]string `json:"set,omitempty"`
 
 	// Add adds the given header (name, value) to the request
-	// before the action.
+	// before the action. It appends to any existing values associated
+	// with the header name.
 	//
 	// Input:
 	//   GET /foo HTTP/1.1
+	//   my-header: foo
 	//
 	// Config:
-	//   add: {"my-header": "foo"}
+	//   add: {"my-header": "bar"}
 	//
 	// Output:
 	//   GET /foo HTTP/1.1
-	//   my-header: foo
+	//   my-header: foo bar
 	//
 	// Support: Extended
 	// +optional
@@ -474,16 +476,16 @@ type HTTPRequestHeaderFilter struct {
 	//
 	// Input:
 	//   GET /foo HTTP/1.1
-	//   My-Header1: ABC
-	//   My-Header2: DEF
-	//   My-Header2: GHI
+	//   my-header1: foo
+	//   my-header2: bar
+	//   my-header3: baz
 	//
 	// Config:
 	//   remove: ["my-header1", "my-header3"]
 	//
 	// Output:
 	//   GET /foo HTTP/1.1
-	//   My-Header2: DEF
+	//   my-header2: bar
 	//
 	// Support: Extended
 	// +optional