/*
 * Copyright (c) 2017 Goldman Sachs and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * and Eclipse Distribution License v. 1.0 which accompany this distribution.
 * The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
 * and the Eclipse Distribution License is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 */

package org.eclipse.collections.impl.factory;

import java.util.Map;

import org.eclipse.collections.api.factory.map.FixedSizeMapFactory;
import org.eclipse.collections.api.factory.map.ImmutableMapFactory;
import org.eclipse.collections.api.factory.map.MutableMapFactory;
import org.eclipse.collections.api.map.MutableMap;
import org.eclipse.collections.impl.map.fixed.FixedSizeMapFactoryImpl;
import org.eclipse.collections.impl.map.immutable.ImmutableMapFactoryImpl;
import org.eclipse.collections.impl.map.mutable.MapAdapter;
import org.eclipse.collections.impl.map.mutable.MutableMapFactoryImpl;

/**
 * This class should be used to create instances of MutableMap, ImmutableMap and FixedSizeMap
 * <p>
 * Mutable Examples:
 *
 * <pre>
 * MutableMap&lt;String, String&gt; emptyMap = Maps.mutable.empty();
 * MutableMap&lt;String, String&gt; mapWith = Maps.mutable.with("a", "A", "b", "B", "c", "C");
 * MutableMap&lt;String, String&gt; mapOf = Maps.mutable.of("a", "A", "b", "B", "c", "C");
 * </pre>
 *
 * Immutable Examples:
 *
 * <pre>
 * ImmutableMap&lt;String&gt; mapList = Maps.immutable.empty();
 * ImmutableMap&lt;String&gt; mapWith = Maps.immutable.with("a", "A", "b", "B", "c", "C");
 * ImmutableMap&lt;String&gt; mapOf = Maps.immutable.of("a", "A", "b", "B", "c", "C");
 * </pre>
 *
 * FixedSize Examples:
 *
 * <pre>
 * FixedSizeMap&lt;String&gt; emptyList = Maps.fixedSize.empty();
 * FixedSizeMap&lt;String&gt; listWith = Maps.fixedSize.with("a", "A", "b", "B", "c", "C");
 * FixedSizeMap&lt;String&gt; listOf = Maps.fixedSize.of("a", "A", "b", "B", "c", "C");
 * </pre>
 */
@SuppressWarnings("ConstantNamingConvention")
public final class Maps
{
    public static final ImmutableMapFactory immutable = ImmutableMapFactoryImpl.INSTANCE;
    public static final FixedSizeMapFactory fixedSize = FixedSizeMapFactoryImpl.INSTANCE;
    public static final MutableMapFactory mutable = MutableMapFactoryImpl.INSTANCE;

    private Maps()
    {
        throw new AssertionError("Suppress default constructor for noninstantiability");
    }

    /**
     * @since 9.0.
     */
    public static <K, V> MutableMap<K, V> adapt(Map<K, V> list)
    {
        return MapAdapter.adapt(list);
    }
}

@@ -1536,20 +1536,29 @@
 ring
-&gt; mapList
+, String&gt; emptyMap
  = M
@@ -1591,32 +1591,40 @@
 ImmutableMap&lt;
+String, 
 String&gt; mapWi
@@ -1690,32 +1690,40 @@
 ImmutableMap&lt;
+String, 
 String&gt; mapOf
@@ -1833,32 +1833,40 @@
 FixedSizeMap&lt;
+String, 
 String&gt; empty
@@ -1869,12 +1869,11 @@
 mpty
-List
+Map
  = M
@@ -1906,32 +1906,40 @@
 FixedSizeMap&lt;
+String, 
 String&gt; listW
@@ -1933,20 +1933,19 @@
 ing&gt; 
-list
+map
 With = M
@@ -2009,24 +2009,32 @@
 dSizeMap&lt;
+String, 
 String&gt; l
@@ -2032,20 +2032,19 @@
 ing&gt; 
-list
+map
 Of = Map

Fix Javadoc issue in Maps.