Document several undocumented arguments and exceptions

src/main/java/dan200/computercraft/api/lua/ILuaObject.java

@@ -21,6 +21,7 @@ public interface ILuaObject
      * Get the names of the methods that this object implements. This works the same as {@link IPeripheral#getMethodNames()}.
      * See that method for detailed documentation.
      *
+     * @return The method names this object provides.
      * @see IPeripheral#getMethodNames()
      */
     public String[] getMethodNames();
@@ -30,6 +31,16 @@ public interface ILuaObject
      * {@link IPeripheral#callMethod(IComputerAccess, ILuaContext, int, Object[])}}. See that method for detailed
      * documentation.
      *
+     * @param context   The context of the currently running lua thread. This can be used to wait for events
+     *                  or otherwise yield.
+     * @param method    An integer identifying which of the methods from getMethodNames() the computercraft
+     *                  wishes to call. The integer indicates the index into the getMethodNames() table
+     *                  that corresponds to the string passed into peripheral.call()
+     * @param arguments The arguments for this method. See {@link IPeripheral#callMethod(IComputerAccess, ILuaContext, int, Object[])}
+     *                  the possible values and conversion rules.
+     * @return An array of objects, representing the values you wish to return to the Lua program.
+     * See {@link IPeripheral#callMethod(IComputerAccess, ILuaContext, int, Object[])} for the valid values and
+     * conversion rules.
      * @throws LuaException         If the task could not be queued, or if the task threw an exception.
      * @throws InterruptedException If the user shuts down or reboots the computer the coroutine is suspended,
      *                              InterruptedException will be thrown. This exception must not be caught or