temporary fix for javadoc issues, will revisit later

generator/src/main/java/bwmirror/generator/java/Mirror.java

@@ -16,7 +16,7 @@ import java.io.PrintStream;
  */
 public abstract class Mirror {
 
-    private static final boolean WRITE_DOC = true;
+    private static final boolean WRITE_DOC = false; // TODO: need to fix encoding / special character issues before we can leave enabled
 
     private static final boolean FORCE_WEB_DOCUMENTATION = true;
 

manual-bwapi-src/AbstractPoint.java

@@ -4,7 +4,7 @@ package bwapi;
  * Common ancestor for location based objects to simplify distance computation.
  * This will be refactored into interface with default methods when java 8 becomes widely used.
  *
- * Idea by Rafał Poniatowski
+ * Idea by Rafa³ Poniatowski
  */
 public abstract class AbstractPoint<T extends AbstractPoint> {
 

manual-bwapi-src/Color.java

@@ -13,12 +13,6 @@ public class Color {
 
     private int r, g, b;
 
-    /**
-     * Create a color using the color in the palette that is closest to the RGB color specified. This will check a number of colors in the pallet to see which is closest to the specified color so this function is relatively slow.
-     * @param r
-     * @param g
-     * @param b
-     */
     public Color(int r, int g, int b) {
         this.r = r;
         this.g = g;

manual-bwapi-src/Mirror.java

@@ -11,42 +11,6 @@ import java.util.*;
 import java.util.regex.Pattern;
 import java.util.zip.*;
 
-/**
- * <p>The API entry point. Standard use case:</p>
- * <ul>
- *     <li>Create a Mirror object and use {@link #getModule()} and then set an {@link AIModule}'s {@link BWEventListener}<br/>
- *     <li>Call {@link #startGame()} to init the API and connect to Broodwar, then launch Broodwar from ChaosLauncher.</li>
- *     <li>In you {@link BWEventListener#onStart()} method, receive the Game object by calling {@link #getGame()}</li>
- * </ul>
- * <br/>
- * <b>Example</b>
- * <pre>
- *     {@code
- *
- *     mirror.getModule().setEventListener(new DefaultBWListener()
- *     {
- *            public void onStart() {
- *                game = mirror.getGame();
- *                self = game.self();
- *                //initialization
- *                ....
- *            }
- *
- *           public void onUpdate() {
- *               for (Unit myUnit : self.getUnits()) {
- *                   //give orders to unit
- *                   ...
- *                }
- *           }
- *        });
- *     }
- *     mirror.startGame();
- * </pre>
-
- * <p><b>Note:</b> The Game object is initialized during the {@link #startGame()} as well as other BWMirror API's constants.
- * Do not use any API releated methods/fields prior to {@link #startGame()}.</p>
-
- */
 public class Mirror {
 
     private Game game;