Skip to content

Commit

Permalink
docs: describe force mode
Browse files Browse the repository at this point in the history
  • Loading branch information
MilesCranmer committed Jan 14, 2025
1 parent 3b9a840 commit b9718ce
Showing 1 changed file with 13 additions and 0 deletions.
13 changes: 13 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,7 @@ Options:
-s, --seance Prints files that were deleted in the current directory
-u, --unbury Restore the specified files or the last file if none are specified
-i, --inspect Print some info about TARGET before burying
-f, --force Non-interactive mode
-h, --help Print help
-V, --version Print version
Expand Down Expand Up @@ -232,6 +233,18 @@ If you want to put the graveyard somewhere else (like `~/.local/share/Trash`), y

This can be a good idea because if the graveyard is mounted on an in-memory file system (as `/tmp` is in Arch Linux), deleting large files can quickly fill up your RAM. It's also much slower to move files across file systems, although the delay should be minimal with an SSD.

**Force mode.**

The `-f --force` flag enables non-interactive mode, which skips most prompts and uses default actions:

- Big files are copied to the graveyard without prompting
- Files already in the graveyard are permanently deleted without prompting
- Special files (like sockets) will error
- Cannot be used with `-i --inspect` flag

This is useful for scripting or when you want to delete a lot of files without repeatedly answering prompts.


**Miscellaneous.**

In general, a deletion followed by a `--unbury` should be idempotent.
Expand Down

0 comments on commit b9718ce

Please sign in to comment.