diff --git a/README.md b/README.md
index 4ccdc6b5..6acc90ea 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ Commands:
 
 <pre>
 	help ...... See this message. Type help [command name] to see specific help topics.
-	gen ....... Generate an example PhoneGap application to current directory.
+	gen ....... Generate the example PhoneGap application to current directory (or optionally provide an output directory as parameter).
 	create .... Creates an Android compatible project from a WWW folder. 
 	classic ... Backwards support for droidgap script. Run "droidgap help classic" for more info.
 	update .... Copy a fresh phonegap.jar and phonegap.js into a valid PhoneGap/Android project.
@@ -41,8 +41,8 @@ Commands:
 Quickstart:
 
 <pre>
-  	$ droidgap gen example 
-  	$ cd example
+  	$ droidgap gen exampleapp 
+  	$ cd exampleapp
 	$ ant debug install && adb logcat
 </pre>
 
diff --git a/bin/droidgap b/bin/droidgap
index 2ab56d66..bf93568e 100755
--- a/bin/droidgap
+++ b/bin/droidgap
@@ -60,7 +60,7 @@ if ARGV.first.nil? || ARGV.first == 'help'
   Commands:
   
   help ...... See this message. Type help [command name] to see specific help topics.
-  gen ....... Generate an example PhoneGap application to current directory.
+  gen ....... Generate the example PhoneGap application to current directory (or optionally provide an output directory as parameter).
   create .... Creates an Android compatible project from a WWW folder. 
   classic ... Backwards support for droidgap script. Run "droidgap help classic" for more info.
   update .... Copy a fresh phonegap.jar and phonegap.js into a valid PhoneGap/Android project.
@@ -68,8 +68,8 @@ if ARGV.first.nil? || ARGV.first == 'help'
     
   Quickstart:
   
-  $ droidgap gen example 
-  $ cd example
+  $ droidgap gen exampleapp 
+  $ cd exampleapp
   $ ant debug install && adb logcat
   
   EOF
@@ -79,11 +79,13 @@ if ARGV.first.nil? || ARGV.first == 'help'
   DroidGap Generate
   -----------------
   
-  Generate an example PhoneGap application to path supplied or current working directory if none is supplied.
+  Generate the example PhoneGap application to path supplied or current working directory if none is supplied.
   
   Usage:
   
     droidgap gen [path]
+    
+  NOTE: Do *not* run "droidgap gen example" - you will end up with a recursive directory problem.
   
   EOF