#107 Chain example JavaDoc improvements

chain/src/main/java/com/iluwatar/chain/App.java

@@ -2,14 +2,18 @@ package com.iluwatar.chain;
 
 /**
  * 
- * Chain of Responsibility organizes request handlers (RequestHandler) into a
+ * Chain of Responsibility organizes request handlers ({@link RequestHandler}) into a
  * chain where each handler has a chance to act on the request on its turn. In
- * this example the king (OrcKing) makes requests and the military orcs
- * (OrcCommander, OrcOfficer, OrcSoldier) form the handler chain.
+ * this example the king ({@link OrcKing}) makes requests and the military orcs
+ * ({@link OrcCommander}, {@link OrcOfficer}, {@link OrcSoldier}) form the handler chain.
  * 
  */
 public class App {
 
+	/**
+	 * Program entry point
+	 * @param args command line args
+	 */
 	public static void main(String[] args) {
 
 		OrcKing king = new OrcKing();

chain/src/main/java/com/iluwatar/chain/OrcCommander.java

@@ -1,5 +1,10 @@
 package com.iluwatar.chain;
 
+/**
+ * 
+ * OrcCommander
+ *
+ */
 public class OrcCommander extends RequestHandler {
 
 	public OrcCommander(RequestHandler handler) {

chain/src/main/java/com/iluwatar/chain/OrcKing.java

@@ -2,7 +2,7 @@ package com.iluwatar.chain;
 
 /**
  * 
- * Makes requests that are handled by the chain.
+ * OrcKing makes requests that are handled by the chain.
  * 
  */
 public class OrcKing {

chain/src/main/java/com/iluwatar/chain/OrcOfficer.java

@@ -1,5 +1,10 @@
 package com.iluwatar.chain;
 
+/**
+ * 
+ * OrcOfficer
+ *
+ */
 public class OrcOfficer extends RequestHandler {
 
 	public OrcOfficer(RequestHandler handler) {

chain/src/main/java/com/iluwatar/chain/OrcSoldier.java

@@ -1,5 +1,10 @@
 package com.iluwatar.chain;
 
+/**
+ * 
+ * OrcSoldier
+ *
+ */
 public class OrcSoldier extends RequestHandler {
 
 	public OrcSoldier(RequestHandler handler) {

chain/src/main/java/com/iluwatar/chain/Request.java

@@ -1,5 +1,10 @@
 package com.iluwatar.chain;
 
+/**
+ * 
+ * Request
+ *
+ */
 public class Request {
 
 	private String requestDescription;

chain/src/main/java/com/iluwatar/chain/RequestHandler.java

@@ -1,5 +1,10 @@
 package com.iluwatar.chain;
 
+/**
+ * 
+ * RequestHandler
+ *
+ */
 public abstract class RequestHandler {
 
 	private RequestHandler next;

chain/src/main/java/com/iluwatar/chain/RequestType.java

@@ -1,5 +1,10 @@
 package com.iluwatar.chain;
 
+/**
+ * 
+ * RequestType enumeration
+ *
+ */
 public enum RequestType {
 
 	DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX

chain/src/test/java/com/iluwatar/chain/AppTest.java

@@ -4,6 +4,11 @@ import org.junit.Test;
 
 import com.iluwatar.chain.App;
 
+/**
+ * 
+ * Application test
+ *
+ */
 public class AppTest {
 
 	@Test