Added comments to most classes

parabotv2/src/org/parabot/core/Configuration.java

@@ -1,6 +1,8 @@
 package org.parabot.core;
 
 /**
+ * 
+ * Holds some important constants
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/Core.java

@@ -6,6 +6,8 @@ import java.io.BufferedReader;
 import java.io.IOException;
 
 /**
+ * 
+ * The core of parabot
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/core/Directories.java

@@ -12,6 +12,8 @@ import javax.swing.JFileChooser;
 import org.parabot.environment.OperatingSystem;
 
 /**
+ * 
+ * Holds parabot's used directories
  * 
  * @author Everel
  * @author Matt

parabotv2/src/org/parabot/core/asm/ASMClassLoader.java

@@ -15,6 +15,8 @@ import org.objectweb.asm.tree.ClassNode;
 import org.parabot.core.classpath.ClassPath;
 
 /**
+ * 
+ * Makes classnodes into runnable classes
  * 
  * @author Everel
  * @author Matt

parabotv2/src/org/parabot/core/asm/ASMUtils.java

@@ -7,6 +7,8 @@ import org.objectweb.asm.tree.MethodNode;
 import org.parabot.core.Context;
 
 /**
+ * 
+ * A collection of various asm util methods
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/core/asm/adapters/AddInterfaceAdapter.java

@@ -6,6 +6,8 @@ import org.parabot.core.asm.ASMUtils;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class appends an interface to a class
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/core/asm/adapters/AddSuperAdapter.java

@@ -12,6 +12,8 @@ import org.parabot.core.asm.ASMUtils;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class is used for changing the super class of a class
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/asm/interfaces/Injectable.java

@@ -1,7 +1,15 @@
 package org.parabot.core.asm.interfaces;
 
+/**
+ * Injectable
+ * @author Everel
+ *
+ */
 public interface Injectable {
 	
+	/**
+	 * Injects bytecode into a class
+	 */
 	public void inject();
 
 }

parabotv2/src/org/parabot/core/asm/wrappers/Callback.java

@@ -6,6 +6,8 @@ import org.parabot.core.asm.adapters.AddCallbackAdapter;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class is used for injecting a callback into a methodnode
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/asm/wrappers/Getter.java

@@ -7,6 +7,8 @@ import org.parabot.core.asm.adapters.AddGetterAdapter;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class injects a getter which gets a specific field
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/asm/wrappers/Interface.java

@@ -4,6 +4,8 @@ import org.parabot.core.asm.adapters.AddInterfaceAdapter;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class appends an interface to a class
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/asm/wrappers/Invoker.java

@@ -7,6 +7,8 @@ import org.parabot.core.asm.adapters.AddInvokerAdapter;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class is used for injecting an invoker into a methodnode
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/asm/wrappers/Setter.java

