Return-Path: Delivered-To: apmail-commons-commits-archive@locus.apache.org Received: (qmail 12482 invoked from network); 24 Dec 2007 19:57:58 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 24 Dec 2007 19:57:58 -0000 Received: (qmail 96406 invoked by uid 500); 24 Dec 2007 19:57:46 -0000 Delivered-To: apmail-commons-commits-archive@commons.apache.org Received: (qmail 96328 invoked by uid 500); 24 Dec 2007 19:57:45 -0000 Mailing-List: contact commits-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@commons.apache.org Delivered-To: mailing list commits@commons.apache.org Received: (qmail 96319 invoked by uid 99); 24 Dec 2007 19:57:45 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 24 Dec 2007 11:57:45 -0800 X-ASF-Spam-Status: No, hits=-100.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 24 Dec 2007 19:57:31 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id D4A431A9832; Mon, 24 Dec 2007 11:57:35 -0800 (PST) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r606734 - in /commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool: PoolUtils.java impl/CursorableLinkedList.java impl/GenericKeyedObjectPool.java impl/GenericObjectPool.java Date: Mon, 24 Dec 2007 19:57:35 -0000 To: commits@commons.apache.org From: psteitz@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20071224195735.D4A431A9832@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: psteitz Date: Mon Dec 24 11:57:33 2007 New Revision: 606734 URL: http://svn.apache.org/viewvc?rev=606734&view=rev Log: Javadoc only. Disambiguated some javadoc link references. JIRA: POOL-114 Reported and patched by Sebastian Bazley Modified: commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/PoolUtils.java commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/CursorableLinkedList.java commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericObjectPool.java Modified: commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/PoolUtils.java URL: http://svn.apache.org/viewvc/commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/PoolUtils.java?rev=606734&r1=606733&r2=606734&view=diff ============================================================================== --- commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/PoolUtils.java (original) +++ commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/PoolUtils.java Mon Dec 24 11:57:33 2007 @@ -337,7 +337,7 @@ *

Note: * This should not be used on pool implementations that already provide proper synchronization * such as the pools provided in the Commons Pool library. Wrapping a pool that - * {@link #wait waits} for poolable objects to be returned before allowing another one to be + * {@link #wait() waits} for poolable objects to be returned before allowing another one to be * borrowed with another layer of synchronization will cause liveliness issues or a deadlock. *

* @@ -368,7 +368,7 @@ *

Note: * This should not be used on pool implementations that already provide proper synchronization * such as the pools provided in the Commons Pool library. Wrapping a pool that - * {@link #wait waits} for poolable objects to be returned before allowing another one to be + * {@link #wait() waits} for poolable objects to be returned before allowing another one to be * borrowed with another layer of synchronization will cause liveliness issues or a deadlock. *

* Modified: commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/CursorableLinkedList.java URL: http://svn.apache.org/viewvc/commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/CursorableLinkedList.java?rev=606734&r1=606733&r2=606734&view=diff ============================================================================== --- commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/CursorableLinkedList.java (original) +++ commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/CursorableLinkedList.java Mon Dec 24 11:57:33 2007 @@ -276,7 +276,7 @@ * is no longer necessary. * * @see #cursor(int) - * @see #listIterator + * @see #listIterator() * @see CursorableLinkedList.Cursor */ public CursorableLinkedList.Cursor cursor() { @@ -293,7 +293,7 @@ * is not bothered by concurrent modifications to the * underlying list. * - * @see #cursor + * @see #cursor() * @see #listIterator(int) * @see CursorableLinkedList.Cursor * @throws IndexOutOfBoundsException if the index is out of range (index @@ -483,7 +483,7 @@ /** * Returns a fail-fast ListIterator. - * @see List#listIterator + * @see List#listIterator() */ public ListIterator listIterator() { return listIterator(0); @@ -646,7 +646,7 @@ /** * Returns an array containing all of the elements in this list in proper - * sequence. Obeys the general contract of the {@link Collection#toArray} method. + * sequence. Obeys the general contract of the {@link Collection#toArray()} method. * * @return an array containing all of the elements in this list in proper * sequence. @@ -664,7 +664,7 @@ * Returns an array containing all of the elements in this list in proper * sequence; the runtime type of the returned array is that of the * specified array. Obeys the general contract of the - * {@link Collection#toArray} method. + * {@link Collection#toArray()} method. * * @param a the array into which the elements of this list are to * be stored, if it is big enough; otherwise, a new array of the Modified: commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java?rev=606734&r1=606733&r2=606734&view=diff ============================================================================== --- commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java (original) +++ commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java Mon Dec 24 11:57:33 2007 @@ -87,7 +87,7 @@ *
  • * When {@link #setWhenExhaustedAction whenExhaustedAction} * is {@link #WHEN_EXHAUSTED_BLOCK}, {@link #borrowObject borrowObject} will block - * (invoke {@link Object#wait wait} until a new or idle object is available. + * (invoke {@link Object#wait() wait} until a new or idle object is available. * If a positive {@link #setMaxWait maxWait} * value is supplied, the {@link #borrowObject borrowObject} will block for at * most that many milliseconds, after which a {@link NoSuchElementException} @@ -809,7 +809,7 @@ * Sets the number of objects to examine during each run of the * idle object evictor thread (if any). *

    - * When a negative value is supplied, ceil({@link #getNumIdle})/abs({@link #getNumTestsPerEvictionRun}) + * When a negative value is supplied, ceil({@link #getNumIdle()})/abs({@link #getNumTestsPerEvictionRun}) * tests will be run. I.e., when the value is -n, roughly one nth of the * idle objects will be tested per run. * Modified: commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericObjectPool.java?rev=606734&r1=606733&r2=606734&view=diff ============================================================================== --- commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericObjectPool.java (original) +++ commons/proper/pool/branches/1_4_RELEASE_BRANCH/src/java/org/apache/commons/pool/impl/GenericObjectPool.java Mon Dec 24 11:57:33 2007 @@ -67,7 +67,7 @@ *

  • * When {@link #setWhenExhaustedAction whenExhaustedAction} * is {@link #WHEN_EXHAUSTED_BLOCK}, {@link #borrowObject} will block - * (invoke {@link Object#wait} until a new or idle object is available. + * (invoke {@link Object#wait()} until a new or idle object is available. * If a positive {@link #setMaxWait maxWait} * value is supplied, the {@link #borrowObject} will block for at * most that many milliseconds, after which a {@link NoSuchElementException}