/*
 * See the NOTICE file distributed with this work for additional
 * information regarding copyright ownership.
 *
 * This is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This software is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */
package org.xwiki.model.internal.reference;

import org.xwiki.component.annotation.Component;
import org.xwiki.model.EntityType;
import org.xwiki.model.reference.EntityReference;
import org.xwiki.model.reference.EntityReferenceSerializer;

/**
 * Same as ExplicitReferenceEntityReferenceResolver but with the extended type in the role hint instead of the role
 * type.
 * 
 * @version $Id$
 * @since 2.2.3
 * @deprecated use {@link ExplicitReferenceEntityReferenceResolver} instead.
 */
@Deprecated
@Component("local/reference")
public class DeprecatedLocalReferenceEntityReferenceSerializer implements EntityReferenceSerializer
{
    @Override
    public EntityReference serialize(EntityReference reference, Object... parameters)
    {
        EntityReference newReference = null;
        EntityReference parent;
        for (EntityReference currentReference = reference; currentReference != null; currentReference =
            currentReference.getParent())
        {
            if (currentReference.getType() == EntityType.WIKI) {
                return newReference;
            }

            parent = new EntityReference(currentReference.getName(), currentReference.getType());
            if (newReference != null) {
                newReference = newReference.appendParent(parent);
            } else {
                newReference = parent;
            }
        }

        return newReference;
    }
}

@@ -1138,133 +1138,331 @@
 %0A * 
-Same as ExplicitReferenceEntityReferenceResolver but with the extended typ
+Generate a entity reference but without the wiki reference part. This is an implementation use for backward%0A * compatibility only and it should be dropped in the futur
 e 
+s
 in
+ce
  the
- role hint instead of the role%0A * type
+re's no reason to remove the wiki name%0A * systematically%0A * (usually we don't want to print it but only if it's the same as the current wiki)
 .%0A *
- 
 %0A * 
@@ -1506,16 +1506,24 @@
 recated 
+you may 
 use %7B@li
@@ -1530,24 +1530,61 @@
 nk E
-xplicitR
+ntityReference#removeParent(org.xwiki.model.r
 eference
 Enti
@@ -1571,32 +1571,33 @@
 .model.reference
+.
 EntityReferenceR
@@ -1599,26 +1599,22 @@
 ence
-Resolver
+)
 %7D 
+s
 in
-stead.
+ce 4.0M2
 %0A */

Replace usage of deprecated localReferenceEntityReferenceSerializer by EntityReference#removeParent