INSTALLATION:

Use the installation script provided!!  Otherwise:

1. Ensure DOpus 5.5+ and RexxMast are running.  Ensure "Name Mode PopUp" is
   turned on in DOpus's "lister options".

2. For foreign translations only: copy the relevant catalog file from the
   archive into your own LOCALE:Catalogs/?????/ directory.
   If you do this after step 3 you will need to restart DOpus to make the
   translation work, so do it now!  Note that catalog files provided
   with earlier versions of Cut'n'Paste are incompatible with V3.4.

3. Copy CutNPaste.dopus5 into your DOpus5:Modules/ directory.  It will be
   automatically recognised by DOpus and the menu items added immediately
   (it's not necessary to restart DOpus).  Do not rename this file or
   leave any older versions in the DOpus5:Modules/ directory!

4. Copy CutNPaste.guide (and its icon) to your DOpus5:Help/ directory.

No other files are required (except maybe a few to cut and paste...).


USING CUT'n'PASTE THROUGH TOOLBAR ICONS: (optional for 5.66+ users)

You can also use Cut'n'Paste through the lister toolbar but you will need to
set this up yourself.  It's not too difficult - here's how to do it:

1. Copy the 5 supplied images into your DOpus5:images/ drawer or anywhere else
   you want to put them.  You may want to put them in a separate sub-directory
   e.g. DOpus5:images/CutNPaste/ so you can remove them if you don't like
   them!  They are in the MagicWB colour scheme and 24×16 pixels in size.

2. You will need to edit the functions in your lister toolbar.  Select "Edit
   Lister Toolbar..." from the "Listers" menu.

3. Edit the buttons in the normal way (refer to your DOpus manual).  In the
   function editor you will need to select "Command" (as all Cut'n'Paste
   commands are effectively "built-in").  The names of all the commands you
   can add are:
   · Clip-MCut     - will cut all selected items to the clipboard
   · Clip-MCopy    - will copy all selected items to the clipboard
   · Clip-MAdd     - add selected items to the clipboard
   · Clip-MPaste   - will paste previously cut/copied items into the lister
   · Clip-MPasteAs - same as Clip-Paste but allows you to rename the items
   · Clip-MPasteLinks - paste links to clipboard items on same disk/partition
   · Clip-View     - view contents of clipboard (you can paste from here too)
   · Clip-Clear    - clear clipboard
   · Clip-About    - information about Cut'n'Paste
   ONLY add ONE command to each function!  Do not add anything after the
   command (i.e. arguments).  Do not set any flags as Cut'n'Paste takes care of
   those.  These commands are available in the command list you can display
   from the function editor.

4. You don't need to assign buttons for all (or any!) of these commands.  They
   are all always available from the lister pop-up menus.  On my system I've
   assigned only these five commands to buttons in this way:
   · Clip-MCut     - middle button function on "move/moveas" button
   · Clip-MCopy    - middle button function on "copy/copyas" button
   · Clip-MPaste   - left mouse button function on new button
   · Clip-MPasteAs - right mouse button function on new button
   · Clip-View     - middle mouse button function on new button
   This is only because it fits with my existing buttons and I have a three-
   button mouse!  If you find the Cut'n'Paste method more useful than the
   built-in Copy and Move commands then you may want to assign Clip-MCut and
   Clip-MCopy to the left button functions! :)
   Note that I've only supplied images for these five functions anyway!

You can add the commands to the lister command menu (through "Edit Lister
Menu...") in the same way.  I can't see why you'd want to do this, however,
unless you're using DOpus 5.5 and the commands aren't added automatically to
the pop-up lister menu.

The Cut'n'Paste commands will not work properly with other types of button
banks - only add them to lister toolbars or the lister command menu!!