Improved some documentation.

forge/forge_common/net/minecraft/src/forge/IConnectRedstone.java

@@ -17,8 +17,10 @@ import net.minecraft.src.IBlockAccess;
 public interface IConnectRedstone {
     
     /**
-     * When this returns false, the block at location i, j, k cannot provide
-     * redstone power to the direction given in parameter, otherwise it can.
+     * When this returns false, the block at location i, j, k cannot make
+     * a redstone connection in the direction given in parameter, otherwise
+     * it can.  Use to control which sides are inputs and outputs for redstone
+     * wires.
      */
     public boolean canConnectRedstone(IBlockAccess iba, int i, int j, int k,
             int dir);

forge/forge_common/net/minecraft/src/forge/IMultipassRender.java

@@ -5,6 +5,13 @@
 
 package net.minecraft.src.forge;
 
+/** This interface is to be implemented by a Block class.  Allows a block
+ * type to perform rendering in both render passes, in case some parts of the
+ * block are solid and others are transparent.
+ */
 public interface IMultipassRender {
+	/** Returns true when the block has things to render in this render
+	 * pass.
+	 */
 	public boolean canRenderInPass(int n);
 }

forge/forge_common/net/minecraft/src/forge/IOverrideReplace.java

@@ -18,8 +18,8 @@ public interface IOverrideReplace {
     
     /**
      * Return true if this block has to take control over replacement, for
-     * the intended replacement given by the parameter bid. If true, then
-     * the actual replacement is supposed to have occured in the block.
+     * the intended replacement given by the parameter bid. If false, then
+     * the block replacement will be prevented.
      */
 	public boolean canReplaceBlock(World world, int i, int j, int k, int bid);