From 8a3bbdda2f2dead8b5cf1e6fb29fba952fe50357 Mon Sep 17 00:00:00 2001
From: Olivier Truong <oliv.truong@gmail.com>
Date: Mon, 1 Oct 2018 22:04:01 +0200
Subject: [PATCH] [JENKINS-53847] Improve JavaDoc for Util.fixNull

---
 core/src/main/java/hudson/Util.java | 34 ++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/core/src/main/java/hudson/Util.java b/core/src/main/java/hudson/Util.java
index 00a88df95e..ac4b7e0d90 100644
--- a/core/src/main/java/hudson/Util.java
+++ b/core/src/main/java/hudson/Util.java
@@ -1199,7 +1199,7 @@ public class Util {
     }
 
     /**
-     * Convert {@code null} to a default value.
+     * Convert {@code null} to a default <b>immutable</b> value.
      * @since TODO
      */
     @Nonnull
@@ -1227,21 +1227,53 @@ public class Util {
         return fixEmpty(s.trim());
     }
 
+    /**
+     *
+     * @param l list to check
+     * @param <T>
+     * @return
+     *     l if l is not {@code null}
+     *     an empty <b>immutable list</b> if l is {@code null}
+     */
     @Nonnull
     public static <T> List<T> fixNull(@CheckForNull List<T> l) {
         return fixNull(l, Collections.<T>emptyList());
     }
 
+    /**
+     *
+     * @param l set to check
+     * @param <T>
+     * @return
+     *     l if l is not {@code null}
+     *     an empty <b>immutable set</b> if l is {@code null}
+     */
     @Nonnull
     public static <T> Set<T> fixNull(@CheckForNull Set<T> l) {
         return fixNull(l, Collections.<T>emptySet());
     }
 
+    /**
+     *
+     * @param l collection to check
+     * @param <T>
+     * @return
+     *     l if l is not {@code null}
+     *     an empty <b>immutable set</b> if l is {@code null}
+     */
     @Nonnull
     public static <T> Collection<T> fixNull(@CheckForNull Collection<T> l) {
         return fixNull(l, Collections.<T>emptySet());
     }
 
+    /**
+     *
+     * @param l iterable to check
+     * @param <T>
+     * @return
+     *     l if l is not {@code null}
+     *     an empty <b>immutable set</b> if l is {@code null}
+     */
     @Nonnull
     public static <T> Iterable<T> fixNull(@CheckForNull Iterable<T> l) {
         return fixNull(l, Collections.<T>emptySet());