Skip to content

docs: Improve README on less pager options#3443

Merged
Enselic merged 3 commits into
sharkdp:masterfrom
injust:patch-1
Oct 20, 2025
Merged

docs: Improve README on less pager options#3443
Enselic merged 3 commits into
sharkdp:masterfrom
injust:patch-1

Conversation

@injust
Copy link
Copy Markdown
Contributor

@injust injust commented Oct 19, 2025

Adding the long names for less options makes the README easier to skim, without having to jump to the first paragraph of https://github.com/sharkdp/bat/blob/master/README.md#using-less-as-a-pager to see what the equivalent long option is called.

Also clarify that -X is not added on modern versions of less.

@injust injust changed the title docs: Mention less options by short+long names docs: Improve README on less pager options Oct 19, 2025
@lmmx

This comment was marked as resolved.

Copy link
Copy Markdown
Collaborator

@Enselic Enselic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good, thanks

@Enselic Enselic enabled auto-merge (rebase) October 20, 2025 17:13
@Enselic Enselic merged commit 4e13c3e into sharkdp:master Oct 20, 2025
24 checks passed
@injust injust deleted the patch-1 branch October 20, 2025 17:24
tmeijn pushed a commit to tmeijn/dotfiles that referenced this pull request Dec 3, 2025
This MR contains the following updates:

| Package | Update | Change |
|---|---|---|
| [sharkdp/bat](https://github.com/sharkdp/bat) | patch | `v0.26.0` -> `v0.26.1` |

MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot).

**Proposed changes to behavior should be submitted there as MRs.**

---

### Release Notes

<details>
<summary>sharkdp/bat (sharkdp/bat)</summary>

### [`v0.26.1`](https://github.com/sharkdp/bat/blob/HEAD/CHANGELOG.md#v0261)

[Compare Source](sharkdp/bat@v0.26.0...v0.26.1)

#### Features

- Add paging to '-h' and '--help' see MR [#&#8203;3478](sharkdp/bat#3478) ([@&#8203;MuntasirSZN](https://github.com/MuntasirSZN))

#### Bugfixes

- Fix hang when using `--list-themes` with an explicit pager, see [#&#8203;3457](sharkdp/bat#3457) ([@&#8203;abhinavcool42](https://github.com/abhinavcool42))
- Fix negative values of N not being parsed in \<N:M> line ranges without `=` flag value separator, see [#&#8203;3442](sharkdp/bat#3442) ([@&#8203;lmmx](https://github.com/lmmx))
- Fix broken Docker syntax preventing use of custom assets, see [#&#8203;3476](sharkdp/bat#3476) ([@&#8203;keith-hall](https://github.com/keith-hall))
- Fix decorations being applied unexpectedly when piping. Now only line numbers explicitly required on the command line should be applied in auto decorations mode for `cat` compatibility. See [#&#8203;3496](sharkdp/bat#3496) ([@&#8203;keith-hall](https://github.com/keith-hall))
- Fix diagnostics attempting to find the version of an executable named builtin when builtin pager is used. See [#&#8203;3498](sharkdp/bat#3498) ([@&#8203;keith-hall](https://github.com/keith-hall))
- `--help` now correctly reads the config file for theme information etc. See [#&#8203;3507](sharkdp/bat#3507) ([@&#8203;keith-hall](https://github.com/keith-hall))

#### Other

- Improve README documentation on pager options passed to less, see [#&#8203;3443](sharkdp/bat#3443) ([@&#8203;injust](https://github.com/injust))
- Make PowerShell completions compatible with PowerShell v5.1, see [#&#8203;3495](sharkdp/bat#3495) ([@&#8203;keith-hall](https://github.com/keith-hall))
- Use more robust approach to escaping in Bash completions, see [#&#8203;3448](sharkdp/bat#3448) ([@&#8203;akinomyoga](https://github.com/akinomyoga))

#### Syntaxes

- Update quadlet syntax mapping to include \*.{build,pod} files [#&#8203;3484](sharkdp/bat#3484) ([@&#8203;cyqsimon](https://github.com/cyqsimon))
- Fix inconsistencies in Ada syntax, see [#&#8203;3481](sharkdp/bat#3481) ([@&#8203;AldanTanneo](https://github.com/AldanTanneo))
- Add syntax mapping for podman's `artifact` quadlet files, see [#&#8203;3497](sharkdp/bat#3497) ([@&#8203;xduugu](https://github.com/xduugu))
- Highlight Korn Shell scripts (i.e. with a shebang of ...`ksh`) using Bash syntax, see [#&#8203;3509](sharkdp/bat#3509) ([@&#8203;keith-hall](https://github.com/keith-hall))

#### Themes

#### `bat` as a library

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever MR is behind base branch, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this MR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this MR, check this box

---

This MR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0Mi4zMC40IiwidXBkYXRlZEluVmVyIjoiNDIuMzAuNCIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiUmVub3ZhdGUgQm90Il19-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants