vimdiff - Man Page
edit between two and eight versions of a file with Vim and show differences
Examples (TL;DR)
- Open two files and show the differences:
vimdiff path/to/file1 path/to/file2
- Move the cursor to the window on the left|right:
<Ctrl> + w h|l
- Jump to the previous difference:
[c
- Jump to the next difference:
]c
- Copy the highlighted difference from the other window to the current window:
do
- Copy the highlighted difference from the current window to the other window:
dp
- Update all highlights and folds:
:diffupdate
- Toggle the highlighted code fold:
za
Synopsis
vimdiff [options] file1 file2 [file3 [file4 [file5 [file6 [file7 [file8]]]]]]
gvimdiff
Description
Vimdiff starts Vim on two up to eight files. Each file gets its own window. The differences between the files are highlighted. This is a nice way to inspect changes and to move changes from one version to another version of the same file.
See vim(1) for details about Vim itself.
When started as gvimdiff the GUI will be started, if available.
In each window the 'diff' option will be set, which causes the differences to be highlighted.
The 'wrap' and 'scrollbind' options are set to make the text look good.
The 'foldmethod' option is set to "diff", which puts ranges of lines without changes in a fold. 'foldcolumn' is set to two to make it easy to spot the folds and open or close them.
Options
Vertical splits are used to align the lines, as if the "-O" argument was used. To use horizontal splits instead, use the "-o" argument.
For all other arguments see vim(1).
See Also
Author
Most of Vim was made by Bram Moolenaar, with a lot of help from others. See ":help credits" in Vim.
Referenced By
The man page gvimdiff(1) is an alias of vimdiff(1).