From efdd038fa4e698270b83f169f7373c44e27e1119 Mon Sep 17 00:00:00 2001 From: Krishna Ketan Rai Date: Thu, 10 Jul 2025 02:11:35 +0530 Subject: [PATCH] docs(man): update --style documentation with priority rules --- assets/manual/bat.1.in | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/assets/manual/bat.1.in b/assets/manual/bat.1.in index 4dc51148..84608c15 100644 --- a/assets/manual/bat.1.in +++ b/assets/manual/bat.1.in @@ -203,8 +203,18 @@ Configure which elements (line numbers, file headers, grid borders, Git modifica \&..) to display in addition to the file contents. The argument is a comma\-separated list of components to display (e.g. 'numbers,changes,grid') or a pre\-defined style ('full'). To set a default style, add the '\-\-style=".."' option to the configuration file or -export the BAT_STYLE environment variable (e.g.: export BAT_STYLE=".."). Possible -values: *default*, full, auto, plain, changes, header, header-filename, header-filesize, grid, +export the BAT_STYLE environment variable (e.g.: export BAT_STYLE=".."). +.IP +When styles are specified in multiple places, the "nearest" set of styles take precedence. +The command\-line arguments are the highest priority, followed by the BAT_STYLE environment +variable, and then the configuration file. If any set of styles consists entirely of +components prefixed with "+" or "\-", it will modify the previous set of styles instead of +replacing them. +.IP +By default, the following components are enabled: +changes, grid, header\-filename, numbers, snip +.IP +Possible values: *default*, full, auto, plain, changes, header, header-filename, header-filesize, grid, rule, numbers, snip. .HP \fB\-r\fR, \fB\-\-line\-range\fR ...