From 2038d69d921a8018a56983acd279264c57735134 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala <iluwatar@gmail.com>
Date: Sun, 31 Aug 2014 08:29:50 +0300
Subject: [PATCH] Commented factory method example.

---
 factory-method/src/main/java/com/iluwatar/App.java        | 8 ++++++++
 factory-method/src/main/java/com/iluwatar/Blacksmith.java | 5 +++++
 .../src/main/java/com/iluwatar/ElfBlacksmith.java         | 5 +++++
 .../src/main/java/com/iluwatar/OrcBlacksmith.java         | 5 +++++
 4 files changed, 23 insertions(+)

diff --git a/factory-method/src/main/java/com/iluwatar/App.java b/factory-method/src/main/java/com/iluwatar/App.java
index 6b19c5f7e..d9af81227 100644
--- a/factory-method/src/main/java/com/iluwatar/App.java
+++ b/factory-method/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,13 @@
 package com.iluwatar;
 
+/**
+ * 
+ * In Factory Method we have an interface (Blacksmith) with a
+ * method for creating objects (manufactureWeapon). The concrete
+ * subclasses (OrcBlacksmith, ElfBlacksmith) then override the 
+ * method to produce objects of their liking.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )
diff --git a/factory-method/src/main/java/com/iluwatar/Blacksmith.java b/factory-method/src/main/java/com/iluwatar/Blacksmith.java
index fad8382a8..ac488b27d 100644
--- a/factory-method/src/main/java/com/iluwatar/Blacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/Blacksmith.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * The interface containing method for producing objects.
+ *
+ */
 public interface Blacksmith {
 
 	Weapon manufactureWeapon(WeaponType weaponType);
diff --git a/factory-method/src/main/java/com/iluwatar/ElfBlacksmith.java b/factory-method/src/main/java/com/iluwatar/ElfBlacksmith.java
index 606c913a8..067584088 100644
--- a/factory-method/src/main/java/com/iluwatar/ElfBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/ElfBlacksmith.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Concrete subclass for creating new objects.
+ *
+ */
 public class ElfBlacksmith implements Blacksmith {
 
 	public Weapon manufactureWeapon(WeaponType weaponType) {
diff --git a/factory-method/src/main/java/com/iluwatar/OrcBlacksmith.java b/factory-method/src/main/java/com/iluwatar/OrcBlacksmith.java
index a99a9b5a5..60730d15f 100644
--- a/factory-method/src/main/java/com/iluwatar/OrcBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/OrcBlacksmith.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Concrete subclass for creating new objects.
+ *
+ */
 public class OrcBlacksmith implements Blacksmith {
 
 	public Weapon manufactureWeapon(WeaponType weaponType) {