summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorsharkdp <davidpeter@web.de>2018-08-18 20:22:11 +0200
committersharkdp <davidpeter@web.de>2018-08-18 20:22:11 +0200
commita6d6c28723a033f37140e471b177947c691307d0 (patch)
tree261408a5b8ec674cedf517bb986f5983a925d827
parent2966939e38e6dae477b5d988a8a9540af1b3c869 (diff)
Add documentation on new pager-customization
-rw-r--r--README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/README.md b/README.md
index ae16a076..6f4ec419 100644
--- a/README.md
+++ b/README.md
@@ -191,6 +191,20 @@ If you ever want to go back to the default settings, call:
bat cache --clear
```
+### Using a different pager
+
+`bat` uses the pager that is specified in the `PAGER` environment variable. If this variable is not
+set, `less` is used by default. If you want to use a different pager, you can either modify the
+`PAGER` variable or set the `BAT_PAGER` environment variable to override what is specified in
+`PAGER`. If you want to pass command-line arguments to the pager, you need to create a small shell
+script as a wrapper, for example:
+
+```bash
+#!/bin/bash
+
+less --tabs 4 -RF "$@"
+```
+
## Project goals and alternatives
`bat` tries to achieve the following goals: