/ 
File-Trash-Undoable-0.12
River stage two • 13 direct dependents • 14 total dependents
/ trash-u

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.