From 86c68f96e3b44aeab61759fee375da2c1f03225e Mon Sep 17 00:00:00 2001
From: Ilkka Seppala <iluwatar@gmail.com>
Date: Fri, 21 Aug 2015 22:24:53 +0300
Subject: [PATCH] #107 Improve JavaDoc for Object Pool example

---
 .../src/main/java/com/iluwatar/object/pool/App.java    | 10 +++++++---
 .../test/java/com/iluwatar/object/pool/AppTest.java    |  5 +++++
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
index d47bc51be..c1893a774 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/App.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
@@ -5,21 +5,25 @@ package com.iluwatar.object.pool;
  * When it is necessary to work with a large number of objects that are particularly expensive to instantiate 
  * and each object is only needed for a short period of time, the performance of an entire application may be 
  * adversely affected. An object pool design pattern may be deemed desirable in cases such as these. 
- * 
+ * <p>
  * The object pool design pattern creates a set of objects that may be reused. When a new object is needed, it 
  * is requested from the pool. If a previously prepared object is available it is returned immediately, avoiding 
  * the instantiation cost. If no objects are present in the pool, a new item is created and returned. When the 
  * object has been used and is no longer needed, it is returned to the pool, allowing it to be used again in the 
  * future without repeating the computationally expensive instantiation process. It is important to note that 
  * once an object has been used and returned, existing references will become invalid.
- * 
- * In this example we have created OliphauntPool inheriting from generic ObjectPool. Oliphaunts can be checked
+ * <p>
+ * In this example we have created {@link OliphauntPool} inheriting from generic {@link ObjectPool}. {@link Oliphaunt}s can be checked
  * out from the pool and later returned to it. The pool tracks created instances and their status (available,
  * inUse).
  *
  */
 public class App {
 	
+	/**
+	 * Program entry point
+	 * @param args command line args
+	 */
     public static void main( String[] args ) {
     	OliphauntPool pool = new OliphauntPool();
     	System.out.println(pool);
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
index c856141db..4114590ec 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
@@ -4,6 +4,11 @@ import org.junit.Test;
 
 import com.iluwatar.object.pool.App;
 
+/**
+ * 
+ * Application test
+ *
+ */
 public class AppTest {
 	
 	@Test