# HG changeset patch
# User dfuchs
# Date 1510940098 0
# Node ID 06978e471003d36285e2f85ee8935678a3caca39
# Parent  bc54d015e09dc8b46ec05e918b5b8345fe037ff4
http-client-branch: more precision for headers in HttpRequest.Builder

diff -r bc54d015e09d -r 06978e471003 src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/HttpRequest.java
--- a/src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/HttpRequest.java	Fri Nov 17 16:34:05 2017 +0000
+++ b/src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/HttpRequest.java	Fri Nov 17 17:34:58 2017 +0000
@@ -338,6 +338,7 @@
 
         /**
          * Adds the given name value pair to the set of headers for this request.
+         * The given value is added to the list of values for that name.
          *
          * @param name the header name
          * @param value the header value
@@ -352,6 +353,8 @@
          * Adds the given name value pairs to the set of headers for this
          * request. The supplied {@code String} instances must alternate as
          * header names and header values.
+         * To add several values to the same name then the same name must
+         * be supplied with each new value.
          *
          * @param headers the list of name value pairs
          * @return this request builder