From 67011f027b9e11be372d8bfdd7a816476a0a6d89 Mon Sep 17 00:00:00 2001
From: Julien Viet <julien@julienviet.com>
Date: Wed, 29 Jan 2020 15:06:58 +0100
Subject: [PATCH] Update MultiMap contract and implementations so the setting a
 null value removes the entry from the MultiMap. Tests have been cleaned up
 and extended so that all MultiMap implementations are equally tested. -
 closes #3267

---
 src/main/java/io/vertx/core/MultiMap.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/main/java/io/vertx/core/MultiMap.java b/src/main/java/io/vertx/core/MultiMap.java
index 28116a6dc..9548f3043 100644
--- a/src/main/java/io/vertx/core/MultiMap.java
+++ b/src/main/java/io/vertx/core/MultiMap.java
@@ -193,9 +193,9 @@ public interface MultiMap extends Iterable<Map.Entry<String, String>> {
   MultiMap addAll(Map<String, String> headers);
 
   /**
-   * Sets a value under the specified name.
+   * Sets a {@code value} under the specified {@code name}.
    * <p>
-   * If there is an existing header with the same name, it is removed.
+   * If there is an existing header with the same name, it is removed. Setting a {@code null} value removes the entry.
    *
    * @param name The name
    * @param value The value