The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

VERSION

This document describes version 0.12 of trash-u (from Perl distribution File-Trash-Undoable), released on 2014-08-24.

SYNOPSIS

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

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

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

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

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

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

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

 # show history
 % trash-u --history

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

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

 # display help for more options
 % trash-u --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

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

  • trash-u 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

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/File-Trash-Undoable.

SOURCE

Source repository is at https://github.com/sharyanto/perl-File-Trash-Undoable.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=File-Trash-Undoable

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 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.