Improve javadoc for MergeCommand.setFastForward()

- mark parameter to be nullable
- explain that we fallback to value of merge.ff if set to null and to
--ff if also not configured there

Change-Id: Id077763b95195d21543ac637f9939a6d4179e982
Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>
This commit is contained in:
Matthias Sohn 2017-06-15 22:58:29 +02:00
parent caefdf54ee
commit a45b045c73
1 changed files with 7 additions and 3 deletions

View File

@ -53,6 +53,7 @@
import java.util.Locale;
import java.util.Map;
import org.eclipse.jgit.annotations.Nullable;
import org.eclipse.jgit.api.MergeResult.MergeStatus;
import org.eclipse.jgit.api.errors.CheckoutConflictException;
import org.eclipse.jgit.api.errors.ConcurrentRefUpdateException;
@ -554,12 +555,15 @@ public MergeCommand setSquash(boolean squash) {
* Sets the fast forward mode.
*
* @param fastForwardMode
* corresponds to the --ff/--no-ff/--ff-only options. --ff is the
* default option.
* corresponds to the --ff/--no-ff/--ff-only options. If
* {@code null} use the value of the {@code merge.ff} option
* configured in git config. If this option is not configured
* --ff is the built-in default.
* @return {@code this}
* @since 2.2
*/
public MergeCommand setFastForward(FastForwardMode fastForwardMode) {
public MergeCommand setFastForward(
@Nullable FastForwardMode fastForwardMode) {
checkCallable();
this.fastForwardMode = fastForwardMode;
return this;