From c3a827b475c895493fd2d4256c46b817856eaee1 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala <iluwatar@gmail.com>
Date: Sun, 4 Oct 2015 00:08:34 +0300
Subject: [PATCH] Improved Proxy Javadoc

---
 proxy/src/main/java/com/iluwatar/proxy/App.java | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java
index fb401ac9f..420ad5c0a 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/App.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/App.java
@@ -2,7 +2,18 @@ package com.iluwatar.proxy;
 
 /**
  * 
- * Proxy ({@link WizardTowerProxy}) controls access to the actual object ({@link WizardTower}).
+ * A proxy, in its most general form, is a class functioning as an interface to something else. 
+ * The proxy could interface to anything: a network connection, a large object in memory, a file, 
+ * or some other resource that is expensive or impossible to duplicate. In short, a proxy is a 
+ * wrapper or agent object that is being called by the client to access the real serving object 
+ * behind the scenes.
+ * <p>
+ * The Proxy design pattern allows you to provide an interface to other objects by creating a 
+ * wrapper class as the proxy. The wrapper class, which is the proxy, can add additional 
+ * functionality to the object of interest without changing the object's code.
+ * <p>
+ * In this example the proxy ({@link WizardTowerProxy}) controls access to the actual object 
+ * ({@link WizardTower}).
  * 
  */
 public class App {