From ffd23141206a0b0ed03d899adcbcc88ed7b2e8d9 Mon Sep 17 00:00:00 2001 From: Junegunn Choi Date: Fri, 25 Aug 2023 17:59:50 +0900 Subject: [PATCH] Restore --no-clear option in man page Close #3411 --- CHANGELOG.md | 2 +- man/man1/fzf.1 | 15 +++++++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 01afb28..deb4ec7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -368,7 +368,7 @@ CHANGELOG (sleep 2; seq 1000) | fzf --height ~50% ``` - Fixed tcell renderer used to render full-screen fzf on Windows -- `--no-clear` is deprecated. Use `reload` action instead. +- ~~`--no-clear` is deprecated. Use `reload` action instead.~~ 0.33.0 ------ diff --git a/man/man1/fzf.1 b/man/man1/fzf.1 index 70a9064..e9de4fe 100644 --- a/man/man1/fzf.1 +++ b/man/man1/fzf.1 @@ -758,6 +758,21 @@ Read input delimited by ASCII NUL characters instead of newline characters .TP .B "--print0" Print output delimited by ASCII NUL characters instead of newline characters +.TP +.B "--no-clear" +Do not clear finder interface on exit. If fzf was started in full screen mode, +it will not switch back to the original screen, so you'll have to manually run +\fBtput rmcup\fR to return. This option can be used to avoid flickering of the +screen when your application needs to start fzf multiple times in order. (Note +that in most cases, it is preferable to use \fBreload\fR action instead.) + +e.g. + \fBfoo=$(seq 100 | fzf --no-clear) || ( + # Need to manually switch back to the main screen when cancelled + tput rmcup + exit 1 + ) && seq "$foo" 100 | fzf + .TP .B "--sync" Synchronous search for multi-staged filtering. If specified, fzf will launch