diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/CloneCommand.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/CloneCommand.java
index de24dadff..f058f799d 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/api/CloneCommand.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/CloneCommand.java
@@ -114,6 +114,12 @@ public CloneCommand() {
 	/**
 	 * 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
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/SubmoduleAddCommand.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/SubmoduleAddCommand.java
index 09e4cf0a1..06c8f414e 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/api/SubmoduleAddCommand.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/SubmoduleAddCommand.java
@@ -136,6 +136,17 @@ protected boolean submoduleExists() throws IOException {
 		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)