Join files with DirectoryOpus 4.x
                 ---------------------------------

                            DopJoin
                            =======

                     Version 1.03 - 21.03.01

                         © H. van der Ree

                         hivdree@uwnet.nl


DopJoin is a small program with which you can join files with
DirectoryOpus 4.xx.

DopJoin is copyright 2001 by H. van der Ree and EMailware. That
means if you like it and use it, you must send me an email. I
would really like to hear about how you've used the program.

DopJoin is free to use and copy as you see fit. The Author retains
all rights to the program. The Author is not responsible for any
damage the programs may cause. If you distribute the archive, you
MUST distribute the entire package.

This program may be included in any archive collection. 

=====================================================================

DESCRIPTION:

Not much to say really: this little program joins all the selected
files in the source lister to a new file in the destination lister.
DopJoin only works on files, selected dirs will be ignored but will
be deselected.

DopJoin will ask for a filename and will add the path of the
destination. If a filename is given WITH a full path the path will
be stripped!

New for version 1.03 is the option APPEND. When used the selected
files will be added to the destination file. If the file doesn't
exists it will be created. Without this option an existing file
in the destination with the same name will be overwriten!

Also new for this version is the option KEEP. This will keep the
temporary file in T: in which the files are listed that were joined.
The first line of this file is the name of the destination file.

Errors, if any, will be saved to file RAM:DopJoinErrors. They are
listed with date and time, IoErr() and what caused the error.

=====================================================================

REQUIREMENTS:

DirectoryOpus 4.11 or 4.15b or newer. Version 4.12 up to 4.15a would
trash memory if the result from arexx was bigger then 256 chars.

ARexx must be running. DopJoin uses ARexx to communicate with
DirectoryOpus.

DopJoin has been tested only with FFS and OS2.1 up to OS3.1.

=====================================================================

INSTALLATION:

Install DopJoin as an AmigaDOS program with one argument: {p}. The
only flag that MUST be set is 'Run asynchronously'!
Optionally you can add the options KEEP and/or APPEND.

An other way is to 'run <>NIL: DopJoin {p} [KEEP] [APPEND]'.

If DopJoin isn't running asynchronous Dopus will be locked!

=====================================================================

HISTORY:

  1.01 - 16.03.01  First public version.
  1.02 - 16.03.01  Internal version.
  1.03 - 21.03.01  Added two options; KEEP/S and APPEND/S.
                   KEEP:   don't delete the temporary file in T: in
                           which the files are listed that were
                           joined. The first line of this file is
                           the name of the destination file.
                   APPEND: add the selected files to an already
                           existing file. If this file doesn't
                           exists it will be created.
                   Fixed returncode, was always 20.
                   Added full errorchecking to read/write actions.
                   If a read causes an error, the file read will be
                   skipped. If a write causes an error the whole
                   process will be stopped.
                   Errors are saved to file RAM:DopJoinErrors.

=====================================================================

DISCLAIMER:

  THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
  ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
  RESULTING FROM THE USE OF THE PROGRAM. THE ENTIRE RISK AS TO THE
  USE OF THIS PROGRAM IS ASSUMED BY THE USER.

=====================================================================