Added manpage

trash.1

@@ -0,0 +1,86 @@
+.\" Manpage for trash.
+.\" Contact bruce@bruce-hill.com to correct errors or typos.
+.TH man 8 "6 April 2020" "1.0" "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.
+
+.B 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)