gDirCmp v0.8


Description
===========
gDirCmp is a simple utility that compares two directories, displays the 
differences, and allows you to select items to copy.  This version of gDirCmp 
features support for multiple Src-Dst directories.


Installation
============
The configure script has been omitted from this package due to its size 
and the fact that it doesn't work on all systems.  Instead, you run an 
autogen script which creates the configure script.  If you need to pass 
any arguments to the configure script, you can do so on the autogen.sh 
command line.  Other than that, installation is pretty much the same as 
usual:

  tar zxvf gdircmp-0.8.tar.gz
  cd gdircmp-0.8
  sh autogen.sh
  make
  make install


Using The Anjuta Project File
=============================
This package includes an Anjuta 1.2.2 project file.  Because of the missing 
configure script, "Build|Build" won't work initially; you'll need to select 
"Build|Auto generate..." first.


Using gDirCmp
=============
When you start this program for the first time, the entry fields ("Src" and 
"Dst") and the listbox ("Directories To Compare") will initially be empty.  The 
first thing you'll need to do is add one or more Src-Dst pairs to the list:

1. Use the [Browse] buttons to select the Src (source) and Dst (destination) 
directories.
2. Use the checkboxes to set the desired properties.  Note: unlike in previous 
versions of gDirCmp (where the options were global), these properties are 
specific to a Src-Dst pair (i.e., each Src-Dst pair has its own set of 
properties).
3. Press the [Add Src-Dst To List] button.
4. If you want to add more Src-Dst pairs, just repeat the above steps.

At this stage, there should be one or more items in the list of directories to 
compare.  You now have the following choices:

- If you want to temporarily exclude a Src-Dst pair from a report: select that 
item and then unset the "Include Src-Dst" checkbox in the "Properties" section.
- If you want to permanently remove a Src-Dst pair from the list: select that 
item and then press the [Remove From List] button.
- If you want to change any options for a Src-Dst pair: select that item and 
then set or unset the checkboxes in the "Properties" section.
- If you're satisfied with the list of directories and you want to continue to 
the next step: press the [Report] button.

Note: Depending on the number of Src-Dst pairs and the contents of the 
directories, the report process may take quite a bit of time.  While in 
progress, the main window won't be updated and the program may seem to be 
crashed.  Just be patient.

Once gDirCmp finishes comparing all of the directories, you'll be presented 
with a list of all differences.  The first column of this list shows which 
Src-Dst pair the item belongs to (see the "Legend" textbox for specifics).  In 
the second column, [D] indicates that the item is a directory; [f] indicates a 
file.  At this stage, you can select any or all items to copy.  Note: to cancel 
this mode, press the [Back] button.

Once you've selected all of the items that you want to copy, press the [Copy] 
button.  After doing so, you'll be prompted to either confirm or cancel the 
operation.  Pressing [OK] will start the copy process.  Note: as with the 
report process, this process may also take quite some time.


Notes - Directories Mode
========================
The [Switch Src-Dst] button reverses the Src and Dst entry fields (i.e., Src 
becomes Dst, and Dst becomes Src).

The "I" column of the list shows whether the Src-Dst pair will be included (+) 
or excluded (-) in the report process.

The "N" column of the list is just an internal index to the Src-Dst pair. 

The "Properties" column can be interpreted as follows: the first digit 
corresponds to the first Properties checkbox, the second corresponds to the 
second checkbox, and so on.  A '1' means the property is set, '0' means it's 
not.

If there's an item selected in the list, setting or unsetting properties will 
affect the selected Src-Dst pair.  Therefore, if you want to set properties for 
a new Src-Dst pair, make sure that there's no selected item in the list.

If the [Add Src-Dst To List] button is enabled, it means that the pair is not 
currently in the Directories list.  If you press the [Report] button at this 
point, the Src-Dst pair will automatically be added.  If you don't want this, 
select an item in the listbox to disable the [Add] button.


Notes - Files Mode
==================
The "Legend" textbox shows which Src-Dst pair a file belongs to.  Only those 
Src-Dst pairs that have the "Include In Report" property set will be listed 
here.

To cancel Files Mode, press the [Back] button.


Notes - Miscellaneous
=====================
When you press the [Exit] button, the current settings and the list of Src-Dst 
pairs are written to gDirCmp's configuration file (~/.gdircmp.cfg).  If you 
don't want to save the current configuration, use Alt-F4 (or the window's 
standard Close button) instead.


Bug Reports
===========
Although some effort has been made to make this program as robust as possible, 
there may be bugs that I don't yet know about.  If you find any bugs, please 
let me know.  For information on how to contact me, see the README file on my 
website.