Clarify the user responsiblity of 'Trailer' header

shingwaichan · shingwaichan · commit e6e1d2717acf · 2017-07-14T10:11:30.000-07:00
diff --git a/src/main/java/javax/servlet/http/HttpServletResponse.java b/src/main/java/javax/servlet/http/HttpServletResponse.java
@@ -469,6 +469,12 @@ public interface HttpServletResponse extends ServletResponse {
      * <p>The trailers that run afoul of the provisions of section 4.1.2 of
      * RFC 7230 are ignored.</p>
      *
+     * <p>The RFC requires the name of every key that is to be in the
+     * supplied Map is included in the comma separated list that is the value
+     * of the "Trailer" response header.  The application is responsible for
+     * ensuring this requirement is met.  Failure to do so may lead to
+     * interoperability failures.</p>
+     *
      * @implSpec
      * The default implementation is a no-op.
      *

Original file line number	Diff line number	Diff line change
`@@ -469,6 +469,12 @@ public interface HttpServletResponse extends ServletResponse {`
`469`	`469`	`* <p>The trailers that run afoul of the provisions of section 4.1.2 of`
`470`	`470`	`* RFC 7230 are ignored.</p>`
`471`	`471`	`*`
	`472`	`+ * <p>The RFC requires the name of every key that is to be in the`
	`473`	`+ * supplied Map is included in the comma separated list that is the value`
	`474`	`+ * of the "Trailer" response header. The application is responsible for`
	`475`	`+ * ensuring this requirement is met. Failure to do so may lead to`
	`476`	`+ * interoperability failures.</p>`
	`477`	`+ *`
`472`	`478`	`* @implSpec`
`473`	`479`	`* The default implementation is a no-op.`
`474`	`480`	`*`