NAME

u-trash - Trash files, with undo/redo capability

VERSION

version 0.02

SYNOPSIS

# trash some files, but in simulation mode, not really trashing the files
% VERBOSE=1 u-trash --dry-run *.bak

# trash some files, for real
% u-trash *.bak

# list trash contents
% u-trash --list-contents

# trash some more files
% u-trash * .tmp

# ups made a mistake; no worry, let's undo; now previous trashing is reversed
% u-trash --undo

# undo again; now the *.bak files are also restored
% u-trash --undo

# redo; now the *.bak files are trashed again
% u-trash --redo

# show history
% u-trash --history

# forget history; past actions can no longer be undone/redone
% u-trash --clear-history

# empty trash; this action is not undoable (the point is to reclaim space)
% u-trash --empty

# display help for more options
% u-trash --help

DESCRIPTION

This command-line program is an interface to File::Trash::Undoable, which in turn uses File::Trash::FreeDesktop.

Features: undo/redo, dry run mode, per-filesystem trash dir.

This program is relatively new and have not yet been tested extensively. Use with caution.

USING AS rm REPLACEMENT

u-trash can be used as rm replacement (a.k.a. alias) with some caveats:

  • u-trash deletes directories by default

    That is, it behaves as if -R rm option is in effect.

  • Some rm options exist but do not have any effect (noop)

  • Some rm options are still missing/unknown

    This include: -i/-I/--interactive, --one-file-system, --no-preserve-root.

SEE ALSO

File::Trash::Undoable

File::Trash::FreeDesktop

trash-cli

gvfs-trash

rmv

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.