diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/CheckoutCommand.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/CheckoutCommand.java
index 507168816..aa9939edd 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/api/CheckoutCommand.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/CheckoutCommand.java
@@ -731,7 +731,7 @@ public CheckoutCommand setStage(Stage stage) {
 	}
 
 	/**
-	 * <p>getResult.</p>
+	 * Get the result, never <code>null</code>
 	 *
 	 * @return the result, never <code>null</code>
 	 */
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/TransportCommand.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/TransportCommand.java
index 9032329ce..9c915377d 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/api/TransportCommand.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/TransportCommand.java
@@ -129,11 +129,10 @@ public C setTransportConfigCallback(
 		return self();
 	}
 
-	/** @return {@code this} */
 	/**
-	 * Return this command
+	 * Return this command cast to {@code C}
 	 *
-	 * @return this command
+	 * @return {@code this} cast to {@code C}
 	 */
 	@SuppressWarnings("unchecked")
 	protected final C self() {