You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by ah...@apache.org on 2018/07/18 08:42:58 UTC

[isis] branch master updated: ISIS-1810: java-doc improvements

This is an automated email from the ASF dual-hosted git repository.

ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git


The following commit(s) were added to refs/heads/master by this push:
     new 5177bac  ISIS-1810: java-doc improvements
5177bac is described below

commit 5177bac40da3401e148bb913c82729813c58d574
Author: Andi Huber <ah...@apache.org>
AuthorDate: Wed Jul 18 10:42:52 2018 +0200

    ISIS-1810: java-doc improvements
---
 .../java/org/apache/isis/commons/internal/base/_NullSafe.java  | 10 ++++++++++
 .../apache/isis/commons/internal/collections/_Multimaps.java   |  2 +-
 .../org/apache/isis/commons/internal/collections/_Sets.java    |  2 +-
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/core/commons/src/main/java/org/apache/isis/commons/internal/base/_NullSafe.java b/core/commons/src/main/java/org/apache/isis/commons/internal/base/_NullSafe.java
index 1aa317a..ae39a5a 100644
--- a/core/commons/src/main/java/org/apache/isis/commons/internal/base/_NullSafe.java
+++ b/core/commons/src/main/java/org/apache/isis/commons/internal/base/_NullSafe.java
@@ -57,6 +57,16 @@ public final class _NullSafe {
         return array!=null ? Stream.of(array) : Stream.empty();
     }
 
+    /**
+     * If {@code nullable} is {@code null} returns the empty stream,
+     * otherwise returns a Stream containing the single element {@code nullable}.
+     * <p>
+     * Note: this method signature only matches if none of the other stream(?) methods match.
+     * </p>
+     * 
+     * @param nullable
+     * @return non-null stream object
+     */
     public static <T> Stream<T> stream(final T nullable) {
         return nullable != null ? Stream.of(nullable) : Stream.empty();
     }
diff --git a/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Multimaps.java b/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Multimaps.java
index f757a4f..de966bf 100644
--- a/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Multimaps.java
+++ b/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Multimaps.java
@@ -91,7 +91,7 @@ public class _Multimaps {
         public void putElement(K1 key, K2 subkey, V value);
 
         /**
-         * Get the element-map by {@code key}, then within the element-map looks up to {@code subkey}.
+         * Get the element-map by {@code key}, then within the element-map looks up {@code subkey}.
          * @param key
          * @param subkey
          * @return null if no such element exists
diff --git a/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Sets.java b/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Sets.java
index fede47b..90f1f42 100644
--- a/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Sets.java
+++ b/core/commons/src/main/java/org/apache/isis/commons/internal/collections/_Sets.java
@@ -75,7 +75,7 @@ public final class _Sets {
     }
 
     /**
-     * Copies all elements into a new unmodifiable List.
+     * Copies all elements into a new unmodifiable Set.
      * @param elements
      * @return non null
      */