//
// $Id$
//
// Depot library - a Java relational persistence library
// Copyright (C) 2006-2009 Michael Bayne and Pär Winzell
//
// This library 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 library 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 library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

package com.samskivert.depot;

import java.util.ArrayList;
import java.util.Collection;
import java.util.List;

import com.google.common.base.Function;

/**
 * Extends the {@link List} interface with a method {@link #map} that makes it easy to convert the
 * contents of the list to an ordered {@link Collection} of a different type via the application of
 * a {@link Function}.
 */
public interface XList<T> extends List<T>
{
    /**
     * Returns mapping of this list via the specified mapping function. The result is a {@link
     * Collection} to remind the caller that it is not an {@link ArrayList} but rather a lazy list
     * that will call the mapping function on the fly each time an element is read. Caveat coder.
     */
    public <R> Collection<R> map (Function<? super T, ? extends R> mapper);
}

@@ -1012,16 +1012,60 @@
 ction;%0A%0A
+import com.samskivert.depot.util.Sequence;%0A%0A
 /**%0A * E
@@ -1349,300 +1349,97 @@
   * 
-Returns mapping of this list via the specified mapping function. The result is a %7B@link%0A     * Collection%7D to remind the caller that it is not an %7B@link ArrayList%7D but rather a lazy list%0A     * that will call the mapping function on the fly each time an element is read. Caveat coder.%0A     */
+@deprecated Use %7B@link DepotRepository#map%7D and %7B@link Sequence%7D.%0A     */%0A    @Deprecated
 %0A   

Bring on the deprecation warnings.