From a6d6c28723a033f37140e471b177947c691307d0 Mon Sep 17 00:00:00 2001 From: sharkdp Date: Sat, 18 Aug 2018 20:22:11 +0200 Subject: [PATCH] Add documentation on new pager-customization --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) 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: