diff --git a/src/main/java/refinedstorage/api/autocrafting/registry/ICraftingTaskRegistry.java b/src/main/java/refinedstorage/api/autocrafting/registry/ICraftingTaskRegistry.java
index a51ff114b..58ac3098f 100755
--- a/src/main/java/refinedstorage/api/autocrafting/registry/ICraftingTaskRegistry.java
+++ b/src/main/java/refinedstorage/api/autocrafting/registry/ICraftingTaskRegistry.java
@@ -4,6 +4,7 @@ import javax.annotation.Nullable;
 
 /**
  * A registry that stores crafting task factories.
+ * Implement this for adding custom crafting tasks.
  */
 public interface ICraftingTaskRegistry {
     /**
diff --git a/src/main/java/refinedstorage/api/network/INetworkMaster.java b/src/main/java/refinedstorage/api/network/INetworkMaster.java
index 60ffefcf6..312a2d520 100755
--- a/src/main/java/refinedstorage/api/network/INetworkMaster.java
+++ b/src/main/java/refinedstorage/api/network/INetworkMaster.java
@@ -169,7 +169,7 @@ public interface INetworkMaster {
      *
      * @param stack    the stack prototype to insert, do NOT modify
      * @param size     the amount of that prototype that has to be inserted
-     * @param simulate if we are simulating
+     * @param simulate true if we are simulating, false otherwise
      * @return null if the insert was successful, or a stack with the remainder
      */
     @Nullable
@@ -191,7 +191,7 @@ public interface INetworkMaster {
      *
      * @param stack    the stack prototype to insert, do NOT modify
      * @param size     the amount of that prototype that has to be inserted
-     * @param simulate if we are simulating
+     * @param simulate true if we are simulating, false otherwise
      * @return null if the insert was successful, or a stack with the remainder
      */
     @Nullable
diff --git a/src/main/java/refinedstorage/api/network/grid/IFluidGridHandler.java b/src/main/java/refinedstorage/api/network/grid/IFluidGridHandler.java
index b50971e99..7de7a207f 100755
--- a/src/main/java/refinedstorage/api/network/grid/IFluidGridHandler.java
+++ b/src/main/java/refinedstorage/api/network/grid/IFluidGridHandler.java
@@ -13,7 +13,7 @@ public interface IFluidGridHandler {
      * Called when a player tries to extract a fluid from the grid.
      *
      * @param hash   the hash of the fluid we're trying to extract, see {@link refinedstorage.api.network.NetworkUtils#getFluidStackHashCode(net.minecraftforge.fluids.FluidStack)}
-     * @param shift  if shift click was used
+     * @param shift  true if shift click was used, false otherwise
      * @param player the player that is attempting the extraction
      */
     void onExtract(int hash, boolean shift, EntityPlayerMP player);
diff --git a/src/main/java/refinedstorage/api/network/grid/IItemGridHandler.java b/src/main/java/refinedstorage/api/network/grid/IItemGridHandler.java
index 8fe759003..8deea74d2 100755
--- a/src/main/java/refinedstorage/api/network/grid/IItemGridHandler.java
+++ b/src/main/java/refinedstorage/api/network/grid/IItemGridHandler.java
@@ -36,7 +36,7 @@ public interface IItemGridHandler {
      * Called when a player is trying to insert an item that it is holding in their hand in the GUI.
      *
      * @param player the player that is attempting the insert
-     * @param single if we are only inserting a single item
+     * @param single true if we are only inserting a single item, false otherwise
      */
     void onInsertHeldItem(EntityPlayerMP player, boolean single);
 
@@ -52,7 +52,7 @@ public interface IItemGridHandler {
      * Called when a player wants to cancel a crafting task.
      *
      * @param id    the task id, or -1 to cancel all tasks
-     * @param depth the child depth of this task to cancel
+     * @param depth the depth to cancel. 0 to cancel the entire task, or n to cancel the nth child of the task
      */
     void onCraftingCancelRequested(int id, int depth);
 }
diff --git a/src/main/java/refinedstorage/api/solderer/ISoldererRegistry.java b/src/main/java/refinedstorage/api/solderer/ISoldererRegistry.java
index be0b22de5..ffbd5ce10 100755
--- a/src/main/java/refinedstorage/api/solderer/ISoldererRegistry.java
+++ b/src/main/java/refinedstorage/api/solderer/ISoldererRegistry.java
@@ -21,13 +21,13 @@ public interface ISoldererRegistry {
      * Returns a solderer recipe from the rows.
      *
      * @param rows an item handler, where slots 0 - 2 are the rows
-     * @return the {@link ISoldererRecipe}, or null if no recipe was found
+     * @return the recipe, or null if no recipe was found
      */
     @Nullable
     ISoldererRecipe getRecipe(@Nonnull IItemHandler rows);
 
     /**
-     * @return a list with all the solderer recipes, do NOT modify
+     * @return a list with all the solderer recipes
      */
     List<ISoldererRecipe> getRecipes();
 }
diff --git a/src/main/java/refinedstorage/api/storage/CompareUtils.java b/src/main/java/refinedstorage/api/storage/CompareUtils.java
index 1b1632369..247cda5e7 100755
--- a/src/main/java/refinedstorage/api/storage/CompareUtils.java
+++ b/src/main/java/refinedstorage/api/storage/CompareUtils.java
@@ -6,7 +6,7 @@ import net.minecraftforge.oredict.OreDictionary;
 import org.apache.commons.lang3.ArrayUtils;
 
 /**
- * Utilities for comparing.
+ * Utilities for comparing item and fluid stacks.
  */
 public final class CompareUtils {
     public static final int COMPARE_DAMAGE = 1;
diff --git a/src/main/java/refinedstorage/api/storage/fluid/IFluidStorage.java b/src/main/java/refinedstorage/api/storage/fluid/IFluidStorage.java
index 7f7e0eb71..2351c2e47 100755
--- a/src/main/java/refinedstorage/api/storage/fluid/IFluidStorage.java
+++ b/src/main/java/refinedstorage/api/storage/fluid/IFluidStorage.java
@@ -22,7 +22,7 @@ public interface IFluidStorage {
      *
      * @param stack    the fluid prototype to insert, do NOT modify
      * @param size     the amount of that prototype that has to be inserted
-     * @param simulate if we are simulating
+     * @param simulate true if we are simulating, false otherwise
      * @return null if the insert was successful, or a stack with the remainder
      */
     @Nullable
diff --git a/src/main/java/refinedstorage/api/storage/item/IItemStorage.java b/src/main/java/refinedstorage/api/storage/item/IItemStorage.java
index e87e81877..1f8c9910e 100755
--- a/src/main/java/refinedstorage/api/storage/item/IItemStorage.java
+++ b/src/main/java/refinedstorage/api/storage/item/IItemStorage.java
@@ -22,7 +22,7 @@ public interface IItemStorage {
      *
      * @param stack    the stack prototype to insert, do NOT modify
      * @param size     the amount of that prototype that has to be inserted
-     * @param simulate if we are simulating
+     * @param simulate true if we are simulating, false otherwise
      * @return null if the insert was successful, or a stack with the remainder
      */
     @Nullable