.\" Manpage for trash.
.\" Contact bruce@bruce-hill.com to correct errors or typos.
.TH man 8 "6 April 2020" "0.5" "trash manual page"
.SH NAME
trash \- A shell program for FreeDesktop.org-compliant trash management.
.SH SYNOPSIS
.B trash
[\fI-h\fR|\fI--help\fR]
[\fI-V\fR|\fI--version\fR]
[\fI-v\fR|\fI--verbose\fR]
[\fI-i\fR|\fI--interactive\fR]
[\fI-f\fR|\fI--force\fR]
[\fI-r\fR|\fI-R\fR|\fI--recursive\fR]
[\fI-u\fR|\fI--untrash\fR]
[\fI-e\fR|\fI--empty\fR]
[\fI-E\fR|\fI--empty-all\fR]
[\fI-l\fR|\fI--list\fR]
[[\fI--\fR] [\fIfiles...\fR]]

.SH DESCRIPTION
\fBtrash\fR is a small shell program that helps you send files to a trash
directory (specified by the FreeDesktop.org Trash Specification), restore
files from there, and empty the trash directory.
.SH OPTIONS
.B \-h
.B \--help
Print the command line usage and exit.

.B \-V
.B \--version
Print \fBtrash\fR's version and exit.

.B \-v
.B \--verbose
Print more logging output.

.B \-i
.B \--interactive
Always ask for confirmation.

.B \-f
.B \--force
Never ask for confirmation.

.B \-r
.B \-R
.B \--recursive
Ignored. (For compatibility with \fBrm -r\fR)

.B \-u
.B \--untrash
Bring up a fuzzy picker for restoring a file from the trash.

.B \-e
.B \--empty
Empty one or more files from the trash.

.B \-E
.B \--empty-all
Empty all files from the trash.

.B \-l
.B \--list
List all files in the trash. The format is: \fB<Trash File>\fR, \fB<Date
Deleted>\fR, \fB<Original Path>\fR. Fields are separated by the environment
variable \fIFS\fR (default: tab) and records are separated by the environment
variable \fIRS\fR (default: newline).

.I files...
The files to send to the trash.

.SH EXAMPLES
.TP
.B
trash foo.txt baz.txt
Send \fIfoo.txt\fR and \fIbaz.txt\fR to the trash.

.TP
.B
trash -u
Pick a file and untrash it.

.TP
.B
trash -E
Empty the trash.

.SH AUTHOR
Bruce Hill (bruce@bruce-hill.com)