BRIEF DESCRIPTION AND INSTRUCTIONS:

This ARexx module adds "Cut" (move), "Copy" and "Paste" commands (similar to
Win95) to file and lister pop-up menus in DOpus Magellan 5.66/5.8x and has many
additional features as well.  You can also use the commands with DOpus 5.5 or
earlier versions of Magellan I by assigning them to lister toolbar buttons;
full instructions are provided.

You can operate on one file or directory by selecting "Cut" or "Copy" from its
own pop-up menu, or on any number of files and/or directories by selecting
them in name mode and then selecting "Cut" or "Copy" from the lister pop-up
menu.  (At this stage, NO changes are made to your disk - the names are simply
copied to the Cut'n'Paste clipboard, a file in T:.)

When "Paste" on lister pop-up menus (or "Paste Into" on directory and disk
pop-up menus) is selected, the clipped files/dirs are copied or moved to that
new location using built-in DOpus commands.  You will be prompted in the
normal way if anything might be overwritten.  There is NO danger of Cut'n'Paste
DELETING any of your data as it only uses internal commands; of course it is up
to you to make sure you know where you're moving data to and if you're
overwriting anything!

Files/dirs can be renamed as they are pasted by using the "Paste As..." or
"Paste Into As..." commands instead.

You can view the currently clipped files/dirs by selecting "View/Alter
Clipboard Contents..." in any lister pop-up menu.  You can also toggle the
cut/copy status of the clipboard from there.  The clipboard will be cleared
after attempting to paste "cut" files/dirs or after selecting "Clear Clipboard
Contents".

Once there is something in the clipboard you can add more items by selecting
"Add To Clipboard".  Cut'n'Paste can optionally check whether the new item is
already in the clipboard.

You can paste links to the files or directories in the clipboard by using the
"Paste As Links" or "Paste Into As Links" commands (only on the same disk or
partition).  If you never intend to use links (I don't recommend using them),
you can set an option to hide these commands.

You can paste the files or directories in the clipboard into LZX, LhA and ZIP
archives by right-clicking on an archive and selecting "Paste Into Archive".
You will need to have filetypes set up for the archive types you wish to use
and configure Cut'n'Paste to recognise them.  The originals will not be
deleted, regardless of whether they were "cut" or "copied".

Please note that in icon (action) mode you can ONLY use the "Copy", "Cut" and
"Add" commands on the file/dir pop-up menus, i.e. you can't drag a box around
some icons and select "Copy" from the lister pop-up menu.  To achieve this,
instead right-click on one of the icons and select "Copy".  Then right-click
on each of the other icons in turn and select "Add".  The icons associated
with the files or directories will also be clipped, depending on the settings.

If you use Magellan II, the add, paste, view and clear clipboard commands are
hidden from the pop-up menus when the clipboard is empty.

I have also included suitable button images to add the Cut'n'Paste commands to
your listers' toolbar as well as instructions on how to do this.

Tested mainly with Magellan II but should work fine with 5.5+ and Magellan I,
but note the first paragraph.

Now go and have a play with it or read the usage section for further, more
detailed instructions and a tutorial.  You should also read the configuration
section to alter various aspects of Cut'n'Paste's behaviour.