Chapter 2. File Comparison And Merge

   kdiff3 file1 file2

   kdiff3 file1 file2 -m
   kdiff3 file1 file2 -o outputfile

   kdiff3 file1 file2 file3

   kdiff3 file1 file2 file3 -m
   kdiff3 file1 file2 file3 -o outputfile

Note that file1 will be treated as base of file2 and file3.

If all files have the same name but are in different folders, you can reduce typework by specifying the filename only for the first file, e.g.:

   kdiff3 folder1/filename folder2 folder3

This is very similar, but now it's about folders.

   kdiff3 folder1 folder2
   kdiff3 folder1 folder2 -o destdir
   kdiff3 folder1 folder2 folder3
   kdiff3 folder1 folder2 folder3 -o destdir

For folder comparison and merge you can continue to read here.

To see all available command line options type

kdiff3 --help

Example output:

Options:
  -m, --merge               Merge the input.
  -b, --base file           Explicit base file. For compatibility with certain tools.
  -o, --output file         Output file. Implies -m. E.g.: -o newfile.txt
  --out file                Output file, again. (For compatibility with certain tools.)
  --noauto                  Ignore --auto and always show GUI.
  --auto                    No GUI if all conflicts are auto-solvable. (Needs -o file)
  --L1 alias1               Visible name replacement for input file 1 (base).
  --L2 alias2               Visible name replacement for input file 2.
  --L3 alias3               Visible name replacement for input file 3.
  -L, --fname alias         Alternative visible name replacement. Supply this once for every input.
  --cs string               Override a config setting. Use once for every setting. E.g.: --cs "AutoAdvance=1"
  --confighelp              Show list of config settings and current values.
  --config file             Use a different config file.

The option --cs allows you to adjust a configuration value that is otherwise only adjustable via the configure dialogs. But be aware that when KDiff3 then terminates the changed value will be stored along with the other settings. With --confighelp you can find out the names of the available items and current values.

Via --config you can specify a different config file. When you often use KDiff3 with completely different setups this allows you to easily switch between them.

Many people want to use KDiff3 with some version control system. But when that version control system calls KDiff3 using command line parameters that KDiff3 doesn't recognise, then KDiff3 terminates with an error. The Integration item in the settings dialog allow to specify command line parameters that should be ignored by KDiff3. They will appear in the usage help like in this example:

  --foo                     Ignored. (User defined.)

When this isn't enough, then it is recommended to write a shell script that does the option translation.