***************************************************************

                       * DirSend.DOPUS *
                       >> Version 1.0 <<

                    ·Written by: DoMiNaToR·

***************************************************************


                         INTRODUCTION
                         ------------

Well, firstly the ".DOPUS" extension  of  the filename is self-
explanatory of what the program  is  to be connected with. Yes,
this is an ARexx program is for Directory Opus.
The other day, I was  sitting  there,  tidying up my hard drive
when suddenly I thought "Oh, Sod It!". I had a directory window
displayed on Workbench  that  was  about  9 (!) sub-directories
into the partition and I needed to  use DOpus to move the files
somewhere else for me. So, I had  to load DOpus, go through all
the directories to get where I  wanted.  This is too much for a
lazy git like me...
So, I decided to  write  an  ARexx  program  that  would send a
directory/file to DOpus and list  it  in  one it's windows. The
program was designed to  work  most  effectively with a utility
called 'ToolsDaemon' (or a similar one  that lets you add extra
menus/items to your Workbench screen). It  can be used from the
CLI, but I will leave you to figure that out for yourself...


                 INSTALLATION & REQUIREMENTS
                 ---------------------------


1. Copy the file 'DirSend.DOPUS' to your REXX: directory.

2. 'ToolsDaemon' (or a similar program) to be always running.

3. 'Directory Opus' to be running.

4. 'RexxMast' to be activated. (Just drag it into WBStartup)

5. The following libraries in your LIBS: directory...

        RexxSysLib.library    (Supplied with ARexx)
        RexxSupport.library   (Supplied with ARexx)
        ReqTools.library      (Copyright © Nico François)
        RexxReqTools.library  (Copyright © Rafael D'Halleweyn)

        [ I have NOT included ANY of these libraries with this
        program because I do not want any trouble whatsoever
        with copyright laws :-( ]

NOTE: I haven't had the bad luck of using KS1.3 for years. I
      do NOT want to upset anyone by saying this, but I
      can't be bothered to test my programs on these machines
      any more. Anyway, you SHOULD be using KS2.0 or higher!.
      Besides, 1.3's don't have ARexx as a standard!.
      You don't know what you are missing....


                             USAGE
                             -----

Before I explain how to use this program, this is how you would
add it to a ToolsDaemon menu...

1. Load up 'ToolsPrefs'.

2. Enter a new menu  item  called  something along the lines of
'Send Dir/File to DOpus'.

3. To improve the usefulness,  I  suggest  making the item have
the key of 'D' as a shortcut.

4. Enter a new command for this item as...
                'SYS:Rexxc/RX REXX:DirSend.DOPUS []'
                        and set the WB/CLI cycle gadget to 'CLI'.

5. Save the preferences.


Now, ensure that DOpus is running, ensure that you have met all
the requirements mentioned above and  ensure  that you have set
up ToolsDaemon correctly.

OK, now to start off with,  shove  a  disk in DF0: and when its
icon appears, click it ONCE. Now if  you have set up the key'D'
as a shortcut  on  ToolsDaemon  (as  suggested  earlier), press
'Right-Amiga' and  'D'  simultaneously (if you haven't, just go
to the menu and select 'Send Dir/File to DOpus' or whatever you
called it). If you have done  it right, a requester will appear
on Workbench asking you what window to list the directory in on
DOpus. You can either click the  buttons or press 'L' for Left,
'R' for Right or 'C' for Cancel (Or RETURN for Left and ESC for
Cancel). If you selected  Left  or  Right,  DOpus's screen will
pop to the front and list  the contents of DF0:, finishing with
the  message..  Received  directory  "DF0:".  If  you  selected
Cancel, errrrrm, it would not do anything apart from quit.
This operation will work  on  directories  as  well as devices.
Open your partition with Workbench in  it and click once on the
System directory. Do the same  as  above.  DOpus will then list
the contents  of  the  System  directory  and  finish  with the
message... Received directory  "System3.0:System/"  or whatever
you have your partition called.
Also, this operation will work  on  files (Errr ?). Yes, files.
If you have shut down  your  System  directory, open it again!.
Click on, errrrm, say 'Clock'. Do the same as above. DOpus will
then list the contents of  the  System directory and select the
Clock program and its icon for  you  (and scroll down to them).
It will then  finish  with  the  message...  Received directory
"System3.0:System/" or whatever you have your partition called.
If the selected file has  no  icon  then  just the file will be
selected.


                        QUICK SENTENCE
                        --------------

     I hope you will find this program as useful as I did!


                            CREDITS
                            -------

             Idea and all programming by DoMiNaToR

             ARexx is Copyright © William S. Hawes
         ReqTools.library is Copyright © Nico François
   RexxReqTools(.library) is Copyright © Rafeal D'Halleweyn
           ToolsDaemon is Copyright © Nico François
        Directory Opus is Copyright ® Jonathan Potter

This program is FREELY distributable  AS  LONG AS the following
      files are included on the disk or in the archive...

                     - 'DirSend.DOPUS'
                     - 'DirSend.DOPUS.doc'

Commercial usage IS allowed [  :-)  ]  as  long as the original
author's credit (ME!) is  stated  somewhere  easily seen in the
product and the above files are included.]
REMEMBER: I mean my program, NOT the libraries by other people.
          (Unless, you are given permission by these people)


                           COMMENTS
                           --------

Considering I haven't included the 'ReqTools.library' and
'RexxReqTools.library' files with  this  program,  they  can be
used from other programs. Here are some suggestions....


                     - ReqTools.library -

Because this script  is based around  ToolsDaemon, you  should
have this library  already in your LIBS: directory  because it
uses this library and it is written  by the person who made it.
If you  are using  something  other than ToolsDaemon,  such as
Shortcut, this library is available  from  a lot  of  programs
that were written by the author of the library, Nico François.


                   - RexxReqTools.library -

This is  available  straight  from  the  original  RexxReqTools
package by Rafael D'Halleweyn. If you are interested or already
programming  in  ARexx,   this   extra   functions  library  is
invaluable for creating interfaces or even simple requesters.

I myself, must thank Nico  François for producing the excellent
ReqTools interface  and  more  still,  Rafael  D'Halleweyn  for
bringing this excellent interface into ARexx.


                        LAST THINGS LAST
                        ----------------

                        > Quick Advert <

           Have you heard my two great MED modules that
                  have been uploaded around.....

              SWAMP-THING REMIX (named SWMPTHNG.LHA)
               POINT OF NO RETURN  (named PONR.LHA)

               Everyone I have played them to, made
         good comments. So don't just take my word for it!

                       Download them ASAP!
            [ If you have a modem, I don't sadly :-( ]

               Thanks for using this program. Bye..

                        ***DoMiNaToR***


END OF FILE.
