on master help sign in
Merge pull request #1389 from nstickney/master

explain how to use bat as cat (no paging) (closes #1383)

commit6d75540d4e95c57ba89d5810d271bc687761763e authorEthan P <32112321+eth-p@users.noreply.github.com> dateSat 21 Nov 2020, 10:13 (6 years ago) parent2b82203ba5cbe2
1 file changed+6−6
README.md+6−6
README.md+6−6
@@ -38,14 +38,14 @@ characters:
3838
3939### Automatic paging
4040
41−`bat` can pipe its own output to a pager (e.g `less`) if the output is too large for one screen.
41+By default, `bat` pipes its own output to a pager (e.g `less`) if the output is too large for one screen.
42+If you would rather `bat` work like `cat` all the time (never page output), you can set `--paging=never` as an option, either on the command line or in your configuration file.
43+If you intend to alias `cat` to `bat` in your shell configuration, you can use `alias cat='bat --paging=never'` to preserve the default behavior.
4244
43−### File concatenation
45+#### File concatenation
4446
45−Oh.. you can also use it to concatenate files :wink:. Whenever
46−`bat` detects a non-interactive terminal (i.e. when you pipe into another process
47−or into a file), `bat` will act as a drop-in replacement for `cat` and
48−fall back to printing the plain file contents.
47+Even with a pager set, you can still use `bat` to concatenate files :wink:.
48+Whenever `bat` detects a non-interactive terminal (i.e. when you pipe into another process or into a file), `bat` will act as a drop-in replacement for `cat` and fall back to printing the plain file contents, regardless of the `--pager` option's value.
4949
5050## How to use
5151