@@ -32,6 +32,9 @@ languages:
3232
3333### Show non-printable characters
3434
35+You can use the `-A`/`--show-all` option to show and highlight non-printable
36+characters:
37+
3538
3639
3740### Automatic paging
@@ -70,8 +73,12 @@ Read from stdin, specify the language explicitly
7073> yaml2json .travis.yml | json_pp | bat -l json
7174```
7275
76+Show and highlight non-printable characters:
77+```bash
78+> bat -A /etc/hosts
79+```
7380
74−As a replacement for `cat`:
81+Use it as a `cat` replacement:
7582
7683```bash
7784bat > note.md # quickly create a new file
@@ -200,8 +207,7 @@ This should work with the following distributions:
200207
201208Check out the [Release page](https://github.com/sharkdp/bat/releases) for
202209prebuilt versions of `bat` for many different architectures. Statically-linked
203−binaries are available, just look for releases with `musl` in the name on the
204−releases page.
210+binaries are also available: look for archives with `musl` in the file name.
205211
206212### From source
207213
@@ -223,7 +229,8 @@ Use `bat --list-themes` to get a list of all available themes for syntax
223229highlighting. To select the `TwoDark` theme, call `bat` with the
224230`--theme=TwoDark` option or set the `BAT_THEME` environment variable to
225231`TwoDark`. Use `export BAT_THEME="TwoDark"` in your shell's startup file to
226−make the change permanent.
232+make the change permanent. Alternatively, use `bat`s
233+[configuration file](https://github.com/sharkdp/bat#configuration-file).
227234
228235If you want to preview the different themes on a custom file, you can use
229236the following command (you need [`fzf`](https://github.com/junegunn/fzf) for this):
@@ -232,16 +239,17 @@ bat --list-themes | fzf --preview="bat --theme={} --color=always /path/to/file"
232239```
233240
234241`bat` looks good on a dark background by default. However, if your terminal uses a
235−light background, some themes will work better for you. For example, the `GitHub`
236−theme is made for light backgrounds. You can also make your own theme by following the
242+light background, some themes like `GitHub` or `OneHalfLight` will work better for you.
243+You can also use a custom theme by following the
237244['Adding new themes' section below](https://github.com/sharkdp/bat#adding-new-themes).
238245
239246### Output style
240247
241248You can use the `--style` option to control the appearance of `bat`s output.
242249You can use `--style=numbers,changes`, for example, to show only Git changes
243−and line numbers but no grid and no file header. Use the `BAT_STYLE` environment
244−variable to make these changes permanent.
250+and line numbers but no grid and no file header. Set the `BAT_STYLE` environment
251+variable to make these changes permanent or use `bat`s
252+[configuration file](https://github.com/sharkdp/bat#configuration-file).
245253
246254### Adding new syntaxes / language definitions
247255
@@ -311,6 +319,8 @@ If you want to pass command-line arguments to the pager, you can also set them v
311319export BAT_PAGER="less -RF"
312320```
313321
322+Instead of using environment variables, you can also use `bat`s [configuration file](https://github.com/sharkdp/bat#configuration-file) to configure the pager (`--pager` option).
323+
314324**Note**: By default, if the pager is set to `less` (any no command-line options are specified),
315325`bat` will pass the following command line
316326options to the pager: `-R`/`--RAW-CONTROL-CHARS`, `-F`/`--quit-if-one-screen` and `-X`/`--no-init`.
@@ -325,7 +335,7 @@ will hopefully enable both quit-if-one-screen and mouse-wheel scrolling.
325335
326336If scrolling still doesn't work for you, you can try to pass the `-S` option in addition.
327337
328−### Configuration file
338+## Configuration file
329339
330340`bat` can also be customized with a configuration file. The location of the file is dependent on you operating system. To get the default path for your system, call
331341```
@@ -337,7 +347,7 @@ Alternatively, you can use the `BAT_CONFIG_PATH` environment variable to point `
337347export BAT_CONFIG_PATH="/path/to/bat.conf"
338348```
339349
340−#### Format
350+### Format
341351
342352The configuration file is a simple list of command line arguments. Use `bat --help` to see a full list of possible options and values. In addition, you can add comments by prepending a line with the `#` character.
343353