---------------------------------------------------------------------------

        Intersect Two Window Panes in DirectoryOpus 4.x

---------------------------------------------------------------------------

-----------------------
>> ChangeLog
-----------------------

04 July 2015 - DOpus4-Intersect v1.4

  * Normalize strings to upper and fix scrolling on deselect.

27 June 2015 - DOpus4-Intersect v1.3

  * Cleanups and fixes.
  
25 June 2015 - DOpus4-Intersect v1.2

  * Removed the port check since it was causing problems.
  * Removed the binary search ARexx routing ( it is still available at:
http://grimore.org/fuss/amiga/arexx#binary_search ) in favour of ARexx
faster Find function.
  * Added support for file-names with spaces in them.
  * You now have to select files in both panes in order to intersect.


-----------------------
>> About
-----------------------

This script can be added to DirectoryOpus 4 either as a button or a hotkey
and will deselect all the items that can be found in both the current
window pane and the other window pane.

Although simple enough, DirectoryOpus 4 only has the ability to "Select"
and "Toggle" contents but none of those functions work relatively to the
other window pane. This script adds the ability to deselect all the current
selected items in the current window that cannot be found in the other
window.

This lets you perform some neat operations: for example, when updating
files, you frequently just need to update the already existing files
without copying over files that are not there. In such cases, you could
select common files individually and copy them over, or you could let this
script do it for you.

The script is pure ARexx and Dopus - it would have been much faster if it
had a shell-command that could perform some of the operations that it's
doing but the idea was to create a pure ARexx script with no external
dependencies. This included implementing a lot of auxiliary functions.

-----------------------
>> How to install
-----------------------

  1.) Extract the archive
  2.) Place DOpus4-Intersect.rexx wherever you see fit. (It is tidy, for
      example, to create an ARexx directory in DOPUS4: and then place your
      scripts there.)
  3.) Open DirectoryOpus4 and right-click and go to  Project->Configure
  4.) On the screen that pops-up, go to Buttons and create a new button
      somewhere where you see fit.
      4a.) Give the button a name ("Intersect", for example) and create a
           new entry.
      4b.) Set the cycler to ARexx and click the magnifying glass to enter
           the path to the DOpus4-Intersect.rexx script.
  5.) You do not need to set any flags.
  6.) Save and exit and you are done.


-----------------------
>> How to use
-----------------------

In DirectoryOpus 4, open up two directories in the two window panes, select
some files in one window, select some files in the other window and hit the
"Intersect" button that you just created. All operations will be mentioned
in the DirectoryOpus 4 top text.

When the intersect process is done you should have only the files selected
that are common to both window panes.

-----------------------
>> Caveats
----------------------

  * If your files contain either the asterisk (*) character or the
forward-slash character (/), which are reserved AmigaDOS characters, the
script will fail.

-----------------------
>> Project Website
-----------------------

http://grimore.org/amiga/directoryopus/4/intersect

-----------------------
>> Feedback
-----------------------

You can reach us at:

   Wizardry and Steamworks
   e-mail: office@grimore.org

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                  605    1233  49.1% -lh5- fbfb Jul  4 23:48 DOpus4-Intersect14.info
[unknown]                 1612    3908  41.2% -lh5- 7210 Jul  4 23:47 DOpus4-Intersect14/DOpus4-Intersect.readme
[unknown]                  455     886  51.4% -lh5- c149 Jul  4 23:48 DOpus4-Intersect14/DOpus4-Intersect.readme.info
[unknown]                 1793    6287  28.5% -lh5- 34a9 Jul  4 23:44 DOpus4-Intersect14/DOpus4-Intersect.rexx
[unknown]                  587     859  68.3% -lh5- 00e5 Jul  4 23:48 DOpus4-Intersect14/DOpus4-Intersect.rexx.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         5 files    5052   13173  38.4%            Jul  4 19:59