m/fzf
1
0
Fork 0
mirror of https://github.com/junegunn/fzf.git synced 2025-11-11 21:03:49 -05:00
Code Packages Releases Wiki Activity

Update CHANGELOG

Browse Source
This commit is contained in:
Junegunn Choi
2025-09-29 21:52:31 +09:00
parent c1f8d18a0c
commit 0eefcf348e
1 changed files with 29 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

59
CHANGELOG.md
View File

@@ -6,44 +6,42 @@ CHANGELOG
### Introducing "raw" mode ### Introducing "raw" mode
In "raw" mode, non-matching items are also displayed in their original position, This version introduces a new "raw" mode (named so because it shows the list
but dimmed. This is useful when you want to see the surrounding items of a match "unfiltered"). In raw mode, non-matching items stay in their original positions,
to understand the context. Raw mode can be enabled by using `--raw` option, but but appear dimmed. This allows you see surrounding items of a match and better
I find it more useful when toggled dynamically using `toggle-raw` action. 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 ```sh
export FZF_CTRL_R_OPTS='--bind ctrl-x:toggle-raw' tree | fzf --reverse --bind ctrl-x:toggle-raw
``` ```
```sh While non-matching items are displayed in a dimmed color, they are treated just
tree | fzf --raw --reverse --bind ctrl-x:toggle-raw 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`
While non-matching items are displayed in dimmed color, they are treated just respectively. Historically, these keys were bound to `next-history` and
like matching items in the list, so you place the cursor on them and do any `prev-history` when `--history` option is enabled, so in that case, you'll need
action against them. But if you want to navigate through matching items only, to manually bind them, or use `ALT-DOWN` and `ALT-UP` instead.
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.
#### Customizing the look #### Customizing the look
##### Gutter ##### Gutter
To distinguish the raw mode, the gutter column is rendered in dashed line using To make the mode visually distinct, the gutter column is rendered in a dashed
`▖` character. But you can customize it using `--gutter-raw CHAR` option. line using `▖` character. But you can customize it with the `--gutter-raw CHAR`
option.
```sh ```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 ▎ fzf --bind ctrl-x:toggle-raw --gutter-raw ▎
``` ```
##### Color and style of non-matching items ##### Color and style of non-matching items
Non-matching items are displayed in dimmed color by default, but you can change Non-matching items are displayed in a dimmed color by default, but you can
it using `--color hidden:...` option. change it with the `--color hidden:...` option.
```sh ```sh
fzf --raw --color hidden:red:strikethrough fzf --raw --color hidden:red:strikethrough
@@ -52,17 +50,18 @@ fzf --raw --color hidden:red:strikethrough
fzf --raw --color hidden:regular: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 ### 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 (`▌`). - The gutter column is now narrower, rendered with the left-half block character (`▌`).
- Removed background colors from markers. - Markers no longer use background colors.
- Updated `--color base16` (alias: `16`) theme so that it works better with both dark and light themes. - The `--color base16` theme (alias: `16`) has been updated for better compatibility with both dark and light themes.
### Added options ### Added options
@@ -92,11 +91,11 @@ fzf --gutter ' '
#### `--gutter-raw CHAR` #### `--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 ### 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. See https://go.dev/wiki/MinimumRequirements.