commit 2f8d3e8d9ea4abfff676248c840a8ae4cacd8fb3
parent 2a1f8fc0a57d31a5fe38015c88e64ffb690529cf
Author: emmett1 <me@emmett1.my>
Date: Fri, 10 Apr 2026 07:35:11 +0800
man page updated
Diffstat:
| M | sfm.1 | | | 39 | +++++++++++++++++++++++++++++++++++---- |
1 file changed, 35 insertions(+), 4 deletions(-)
diff --git a/sfm.1 b/sfm.1
@@ -43,6 +43,16 @@ Go to home directory.
.TP
.B \`
Jump to previous directory (toggle).
+.TP
+.B :
+Prompt for a path to jump to directly. Supports
+.B ~
+expansion. Shows an error if the path does not exist. Press esc to cancel.
+.TP
+.B f
+Find files recursively under the current directory. Opens an interactive
+picker. Press j/k or arrows to navigate results, enter or l to jump to the
+selected result, esc/q/h to close.
.SS Search and Filter
.TP
@@ -58,7 +68,9 @@ Exit search mode while keeping the current filter active.
.SS Display Toggles
.TP
.B .
-Toggle hidden files (dotfiles).
+Toggle hidden files (dotfiles). Hidden entries appear before regular
+entries (hidden dirs, then regular dirs, then hidden files, then
+regular files).
.TP
.B T
Toggle size/date detail column.
@@ -98,6 +110,14 @@ Open the trash directory.
.TP
.B o
Open selected file with a custom program. Press esc to cancel.
+.TP
+.B +
+Make the selected file executable
+.RB ( "chmod +x" ).
+.TP
+.B \-
+Remove execute permission from the selected file
+.RB ( "chmod -x" ).
.SS Clipboard
.TP
@@ -109,9 +129,11 @@ Cut selected entry or all multi-selected entries.
.TP
.B p
Paste clipboard contents into the current directory.
+Auto-renames on conflict by appending
+.IR _copy .
.TP
.B c
-Copy the full path of selected entry to the system clipboard.
+Copy the full path of the selected entry to the system clipboard.
Requires
.BR wl-copy ", " xclip ", " xsel ", or " pbcopy .
@@ -122,6 +144,9 @@ Toggle multi-select on the current entry (cursor advances).
.TP
.B a
Select all entries / deselect all.
+.PP
+Multi-select works with
+.BR y ", " x ", and " d .
.SS Bookmarks
.TP
@@ -139,7 +164,8 @@ Drop into
.B $SHELL
in the current directory. Type
.I exit
-to return to sfm.
+to return to sfm. The working directory is updated if you cd elsewhere
+in the shell.
.TP
.B ?
Show the keyboard shortcuts help overlay.
@@ -186,6 +212,9 @@ case "$1" in
esac
.fi
.PP
+Make it executable with:
+.B chmod +x ~/.config/sfm/opener
+.PP
If the opener script does not exist, sfm falls back to its built-in
smart opener which detects file types by extension and MIME type.
@@ -335,11 +364,13 @@ s() { cd "$(sfm)"; }
.fi
.SH AUTHORS
-Built interactively with Claude (Anthropic).
+Emmett1 <me@emmett1.my> with help of AI.
.SH SEE ALSO
+.BR find (1),
.BR ls (1),
.BR mv (1),
.BR cp (1),
.BR rm (1),
+.BR chmod (1),
.BR vi (1)