celediel/gt
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases 2 Wiki Activity

update readme and manpage

Browse source
This commit is contained in:
Lilian Jónsdóttir 2024-07-30 20:06:52 -07:00
parent b2854a5b98
commit be41eadb43
3 changed files with 25 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
README.md
View file

@ -1,19 +1,29 @@
# gt # gt
g(o)t(rash) or something like that
small cli for xdg trash specification g(o)t(rash) is a simple, command line program to interface with the XDG Trash. Files in the trash may be listed, cleaned, or restored via an interactive table, and filtered with various flags.
## commands ## Interactive Mode
Run with no args to start interactive mode. In interactive mode, files in the trash are displayed, and may be selected to either restore or remove permanently.
## rm-like Trashing
Run with no command and only filename(s) as argument(s) to skip displaying files, sending them straight to the trash, in a quick, rm-like way.
## Commands
Files are displayed in an interactive table, allowing them to be sorted, filtered, and selectively operated on.
### trash / tr ### trash / tr
moves files to trash Find files on the filesystem based on the filter flags and any filename args.
### list / ls ### list / ls
list files in trash Find files in the trash based on the filter flags and any filename args.
### restore / re ### restore / re
restore files from trash Find files in the trash based on the filter flags and any filename args.
### clean / cl ### clean / cl
clean files out of trash Find files in the trash based on the filter flags and any filename args.
See gt(1) or `gt --help` for more in depth information on all command line flags.

8
gt.1
View file

@ -56,7 +56,7 @@ trash [command options] [filename(s)]
.RE .RE
\fIinfo\fR: \fIinfo\fR:
.RS 4 .RS 4
The trash command finds files on the filesystem based on the filter flags and any filename args, and displays them in a sortable and filterable table, allowing them to be selectively trashed.\& The trash command finds files on the filesystem based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered, and selectively trashed.\&
.PP .PP
.RE .RE
\fIflags\fR: \fIflags\fR:
@ -90,7 +90,7 @@ list [command options] [filename(s)]
.RE .RE
\fIinfo\fR: \fIinfo\fR:
.RS 4 .RS 4
The trash command finds files in the trash based on the filter flags and any filename args, and displays them in a sortable and filterable table.\& The list command finds files in the trash based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered.\&
.PP .PP
.RE .RE
\fIflags:\fR \fIflags:\fR
@ -119,7 +119,7 @@ restore [command options] [filename(s)]
.RE .RE
\fIinfo\fR: \fIinfo\fR:
.RS 4 .RS 4
The trash command finds files in the trash based on the filter flags and any filename args, and displays them in a sortable and filterable table, allowing them to be selectively restored.\& The restore command finds files in the trash based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered, and selectively restored.\&
.PP .PP
.RE .RE
\fIflags:\fR \fIflags:\fR
@ -148,7 +148,7 @@ clean [command options] [filename(s)]
.RE .RE
\fIinfo\fR: \fIinfo\fR:
.RS 4 .RS 4
The trash command finds files in the trash based on the filter flags and any filename args, and displays them in a sortable and filterable table, allowing them to be selectively removed permanently.\& The clean command finds files in the trash based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered, and selectively removed permanently.\&
.PP .PP
.RE .RE
\fIflags:\fR \fIflags:\fR

8
gt.1.scd
View file

@ -44,7 +44,7 @@ _usage_:
trash [command options] [filename(s)] trash [command options] [filename(s)]
_info_: _info_:
The trash command finds files on the filesystem based on the filter flags and any filename args, and displays them in a sortable and filterable table, allowing them to be selectively trashed. The trash command finds files on the filesystem based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered, and selectively trashed.
_flags_: _flags_:
*--recursive*, *-r* *--recursive*, *-r*
@ -64,7 +64,7 @@ _usage_:
list [command options] [filename(s)] list [command options] [filename(s)]
_info_: _info_:
The trash command finds files in the trash based on the filter flags and any filename args, and displays them in a sortable and filterable table. The list command finds files in the trash based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered.
_flags:_ _flags:_
*--non-interactive*, *-n* *--non-interactive*, *-n*
@ -81,7 +81,7 @@ _usage_:
restore [command options] [filename(s)] restore [command options] [filename(s)]
_info_: _info_:
The trash command finds files in the trash based on the filter flags and any filename args, and displays them in a sortable and filterable table, allowing them to be selectively restored. The restore command finds files in the trash based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered, and selectively restored.
_flags:_ _flags:_
*--all*, *-a* *--all*, *-a*
@ -98,7 +98,7 @@ _usage_:
clean [command options] [filename(s)] clean [command options] [filename(s)]
_info_: _info_:
The trash command finds files in the trash based on the filter flags and any filename args, and displays them in a sortable and filterable table, allowing them to be selectively removed permanently. The clean command finds files in the trash based on the filter flags and any filename args, and displays them in an interactive table, allowing them to be sorted, filtered, and selectively removed permanently.
_flags:_ _flags:_
*--all*, *-a* *--all*, *-a*