m/fzf
1
0
mirror of https://github.com/junegunn/fzf.git synced 2025-11-08 11:23:47 -05:00

Update CHANGELOG

This commit is contained in:
Junegunn Choi
2025-09-29 21:52:31 +09:00
parent c1f8d18a0c
commit 0eefcf348e

View File

@@ -6,44 +6,42 @@ CHANGELOG
### Introducing "raw" mode
In "raw" mode, non-matching items are also displayed in their original position,
but dimmed. This is useful when you want to see the surrounding items of a match
to understand the context. Raw mode can be enabled by using `--raw` option, but
I find it more useful when toggled dynamically using `toggle-raw` action.
This version introduces a new "raw" mode (named so because it shows the list
"unfiltered"). In raw mode, non-matching items stay in their original positions,
but appear dimmed. This allows you see surrounding items of a match and better
understand the context of it. You can enable raw mode by default with `--raw`,
but it's often more useful when toggled dynamically with the `toggle-raw`
action.
```sh
export FZF_CTRL_R_OPTS='--bind ctrl-x:toggle-raw'
tree | fzf --reverse --bind ctrl-x:toggle-raw
```
```sh
tree | fzf --raw --reverse --bind ctrl-x:toggle-raw
```
While non-matching items are displayed in dimmed color, they are treated just
like matching items in the list, so you place the cursor on them and do any
action against them. But if you want to navigate through matching items only,
you can use `down-match` and `up-match` actions, which are from now on bound to
`CTRL-N` and `CTRL-P` respectively. Historically, `CTRL-N` and `CTRL-P` are
bound to `next-history` and `prev-history` when `--history` option is used, so
in that case, you'll have to manually bind the actions to the keys of your
choice, or you can use `ALT-DOWN` and `ALT-UP` instead.
While non-matching items are displayed in a dimmed color, they are treated just
like matching items, so you place the cursor on them and perform any action. If
you prefer to navigate only through matching items, use the `down-match` and
`up-match` actions, which are from now on bound to `CTRL-N` and `CTRL-P`
respectively. Historically, these keys were bound to `next-history` and
`prev-history` when `--history` option is enabled, so in that case, you'll need
to manually bind them, or use `ALT-DOWN` and `ALT-UP` instead.
#### Customizing the look
##### Gutter
To distinguish the raw mode, the gutter column is rendered in dashed line using
`▖` character. But you can customize it using `--gutter-raw CHAR` option.
To make the mode visually distinct, the gutter column is rendered in a dashed
line using `▖` character. But you can customize it with the `--gutter-raw CHAR`
option.
```sh
# If you don't like the dashed line and you just want a thinner gutter
# Use a thinner gutter instead of the default dashed line
fzf --bind ctrl-x:toggle-raw --gutter-raw ▎
```
##### Color and style of non-matching items
Non-matching items are displayed in dimmed color by default, but you can change
it using `--color hidden:...` option.
Non-matching items are displayed in a dimmed color by default, but you can
change it with the `--color hidden:...` option.
```sh
fzf --raw --color hidden:red:strikethrough
@@ -52,17 +50,18 @@ fzf --raw --color hidden:red:strikethrough
fzf --raw --color hidden:regular:red:strikethrough
```
#### Leveraging `toggle-raw` in shell integration
#### Leveraging raw mode in shell integration
`CTRL-R` binding (command history) now allows you to toggle raw mode with `CTRL-X`.
The `CTRL-R` binding (command history) now lets you toggle raw mode with
`CTRL-X`.
### Style changes
This version introduces some minor changes to the traditional visual style of fzf.
This version includes a few minor updates to fzf's classic visual style:
- Narrowed the gutter column by using the left-half block character (`▌`).
- Removed background colors from markers.
- Updated `--color base16` (alias: `16`) theme so that it works better with both dark and light themes.
- The gutter column is now narrower, rendered with the left-half block character (`▌`).
- Markers no longer use background colors.
- The `--color base16` theme (alias: `16`) has been updated for better compatibility with both dark and light themes.
### Added options
@@ -92,11 +91,11 @@ fzf --gutter ' '
#### `--gutter-raw CHAR`
As mentioned above, also added `--gutter-raw CHAR` option for customizing the gutter column in raw mode.
As noted above, the `--gutter-raw CHAR` option was also added for customizing the gutter column in raw mode.
### Compatibility changes
Starting from this version, fzf is built with Go 1.23. Support for some old OS versions has been dropped.
Starting with this release, fzf is built with Go 1.23. Support for some old OS versions has been dropped.
See https://go.dev/wiki/MinimumRequirements.