IMEDIFF2(1)															       IMEDIFF2(1)

NAME

       imediff2 - An interactive fullscreen 2-way merge tool

SYNOPSIS

       imediff2 [-m] [-u] [-a] [-b] [-c] [-N new-file] [-o outputfile] {file1} {file2}

DESCRIPTION

       Merge two (slightly different) files interactively with a user friendly fullscreen interface in text mode.

       Imediff2 shows the differences of given two files (in color if the terminal supports them), lets you scroll the file and toggle changes be-
       tween old and new version one by one. If the 'unresolved' mode is enabled, you can optionally save both versions.

       Additionally, if the $EDITOR environment variable is set or if /usr/bin/editor exists and is executable, you can also  launch  an  external
       editor and manually edit the half-merged file before saving it, perhaps to resolve the 'unresolved' parts.

       Empty  lines  are shown in reverse colors so you see that you can select them. If a line is missing completely from one file, imediff2 dis-
       plays it as a reversed '?'. While it seems to take one line in the editing phase, it is naturally not saved into the output file.

       To see a list of keyboard commands, hit h or ? in the editor.

       The program exits with status 0 if the changes were saved, 1 if the merging was aborted and 2 if the parameters were invalid.

OPTIONS

       -o outputfile, --output=outputfile
	      Write output to given file. If missing, changes will not be saved.

       -N, --new-file
	      Treat absent files as empty.

       -m, --mono
	      Force monochrome display.

       -u, --unresolved
	      Enable 'unresolved' mode (see above).

       -a     Start with version A (default).

       -b     Start with version B.

       -c     Start with unresolved changes (implies -u).

       -h, --help
	      Show summary of options and exit.

       -V, --version
	      Show version and exit.

KEYBOARD COMMANDS

       The following keyboard commands are available in the editor.

       h, ?   Show commands.

       up, down, left, right
	      Move in document.

       page up, page down
	      Move a screenfull.

       enter  Toggle selected change.

       n, tab, space
	      Jump to next change.

       p      Jump to previous change.

       a      Set current chunk to version A.

       b      Set current chunk to version B.

       u      Set current chunk to unresolved.

       shift+a
	      Set all changes to version A.

       shift+b
	      Set all changes to version B.

       shift+u
	      Set all changes to unresolved.

       e      Launch external editor.

       r      Discard editor-made changes. (Available only after e.)

       x, s   Save and exit.

       q, ctrl+c
	      Exit without saving.

       home, end
	      Jump to start or end.

SEE ALSO

       sdiff (1), diff (1), merge (1), diff3 (1).

COPYRIGHT

       This manual page as well as the program itself was written by Jarno Elonen (<elonen@iki.fi>). Unlike the program itself, which is  licensed
       under  the GNU General Public License (GPL) version 2 (or any later version, at your option), this document has been placed into the Public
       Domain.

AUTHOR

       Jarno Elonen.

								    2006-03-10							       IMEDIFF2(1)