Skip to main content.

Getting Started with gdiff-ext

Sergey Zorin


1. About gdiff-ext

1.1. What gdiff-ext is

gdiff-ext is context menu extension for Gnome's Nautilus file manager. gdiff-ext extends Nautilus context menu with commands to compare or merge selected file(s) and to remember selected file for the future compare or merge operations.

1.2. What gdiff-ext is not

gdiff-ext is not a file comparison or merge tool. You will have to tell gdiff-ext what tool to use for file comparison or merge operaitions.

2. Compilation and Installation of gdiff-ext

2.1. Getting gdiff-ext

gdiff-ext is distributed in source code form and freely available from diff-ext website. You can download the latest source-code release in .gz or .bz2 package.

You can also get the latest gdiff-ext source code from the Subversion repository at http://diff-ext.svn.sourceforge.net/viewvc/diff-ext/trunk/gdiff-ext/.

2.2. Installing gdiff-ext

  1. cd to the directory containing the package's source code and type ./configure to configure gdiff-ext for your system. If you're using csh on an old version of System V, you might need to type sh ./configure instead to prevent csh from trying to execute configure itself.

    Running configure takes awhile. While running, it prints some messages telling which features it is checking for.

  2. Type make to compile the package.

  3. Type make install to install the programs and any data files and documentation.

    Note

    You may need to do this step as root user.

  4. Restart Nautilus to make it aware of new extension.

3. Configuring gdiff-ext

Use gdiffextsetup to configure gdiff-ext. You can start gdiffextsetup from the terminal command line or from System->Preferences->More Preferences->gdiff-ext configuration

Figure 1. gdiff-ext configuration program

gdiff-ext configuration program

Here you can specify program to use for 2 and 3-way file comparison. You can also enable/disable 3-way file comparison.

4. Commands

gdiff-ext adds new commands to the Nautilus context menu. Number of commands depends on the number of selected and remembered [*] files. The following table summarizes context menu commands availability.

Table 1. gdiff-ext context menu commands

# of files selected commands
3-way compare enabled 3-way compare disabled
1

Compare later

Compare to '<file>' [a]

Compare later

Compare to '<file>' [a]

2

Compare

3-way compare to ' <file>' [a]

Compare

3

3-way compare

 

[a] Available only if list of rememberd files is not empty


4.1. Compare later

You can ask gdiff-ext to remember selected file(s) [*] with Compare later command. Selected file(s) [*] will be placed into rememberd files list and will be available for future comparison oprations.

4.2. Compare, 3-way compare

Compare, 3-way compare commads invoke configured file comparison 3-way comparison command respectevely. Selected files are passed to the command as arguments.

4.3. Compare to '<file>', 3-way compare to '<file>'

Compare to ' <file>', 3-way compare to ' <file>' commads invoke configured file comparison 3-way comparison command respectevely. Selected file(s) and remembered file are passed to the command as arguments.

5. Using gdiff-ext

Here are some gdiff-ext usage examples.

5.1. Comparing files from the same folder

To compare files located in the same folder:

  1. select 2 files you want to compare in Nautilus window

  2. bring up context menu by clicking right mouse button

  3. select Compare command from the context menu

    Figure 2. comparing files from the same folder

    comparing files from the same folder

gdiff-ext will launch file comparison tool you configured with gdiffextsetup program.

5.2. 3-way file comparison

To perform 3-way file comparison of files in the same folder:

  1. select 3 files you want to compare in Nautilus window

  2. bring up context menu by clicking right mouse button

  3. select 3-way compare command from the context menu

    Figure 3. 3-way comparison of files from the same folder

    3-way comparison of files from the same folder

gdiff-ext will launch 3-way file comparison tool you configured with gdiffextsetup program.

5.3. Comparing files from different folders

With gdiff-ext you can also compare files from different folders. To do so:

  1. select first file you want to compare in Nautilus window

  2. bring up context menu by clicking right mouse button

  3. select Compare later command from the context menu

    Figure 4. making a file available for later comparison

    making a file available for later comparison

  4. navigate to the folder containing the second file

  5. bring up context menu by clicking right mouse button

  6. select Compare to '<file>' command from the context menu

    Figure 5. comparing files from different folders

    comparing files from different folders

5.4. 3-way comparison of files from different folders

With gdiff-ext you can also compare files from different folders. To do so:

  1. select first file you want to compare in Nautilus window

  2. bring up context menu by clicking right mouse button

  3. select Compare later command from the context menu

    Figure 6. making a file available for later comparison

    making a file available for later comparison

  4. navigate to the folder containing the second file

  5. select 2 files you want to participate in 3-way compare in Nautilus window

  6. bring up context menu by clicking right mouse button

  7. select 3-way compare to '<file>' command from the context menu

    Figure 7. comparing files from different folders

    comparing files from different folders



[*] Currently gdiff-ext allows to remember only one file.

Copyright © 2006-2009 Sergey Zorin