deprecate join methods now available in Java 8 String class (#127)

diff --git a/src/main/java/org/apache/maven/shared/utils/StringUtils.java b/src/main/java/org/apache/maven/shared/utils/StringUtils.java
index de4a1e8..a355e2e 100644
--- a/src/main/java/org/apache/maven/shared/utils/StringUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/StringUtils.java
@@ -618,7 +618,9 @@
      * @param array     the array of values to join together
      * @param separator the separator character to use
      * @return the joined String
+     * @deprecated use <code>java.lang.String.join(</code>) instead
      */
+    @Deprecated
     @Nonnull public static String join( @Nonnull Object[] array, @Nullable String separator )
     {
         if ( separator == null )
@@ -650,7 +652,9 @@
      * @param iterator  the <code>Iterator</code> of values to join together
      * @param separator the separator character to use
      * @return the joined String
+     * @deprecated use <code>java.lang.String.join(</code>) instead
      */
+    @Deprecated
     @Nonnull public static String join( @Nonnull Iterator<?> iterator, String separator )
     {
         if ( separator == null )
@@ -689,7 +693,7 @@
     }
 
     /**
-     * <p>Replace all occurances of a char within another char.</p>
+     * <p>Replace all occurrences of a char within a string with another char.</p>
      *
      * <p>A <code>null</code> reference passed to this method is a no-op.</p>
      *