summaryrefslogtreecommitdiff
path: root/yazi-enter.yazi/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'yazi-enter.yazi/README.txt')
-rw-r--r--yazi-enter.yazi/README.txt32
1 files changed, 26 insertions, 6 deletions
diff --git a/yazi-enter.yazi/README.txt b/yazi-enter.yazi/README.txt
index 6454872..cb8d57e 100644
--- a/yazi-enter.yazi/README.txt
+++ b/yazi-enter.yazi/README.txt
@@ -1,8 +1,8 @@
YAZI-ENTER
Find an entry in the current Yazi view and activate the Hovered match.
-Matching, cursor movement, directory entry, and file opening use Yazi's
-built-in actions.
+Matching, sorting, cursor movement, directory entry, and file opening use Yazi's
+built-in manager actions.
REQUIREMENTS
@@ -10,8 +10,7 @@ REQUIREMENTS
- Yazi's bundled Lua runtime.
The runtime contract is verified against Yazi 26.9.1. Review compatibility
-before using a later Yazi release. Find behavior runs entirely through Yazi's
-native finder.
+before you use a later Yazi release.
INSTALLATION
@@ -47,7 +46,7 @@ keys and activates either entry type:
Use one TOML keymap form consistently. If the file already has an
[mgr] prepend_keymap array, add equivalent mapping objects to that array.
-Restart Yazi after changing the plugin or keymap files.
+Restart Yazi after you change the plugin or keymap files.
Choose any keys and any of these actions:
@@ -74,6 +73,27 @@ the action after submission. A type mismatch produces a zero-action result.
File opening targets only the Hovered match and uses the current Yazi opener
rules. Persistent selections stay separate from that target.
+TRANSIENT SORTING
+
+Each valid invocation saves the active tab's complete sort preference. It then
+applies forward alphabetical sorting before it opens the prompt. This is the
+same sort request as Yazi's default `,a` binding:
+
+ sort alphabetical --reverse=no
+
+The temporary request changes only the sort method and reverse flag. The
+current directory-first, case-sensitivity, transliteration, and fallback
+settings stay active during the prompt.
+
+The plugin restores all six saved sort fields when the session ends. Restore
+runs after directory entry, hovered-file opening, a zero-action result, Cancel,
+input closure, a failed final Find, or a caught runtime error. Directory entry
+and file opening are queued before restore.
+
+Overlapping yazi-enter prompts share one sort lease. The first prompt saves the
+original preference. Alphabetical order stays active until the final prompt
+closes. The final release restores the original preference once.
+
OPTIONS
- --previous searches in current-then-backward order and wraps.
@@ -94,7 +114,7 @@ input history.
Queries are unanchored Rust regular expressions. Plain text normally acts as a
substring query. Escape regular-expression characters when they must be
-literal. During typing, a malformed expression can be corrected in the same
+literal. During typing, you can correct a malformed expression in the same
prompt.
A successful query moves the cursor with Yazi's native find behavior. Submit