Added comments to most classes

2026-07-08 00:38:38 +00:00 · 2013-12-13 01:25:52 +01:00
parent 0e66ab2010
commit 6699233621
61 changed files with 225 additions and 16 deletions
@@ -1,6 +1,8 @@
 package org.parabot.core;

 /**
+ * 
+ * Holds some important constants
 * 
 * @author Everel
 *
@@ -6,6 +6,8 @@ import java.io.BufferedReader;
 import java.io.IOException;

 /**
+ * 
+ * The core of parabot
 * 
 * @author Everel
 * 
@@ -12,6 +12,8 @@ import javax.swing.JFileChooser;
 import org.parabot.environment.OperatingSystem;

 /**
+ * 
+ * Holds parabot's used directories
 * 
 * @author Everel
 * @author Matt
@@ -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
@@ -7,6 +7,8 @@ import org.objectweb.asm.tree.MethodNode;
 import org.parabot.core.Context;

 /**
+ * 
+ * A collection of various asm util methods
 * 
 * @author Everel
 * 
@@ -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
 * 
@@ -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
 *
@@ -1,7 +1,15 @@
 package org.parabot.core.asm.interfaces;

+/**
+ * Injectable
+ * @author Everel
+ *
+ */
 public interface Injectable {
 	
+	/**
+	 * Injects bytecode into a class
+	 */
 	public void inject();

 }
@@ -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
 *
@@ -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
 *
@@ -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
 *
@@ -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
 *
@@ -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
 *
@@ -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
 *
@@ -5,6 +5,8 @@ import java.net.URL;
 import java.net.URLClassLoader;

 /**
+ * 
+ * Class used for adding urls to the buildpath
 * 
 * @author Everel
 *
@@ -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
@@ -1,6 +1,8 @@
 package org.parabot.core.desc;

 /**
+ * 
+ * Holds information about a server
 * 
 * @author Everel
 * 
@@ -1,5 +1,12 @@
 package org.parabot.core.forum;

+/**
+ * 
+ * Gives access to account details
+ * 
+ * @author Everel
+ *
+ */
 public interface AccountManagerAccess {
 	
 	public void setManager(AccountManager manager);
@@ -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);

 }
@@ -8,6 +8,8 @@ import org.parabot.core.Directories;
 import org.parabot.core.build.BuildPath;

 /**
+ * 
+ * Jython util class
 * 
 * @author Everel
 *
@@ -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();

 }
@@ -9,6 +9,8 @@ import java.util.Queue;
 import org.parabot.core.Context;

 /**
+ * 
+ * Manages and paints on a collection of AbstractDebuggers
 * 
 * @author Everel
 *
@@ -13,6 +13,8 @@ import org.parabot.environment.scripts.ScriptManifest;
 import org.parabot.environment.scripts.loader.JavaScriptLoader;

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

 /**
 * 
- * Parser python scripts
+ * Parses python scripts
 * 
 * @author Everel
 *
@@ -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
 *
@@ -10,6 +10,8 @@ import org.parabot.core.jython.Jython;
 import org.parabot.environment.scripts.ScriptExecuter;

 /**
+ * 
+ * Abstract class for parsing scripts
 * 
 * @author Everel
 *
@@ -13,6 +13,8 @@ import java.awt.event.ActionEvent;
 import java.awt.event.ActionListener;

 /**
+ * 
+ * The bot user interface
 * 
 * @author Dane, Everel
 * 
@@ -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
 *
@@ -17,6 +17,8 @@ import org.parabot.core.logging.SystemConsoleHandler;
 import org.parabot.core.logging.TextAreaLogHandler;

 /**
+ * 
+ * The LogArea of the BotUI
 * 
 * @author Everel
 *
@@ -7,6 +7,8 @@ import java.awt.Graphics2D;
 import java.awt.geom.Rectangle2D;

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

 /**
+ * 
+ * Game Applet holder
 * 
 * @author Everel
 * 
@@ -6,6 +6,8 @@ import java.util.HashMap;
 import javax.imageio.ImageIO;

 /**
+ * 
+ * Caches and loads images from resource
 * 
 * @author Everel
 *
@@ -4,6 +4,8 @@ import java.awt.Dimension;
 import java.awt.Toolkit;

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

 /**
+ * 
+ * Holds various swing util based methods
 * 
 * @author Dane
 *
@@ -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
 *
@@ -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
 *