Added information about JAVA_HOME to README.md

sansumbrella · sansumbrella · commit feb87eb5151a · 2014-03-26T10:49:16.000-04:00
diff --git a/java_generate/README.md b/java_generate/README.md
@@ -14,22 +14,41 @@ In other words, the two repositories should live side-by-side:
 - base_dir/processing-web/
 
 ### Running java-generate
+The documentation is build using a command-line script.
+```
 $ cd ReferenceGenerator/
 $ ./processingrefBuild.sh
+```
 
 ### Building the Java-Generate classes
 
 Java-generate is compiled using ant, which is likely already installed on your machine.
-To build the
+To build the reference generator
+
+```bash
 $ cd ReferenceGenerator/
 $ ant compile
+```
 
 For more information on ant, see http://ant.apache.org
 
+If you have trouble compiling with ant, you may need to install the JDK on your machine
+and add a JAVA_HOME environment variable to your machine. Properly locating your JDK is
+essential for handling issues like importing the javadoc package.
+
+On OSX (Mavericks), that will look like the following:
+```bash
+# in e.g. ~/.bash_profile
+# tell Java where to find JDK and libraries
+export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_51.jdk/Contents/Home
+```
+
 ### Tips & Tricks
 
 When a method is overloaded, but you don't want one of the variants to appear in the reference, add a `@nowebref` comment to the source above that variant.  For example:
 
-	/**
-	  * @nowebref
-	  */
+```java
+/**
+  * @nowebref
+  */
+```