@@ -7,6 +7,8 @@ import org.parabot.core.asm.adapters.AddSetterAdapter;
 import org.parabot.core.asm.interfaces.Injectable;
 
 /**
+ * 
+ * This class is used for injecting a setter for a specific field
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/asm/wrappers/Super.java

@@ -3,6 +3,8 @@ package org.parabot.core.asm.wrappers;
 import org.parabot.core.asm.adapters.AddSuperAdapter;
 import org.parabot.core.asm.interfaces.Injectable;
 /**
+ * 
+ * This class is used for changing the super class of a class
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/build/BuildPath.java

@@ -5,6 +5,8 @@ import java.net.URL;
 import java.net.URLClassLoader;
 
 /**
+ * 
+ * Class used for adding urls to the buildpath
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/classpath/ClassPath.java

@@ -27,6 +27,8 @@ import org.parabot.core.io.SizeInputStream;
 import org.parabot.core.ui.components.VerboseLoader;
 
 /**
+ * 
+ * Manages, parses and dumps class files & jars
  * 
  * @author Everel
  * @author Matt

parabotv2/src/org/parabot/core/desc/ServerDescription.java

@@ -1,6 +1,8 @@
 package org.parabot.core.desc;
 
 /**
+ * 
+ * Holds information about a server
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/core/forum/AccountManagerAccess.java

@@ -1,5 +1,12 @@
 package org.parabot.core.forum;
 
+/**
+ * 
+ * Gives access to account details
+ * 
+ * @author Everel
+ *
+ */
 public interface AccountManagerAccess {
 	
 	public void setManager(AccountManager manager);

parabotv2/src/org/parabot/core/io/ProgressListener.java

@@ -1,9 +1,24 @@
 package org.parabot.core.io;
 
+/**
+ * 
+ * Keeps track of a progress
+ * 
+ * @author Everel
+ *
+ */
 public interface ProgressListener {
 	
+	/**
+	 * Called when progress increased
+	 * @param value
+	 */
 	public void onProgressUpdate(double value);
 	
+	/**
+	 * Updates upload speed
+	 * @param mbPerSecond
+	 */
 	public void updateDownloadSpeed(double mbPerSecond);
 
 }

parabotv2/src/org/parabot/core/jython/Jython.java

@@ -8,6 +8,8 @@ import org.parabot.core.Directories;
 import org.parabot.core.build.BuildPath;
 
 /**
+ * 
+ * Jython util class
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/paint/AbstractDebugger.java

@@ -2,10 +2,24 @@ package org.parabot.core.paint;
 
 import org.parabot.environment.api.interfaces.Paintable;
 
+/**
+ * 
+ * Abstract class for debugging in game values & more
+ * 
+ * @author Everel
+ *
+ */
 public abstract class AbstractDebugger implements Paintable {
 	
+	/**
+	 * Toggles this debugger
+	 */
 	public abstract void toggle();
 	
+	/**
+	 * 
+	 * @return <b>true</b> if this debugger is enabled, otherwise <b>false</b>
+	 */
 	public abstract boolean isEnabled();
 
 }

parabotv2/src/org/parabot/core/paint/PaintDebugger.java

@@ -9,6 +9,8 @@ import java.util.Queue;
 import org.parabot.core.Context;
 
 /**
+ * 
+ * Manages and paints on a collection of AbstractDebuggers
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/parsers/scripts/LocalJavaScripts.java

@@ -13,6 +13,8 @@ import org.parabot.environment.scripts.ScriptManifest;
 import org.parabot.environment.scripts.loader.JavaScriptLoader;
 
 /**
+ * 
+ * Parses locally stored java scripts
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/parsers/scripts/LocalPythonScripts.java

@@ -14,7 +14,7 @@ import org.python.util.PythonInterpreter;
 
 /**
  * 
- * Parser python scripts
+ * Parses python scripts
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/parsers/scripts/SDNScripts.java

@@ -10,6 +10,8 @@ import org.parabot.environment.api.utils.WebUtil;
 import org.parabot.environment.scripts.SDNScriptExecuter;
 
 /**
+ * 
+ * Parses scripts stored at parabot´s sdn
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/parsers/scripts/ScriptParser.java

@@ -10,6 +10,8 @@ import org.parabot.core.jython.Jython;
 import org.parabot.environment.scripts.ScriptExecuter;
 
 /**
+ * 
+ * Abstract class for parsing scripts
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/ui/BotUI.java

@@ -13,6 +13,8 @@ import java.awt.event.ActionEvent;
 import java.awt.event.ActionListener;
 
 /**
+ * 
+ * The bot user interface
  * 
  * @author Dane, Everel
  * 

parabotv2/src/org/parabot/core/ui/LoginUI.java

@@ -25,6 +25,8 @@ import org.parabot.core.ui.images.Images;
 import org.parabot.core.ui.utils.SwingUtil;
 
 /**
+ * 
+ * Users must login with their parabot account through this LoginUI class
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/ui/components/LogArea.java

@@ -17,6 +17,8 @@ import org.parabot.core.logging.SystemConsoleHandler;
 import org.parabot.core.logging.TextAreaLogHandler;
 
 /**
+ * 
+ * The LogArea of the BotUI
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/ui/components/ProgressBar.java

@@ -7,6 +7,8 @@ import java.awt.Graphics2D;
 import java.awt.geom.Rectangle2D;
 
 /**
+ * 
+ * ProgressBar
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/ui/components/ServerPanel.java

@@ -8,6 +8,8 @@ import javax.swing.GroupLayout;
 import javax.swing.JPanel;
 
 /**
+ * 
+ * Game Applet holder
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/core/ui/images/Images.java

@@ -6,6 +6,8 @@ import java.util.HashMap;
 import javax.imageio.ImageIO;
 
 /**
+ * 
+ * Caches and loads images from resource
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/ui/utils/AwtUtil.java

@@ -4,6 +4,8 @@ import java.awt.Dimension;
 import java.awt.Toolkit;
 
 /**
+ * 
+ * Holds various awt util based methods
  * 
  * @author Dane
  *

parabotv2/src/org/parabot/core/ui/utils/SwingUtil.java

@@ -3,6 +3,8 @@ package org.parabot.core.ui.utils;
 import javax.swing.JFrame;
 
 /**
+ * 
+ * Holds various swing util based methods
  * 
  * @author Dane
  *

parabotv2/src/org/parabot/core/ui/utils/UILog.java

@@ -3,6 +3,8 @@ package org.parabot.core.ui.utils;
 import javax.swing.JOptionPane;
 
 /**
+ * 
+ * Log messages to the log user interface which is attached to the bot user interface
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/core/ui/widgets/ServerWidget.java

@@ -18,7 +18,7 @@ import org.parabot.core.ui.ServerSelector;
 import org.parabot.environment.Environment;
 
 /**
- * A colorful server widget
+ * A neat looking server widget
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/environment/Environment.java

@@ -9,6 +9,8 @@ import org.parabot.core.ui.components.VerboseLoader;
 import org.parabot.environment.api.utils.WebUtil;
 
 /**
+ * 
+ * Initiliazes the bot environment
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/environment/OperatingSystem.java

@@ -1,5 +1,12 @@
 package org.parabot.environment;
 
+/**
+ * 
+ * This class is used for detecting the user's operating system
+ * 
+ * @author Everel
+ * 
+ */
 public enum OperatingSystem {
 
 	WINDOWS, LINUX, MAC, OTHER;

parabotv2/src/org/parabot/environment/api/utils/Filter.java

@@ -1,14 +1,17 @@
 package org.parabot.environment.api.utils;
 
 /**
- * A simple class to filter things
+ * A simple class to filter things out of an collection
  * 
  * @author Everel
  * 
  * @param <F>
  */
-public interface Filter<F>
+public interface Filter<F> {
-{
+	/**
+	 * Determines if this object should be accepted
+	 * @param f
+	 * @return <b>true</b> to include this object, otherwise <b>false</b> to exclude.
+	 */
 	public boolean accept(F f);
 }
-

parabotv2/src/org/parabot/environment/api/utils/Random.java

@@ -1,6 +1,8 @@
 package org.parabot.environment.api.utils;
 
 /**
+ * 
+ * A random class is used for generating random numbers
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/api/utils/Time.java

@@ -1,6 +1,8 @@
 package org.parabot.environment.api.utils;
 
 /**
+ * 
+ * Holds various Time utilities
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/api/utils/Timer.java

@@ -7,8 +7,7 @@ package org.parabot.environment.api.utils;
  * @author Everel, Parameter
  * 
  */
-public class Timer
+public class Timer {
-{
 
 	private long start;
 	private long end;
@@ -18,8 +17,7 @@ public class Timer
 	 * 
 	 * @param start
 	 */
-	public Timer(long end)
+	public Timer(long end) {
-	{
 
 		start = System.currentTimeMillis();
 		this.end = System.currentTimeMillis() + end;
@@ -28,8 +26,7 @@ public class Timer
 	/**
 	 * Timer Constructor
 	 */
-	public Timer()
+	public Timer() {
-	{
 		this(0);
 	}
 
@@ -43,7 +40,8 @@ public class Timer
 	}
 
 	/**
-	 * Determines if the end time has been reached, does not mean it stopped running.
+	 * Determines if the end time has been reached, does not mean it stopped
+	 * running.
 	 */
 	public boolean isFinished() {
 		return System.currentTimeMillis() > end;

parabotv2/src/org/parabot/environment/api/utils/WebUtil.java

@@ -15,6 +15,8 @@ import org.parabot.core.io.ProgressListener;
 import org.parabot.core.io.SizeInputStream;
 
 /**
+ * 
+ * A WebUtil class fetches data from an URL
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/environment/input/Keyboard.java

@@ -9,6 +9,8 @@ import java.util.Random;
 import org.parabot.core.Context;
 
 /**
+ * 
+ * Virtual keyboard, dispatches key events to a component.
  * 
  * @author Everel, Matt, Dane
  *

parabotv2/src/org/parabot/environment/input/Mouse.java

@@ -10,6 +10,8 @@ import org.parabot.core.Context;
 import org.parabot.environment.api.utils.Time;
 
 /**
+ * 
+ * A virtual mouse, dispatches mouse events to a component
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/scripts/Category.java

@@ -7,6 +7,8 @@ import org.parabot.core.ui.images.Images;
 
 
 /**
+ * 
+ * Holds script categories
  * 
  * @author Dane
  * 
@@ -16,10 +18,19 @@ public enum Category
 
 	AGILITY, COMBAT, COOKING, CRAFTING, FARMING, FIREMAKING, FISHING, FLETCHING, HERBLORE, MAGIC, MINING, OTHER, PRAYER, RUNECRAFTING, SLAYER, SMITHING, THIEVING, UTILITY, WOODCUTTING;
 
+	/**
+	 * Gets image belonging to this category
+	 * @return icon
+	 */
 	public BufferedImage getIcon() {
 		return Category.getIcon(this.name().toLowerCase());
 	}
 
+	/**
+	 * Gets category icon image from filename
+	 * @param s
+	 * @return icon
+	 */
 	public static BufferedImage getIcon(String s) {
 		if (images.get(s) == null) {
 			images.put(s, Images.getResource("/org/parabot/core/ui/images/category/" + s + ".png"));
@@ -35,6 +46,9 @@ public enum Category
 		return new String(b);
 	}
 
+	/**
+	 * Cache
+	 */
 	private static HashMap<String, BufferedImage> images = new HashMap<String, BufferedImage>();
 
 	static {

parabotv2/src/org/parabot/environment/scripts/Frameworks.java

@@ -7,6 +7,8 @@ import org.parabot.environment.scripts.framework.LoopTask;
 import org.parabot.environment.scripts.framework.Strategy;
 
 /**
+ * 
+ * Holds various script frameworks
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/scripts/LocalScriptExecuter.java

@@ -1,6 +1,8 @@
 package org.parabot.environment.scripts;
 
 /**
+ * 
+ * Loads a locally stored script
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/scripts/SDNScriptExecuter.java

@@ -15,6 +15,8 @@ import org.parabot.environment.api.utils.WebUtil;
 import org.parabot.environment.scripts.loader.JavaScriptLoader;
 
 /**
+ * 
+ * Loads a script from the SDN
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/scripts/Script.java

@@ -13,6 +13,8 @@ import org.parabot.environment.scripts.framework.SleepCondition;
 import org.parabot.environment.scripts.framework.Strategy;
 
 /**
+ * 
+ * Script template, scripts are 'add-ons' which executes various tasks in-game
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/scripts/ScriptExecuter.java

@@ -1,9 +1,21 @@
 package org.parabot.environment.scripts;
 
+/**
+ * 
+ * Executes a script
+ * 
+ * @author Everel
+ *
+ */
 public abstract class ScriptExecuter {
 	
 	public abstract void run(final ThreadGroup tg);
 	
+	/**
+	 * Start script.
+	 * @param tg
+	 * @param script
+	 */
 	public final void finalize(final ThreadGroup tg, final Script script) {
 		new Thread(tg, script).start();
 	}

parabotv2/src/org/parabot/environment/scripts/ScriptManifest.java

@@ -4,7 +4,7 @@ import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 
 /**
- * A script manifest
+ * A script manifest, holds all script data
  * @author Everel
  *
  */

parabotv2/src/org/parabot/environment/scripts/framework/AbstractFramework.java

@@ -1,5 +1,12 @@
 package org.parabot.environment.scripts.framework;
 
+/**
+ * 
+ * Abstract framework for a script
+ * 
+ * @author Everel
+ *
+ */
 public abstract class AbstractFramework {
 	
 	public abstract boolean execute();

parabotv2/src/org/parabot/environment/scripts/framework/LoopTask.java

@@ -1,7 +1,18 @@
 package org.parabot.environment.scripts.framework;
 
+/**
+ * 
+ * A LoopTask interface is used to keep calling the loop method which should return the sleep time
+ * 
+ * @author Everel
+ *
+ */
 public interface LoopTask {
 	
+	/**
+	 *
+	 * @return sleepTime in ms
+	 */
 	public int loop();
 
 }

parabotv2/src/org/parabot/environment/scripts/framework/PythonScript.java

@@ -2,6 +2,12 @@ package org.parabot.environment.scripts.framework;
 
 import org.parabot.environment.scripts.Script;
 
+/**
+ * Jython script, only supports a loop
+ * 
+ * @author Everel
+ *
+ */
 public abstract class PythonScript extends Script {
 	
 	public abstract int loop();

parabotv2/src/org/parabot/environment/scripts/framework/SleepCondition.java

@@ -1,7 +1,17 @@
 package org.parabot.environment.scripts.framework;
 
+/**
+ * Keeps sleeping till a condition is valid
+ * 
+ * @author Everel
+ *
+ */
 public interface SleepCondition {
 	
+	/**
+	 * Determine if condition is valid
+	 * @return <b>true</b> if valid, otherwise <b>false</b>.
+	 */
 	public boolean isValid();
 
 }

parabotv2/src/org/parabot/environment/scripts/framework/Strategy.java

@@ -1,9 +1,22 @@
 package org.parabot.environment.scripts.framework;
 
+/**
+ * Strategy framework for scripts
+ * 
+ * @author Everel
+ *
+ */
 public interface Strategy {
 	
+	/**
+	 * Whether to activate this strategy
+	 * @return <b>true</b> if this strategy should be executed, otherwise <b>false</b>.
+	 */
 	public boolean activate();
 	
+	/**
+	 * Executes this strategy
+	 */
 	public void execute();
 
 }

parabotv2/src/org/parabot/environment/scripts/loader/JavaScriptLoader.java

@@ -10,7 +10,7 @@ import org.parabot.environment.scripts.Script;
 
 /**
  * 
- * An environment to load a server
+ * An environment to load a script
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/environment/servers/PublicServerExecuter.java

@@ -18,6 +18,8 @@ import org.parabot.environment.api.utils.WebUtil;
 import org.parabot.environment.servers.loader.ServerLoader;
 
 /**
+ * 
+ * Fetches a server provider from the parabot sdn
  * 
  * @author Everel
  * 

parabotv2/src/org/parabot/environment/servers/ServerExecuter.java

@@ -4,6 +4,8 @@ import org.parabot.core.Context;
 import org.parabot.core.ui.components.BotToolbar;
 
 /**
+ * 
+ * Executes a server provider
  * 
  * @author Everel
  *

parabotv2/src/org/parabot/environment/servers/Type.java

@@ -2,7 +2,7 @@ package org.parabot.environment.servers;
 
 /**
  * 
- * Bot type
+ * Server provider type
  * 
  * @author Everel
  *