git-mergetool--lib(1)

git-mergetool--lib1

Common git merge tool shell scriptlets

Usage

TOOL_MODE=(diff|merge) . "$(git --exec-path)/git-mergetool--lib"

Overview

This is not a command the end user would want to run. Ever. This documentation is meant for people who are studying the Porcelain-ish scripts and/or are writing new ones.

The git-mergetool--lib scriptlet is designed to be sourced (using .) by other shell scripts to set up functions for working with Git merge tools.

Before sourcing git-mergetool--lib, your script must set TOOL_MODE to define the operation mode for the functions listed below. diff and merge are valid values.

Functions

get_merge_tool

Returns a merge tool. The return code is 1 if we returned a guessed merge tool, else 0. $GIT_MERGETOOL_GUI may be set to true to search for the appropriate guitool.

get_merge_tool_cmd

Returns the custom command for a merge tool.

get_merge_tool_path

Returns the custom path for a merge tool.

initialize_merge_tool

Brings merge tool specific functions into scope so they can be used or overridden.

run_merge_tool

Launches a merge tool given the tool name and a true/false flag to indicate whether a merge base is present. $MERGED, $LOCAL, $REMOTE, and $BASE must be defined for use by the merge tool.

Git

Part of the git(1) suite

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 8 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

From git 2.56.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.