Merge changes I05be0a5b,Ieee334f4

* changes:
  Document that repo returned by SubmoduleAddCommand needs to be closed
  Document that Git instance returned by CloneCommand needs to be closed

org.eclipse.jgit/src/org/eclipse/jgit/api/CloneCommand.java

@@ -114,6 +114,12 @@ public class CloneCommand extends TransportCommand<CloneCommand, Git> {
 	/**
 	 * Executes the {@code Clone} command.
 	 *
+	 * The Git instance returned by this command needs to be closed by the
+	 * caller to free resources held by the underlying {@link Repository}
+	 * instance. It is recommended to call this method as soon as you don't need
+	 * a reference to this {@link Git} instance and the underlying
+	 * {@link Repository} instance anymore.
+	 *
 	 * @return the newly created {@code Git} object with associated repository
 	 * @throws InvalidRemoteException
 	 * @throws org.eclipse.jgit.api.errors.TransportException

org.eclipse.jgit/src/org/eclipse/jgit/api/SubmoduleAddCommand.java

@@ -136,6 +136,17 @@ public class SubmoduleAddCommand extends
 		return SubmoduleWalk.forIndex(repo).setFilter(filter).next();
 	}
 
+	/**
+	 * Executes the {@code SubmoduleAddCommand}
+	 *
+	 * The {@code Repository} instance returned by this command needs to be
+	 * closed by the caller to free resources held by the {@code Repository}
+	 * instance. It is recommended to call this method as soon as you don't need
+	 * a reference to this {@code Repository} instance anymore.
+	 *
+	 * @return the newly created {@link Repository}
+	 * @throws GitAPIException
+	 */
 	public Repository call() throws GitAPIException {
 		checkCallable();
 		if (path == null || path.length() == 0)