/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.commons.pool2.impl;

public interface EvictionPolicy<T> {
    boolean evict(EvictionConfig config, PooledObject<T> underTest,
            int idleCount);
}

@@ -840,44 +840,783 @@
 l;%0A%0A
-public interface EvictionPolicy%3CT%3E %7B
+/**%0A * To provide a custom eviction policy (i.e. something other than %7B@link%0A * DefaultEvictionPolicy%7D for a pool, users must provide an implementation of%0A * this interface that provides the required eviction policy.%0A */%0Apublic interface EvictionPolicy%3CT%3E %7B%0A    %0A    /**%0A     * This method is called to test if an idle object in the pool should be%0A     * evicted or not.%0A     * %0A     * @param config    The pool configuration settings related to eviction%0A     * @param underTest The pooled object being tested for eviction%0A     * @param idleCount The current number of idle objects in the pool including%0A     *                      the object under test%0A     * @return %3Ccode%3Etrue%3C/code%3E if the object should be evicted, otherwise%0A     *             %3Ccode%3Efalse%3C/code%3E%0A     */
 %0A   

Add some Javadoc