# README -- description of `trash' package
# created 25-Jan-1995 jmk
# autodate: 25-Jan-1995
# autotime: 02:42

DESCRIPTION

`trash' provides a simple trashcan facility for the shell command
line.  `trash' ``deletes'' files by moving them to a ``trashcan''
directory, which defaults to `$HOME/.trash'.  `trash' can manage a
user's trashcan with `--view' and `--empty' commands.


INSTALLATION

You can install `trash' as an executable shell script with the
supplied Makefile; just edit to set directories, &c. as appropriate
for your system, become the superuser, and do

        make install
	make install.man

that's all there is to it!


COMMENTS

It is recommended to alias trash to the command normally used for
deleting files, and to realias that command to a different (and harder
to type) one, e.g. (using bash):

       alias rm="trash"
       alias remove="/bin/rm"

Used this way, trash allows the user to easily un-delete a file that
might have been inadvertently deleted (for example, when mistyping
`rm *~' as `rm *'.


LIMITATIONS

--Does not work well for directories or symbolic links on a different
  filesystem from the trashcan directory.

--Does not provide a facility to prompt the user when emptying the
  trash (coming soon?).

--Cannot trash files recursively (like `rm -r').


COPYRIGHT

`trash' is written and maintained by Jim Knoble
<jmknoble@mercury.interpath.net>.  `trash' is copyright 1995 by Jim
Knoble; you may freely distribute and modify it, but the original code
must bear my name.  Any modifications that you introduce must bear
your name and must not bear mine.

