navigine/fzf
1
0 Fork 0
mirror of https://github.com/junegunn/fzf.git synced 2026-10-28 08:05:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

change-nth: empty value restores default --nth

Browse Source 
- Same rule as change-with-nth and transform-with-nth
    - Empty: default
    - '..': all fields
    - Non-empty invalid: ignored
- Previously, change-nth() and empty transform-nth output searched
  all fields, and transform-nth could not restore default
- Partly reverts af0014ab. Use change-nth(..) to unset default
This commit is contained in:
Junegunn Choi committed 2026-10-21 08:29:43 +09:00
1 parent c943963281
commit d3d6e40962
4 files changed
+48 -14
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

man/man1/fzf.1
+26 -4
View File
@@ -2060,8 +2060,8 @@ A key or an event can be bound to one or more of the following actions.
\fBchange\-list\-label(...)\fR (change \fB\-\-list\-label\fR to the given string)
\fBchange\-multi\fR (enable multi-select mode with no limit)
\fBchange\-multi(...)\fR (enable multi-select mode with a limit or disable it with 0)
\fBchange\-nth(...)\fR (change \fB\-\-nth\fR option; rotate through the multiple options separated by '|', starting from the one after the current option)
\fBchange\-with\-nth(...)\fR (change \fB\-\-with\-nth\fR option; rotate through the multiple options separated by '|', starting from the one after the current option)
\fBchange\-nth(...)\fR (change \fB\-\-nth\fR option; see CHANGE NTH AND WITH\-NTH)
\fBchange\-with\-nth(...)\fR (change \fB\-\-with\-nth\fR option; see CHANGE NTH AND WITH\-NTH)
\fBchange\-pointer(...)\fR (change \fB\-\-pointer\fR option)
\fBchange\-preview(...)\fR (change \fB\-\-preview\fR option)
\fBchange\-preview\-label(...)\fR (change \fB\-\-preview\-label\fR to the given string)
@@ -2166,8 +2166,8 @@ A key or an event can be bound to one or more of the following actions.
\fBtransform\-header\-label(...)\fR (transform header label using an external command)
\fBtransform\-input\-label(...)\fR (transform input label using an external command)
\fBtransform\-list\-label(...)\fR (transform list label using an external command)
\fBtransform\-nth(...)\fR (transform nth using an external command; no rotation, output is used as a whole)
\fBtransform\-with\-nth(...)\fR (transform with-nth using an external command; no rotation, output is used as a whole)
\fBtransform\-nth(...)\fR (transform nth using an external command; see CHANGE NTH AND WITH\-NTH)
\fBtransform\-with\-nth(...)\fR (transform with-nth using an external command; see CHANGE NTH AND WITH\-NTH)
\fBtransform\-pointer(...)\fR (transform pointer using an external command)
\fBtransform\-preview\-label(...)\fR (transform preview label using an external command)
\fBtransform\-prompt(...)\fR (transform prompt string using an external command)
@@ -2405,6 +2405,28 @@ e.g.
# This is equivalent to toggle\-preview action
fzf \-\-preview 'cat {}' \-\-bind 'ctrl\-/:change\-preview\-window(hidden|)'
.SS CHANGE NTH AND WITH\-NTH
\fBchange\-nth\fR and \fBchange\-with\-nth\fR actions change \fB\-\-nth\fR and
\fB\-\-with\-nth\fR options. You can specify multiple values separated by '|'
characters. Each time the action runs, fzf applies the value after the current
one in the list, skipping the values equal to the current one.
\fBtransform\-nth\fR and \fBtransform\-with\-nth\fR actions (and their
\fBbg\-\fR variants) take the output of the command as a single value. The
following rules apply to all of these actions.
* An empty value restores the default given by the option
* \fB..\fR selects all fields
* A non\-empty invalid value is ignored
e.g.
# All fields, then fields 1, 2, and 3
fzf \-\-bind 'ctrl\-/:change\-nth(..|1|2|3)'
# An empty string in the list is interpreted as the default
fzf \-\-nth 1 \-\-bind 'ctrl\-/:change\-nth(2|)'
.SH AUTHOR
Junegunn Choi (\fIjunegunn.c@gmail.com\fR)