git meld README

NOTE: git meld is obsolete since git difftool learnt the --dir-diff option in git 1.7.11.

SYNOPSIS

git meld [options] <commit>{0,2} [--] [<path>...]

DESCRIPTION

git meld is a git command that allows you to compare and edit treeishs between revisions using meld or any other diff tool that supports directory comparison. git meld is a frontend to git diff and accepts the same options and arguments.

It is essentially an extended git-difftool for tools that support comparing directories rather than having git call the external tool for every file that has changed

EXAMPLE

Show the differences between the staging area and your working directory:

$ git meld

Show the differences between HEAD and the staging area (i.e. what would be commited if you were commit now:

$ git meld --cached

Show the differences between two commits ago and the working directory:

$ git meld HEAD^^

Show the differences between the tips of branch master and branch topic

$ git meld master..topic

Show all the changes made to branch topic since it branched off branch master

$ git meld master...topic

INSTALLATION

Add a git alias to your gitconfig with:

$ git config --global alias.meld '!/path/to/git-meld/git-meld.pl'

Alternatively add:

[alias]

meld = !/path/to/git-meld/git-meld.pl

To your ~/.gitconfig

CONFIGURATION

The following additional git configuration variables are available for setting up git meld for using diff tools other than meld:

treediff.tool

Controls which diff tool is used.

treediff.<tool>.path

Override the path for the given tool. This is useful in case your tool is not in the PATH.

treediff.<tool>.cmd

Specify the command to invoke the specified diff tool.

CONTACT

git repo, bug tracker and wiki for git meld are available on github at https://github.com/wmanley/git-meld

HOW IT WORKS

git meld uses "git diff --name-only" to extract the files that have changed between the two commits and then makes a copy of these files into a temporary directory before invoking meld on these copies.