diff --git a/README.md b/README.md index efb4dd65..413a8a84 100644 --- a/README.md +++ b/README.md @@ -646,7 +646,7 @@ If you want to pass command-line arguments to the pager, you can also set them v `PAGER`/`BAT_PAGER` variables: ```bash -export BAT_PAGER="less -RF" +export BAT_PAGER="less -RFK" ``` Instead of using environment variables, you can also use `bat`'s [configuration file](#configuration-file) to configure the pager (`--pager` option). @@ -656,7 +656,7 @@ Instead of using environment variables, you can also use `bat`'s [configuration When using `less` as a pager, `bat` will automatically pass extra options along to `less` to improve the experience. Specifically, `-R`/`--RAW-CONTROL-CHARS`, `-F`/`--quit-if-one-screen`, -and under certain conditions, `-X`/`--no-init` and/or `-S`/`--chop-long-lines`. +`-K`/`--quit-on-intr` and under certain conditions, `-X`/`--no-init` and/or `-S`/`--chop-long-lines`. >[!IMPORTANT] > These options will not be added if: @@ -674,6 +674,9 @@ The `-F` option instructs `less` to exit immediately if the output size is small the vertical size of the terminal. This is convenient for small files because you do not have to press `q` to quit the pager. +The `-K` option instructs `less` to exit immediately when an interrupt signal is received. +This is useful to ensure that `less` quits together with `bat` on SIGINT. + The `-X` option is needed to fix a bug with the `--quit-if-one-screen` feature in versions of `less` older than version 530. Unfortunately, it also breaks mouse-wheel support in `less`. If you want to enable mouse-wheel scrolling on older versions of `less` and do not mind losing diff --git a/src/output.rs b/src/output.rs index bb9a45d5..e15c478e 100644 --- a/src/output.rs +++ b/src/output.rs @@ -93,6 +93,9 @@ impl OutputType { p.arg("-S"); // Short version of --chop-long-lines for compatibility } + // Ensures that 'less' quits together with 'bat' + p.arg("-K"); // Short version of '--quit-on-intr' + // Passing '--no-init' fixes a bug with '--quit-if-one-screen' in older // versions of 'less'. Unfortunately, it also breaks mouse-wheel support. //