@@ -17,25 +17,28 @@ either '--language value', '--language=value', '-l value' or '-lvalue'.
1717.HP
1818\fB\-l\fR, \fB\-\-language\fR <language>
1919.IP
20−Explicitly set the language for syntax highlighting. The language can be specified as a
21−name (like 'C++' or 'LaTeX') or possible file extension (like 'cpp', 'hpp' or 'md'). Use
22−\&'\-\-list\-languages' to show all supported language names and file extensions.
20+Explicitly set the language for syntax highlighting. The language can be
21+specified as a name (like 'C++' or 'LaTeX') or possible file extension
22+(like 'cpp', 'hpp' or 'md'). Use '\-\-list\-languages' to show all supported
23+language names and file extensions.
2324.HP
24−\fB\-\-list\-languages\fR
25+\fB\-L\fR, \fB\-\-list\-languages\fR
2526.IP
2627Display a list of supported languages for syntax highlighting.
2728.HP
2829\fB\-m\fR, \fB\-\-map\-syntax\fR <from:to>...
2930.IP
30−Map a file extension or file name to an existing syntax. For example, to highlight
31−*.conf files with the INI syntax, use '\-m conf:ini'. To highlight files named
32−\&'.myignore' with the Git Ignore syntax, use '\-m .myignore:gitignore'.
31+Map a file extension or file name to an existing syntax. For example, to
32+highlight *.conf files with the INI syntax, use '\-m conf:ini'. To
33+highlight files named '.myignore' with the Git Ignore syntax, use '\-m
34+\&.myignore:gitignore'.
3335.HP
3436\fB\-\-theme\fR <theme>
3537.IP
36−Set the theme for syntax highlighting. Use '\-\-list\-themes' to see all available themes.
37−To set a default theme, add the '\-\-theme "..."' option to the configuration file or
38−export the BAT_THEME environment variable (e.g.: export BAT_THEME="...").
38+Set the theme for syntax highlighting. Use '\-\-list\-themes' to see all
39+available themes. To set a default theme, add the '\-\-theme="..."' option
40+to the configuration file or export the BAT_THEME environment variable
41+(e.g.: export BAT_THEME="...").
3942.HP
4043\fB\-\-list\-themes\fR
4144.IP
@@ -43,27 +46,29 @@ Display a list of supported themes for syntax highlighting.
4346.HP
4447\fB\-\-style\fR <style\-components>
4548.IP
46−Configure which elements (line numbers, file headers, grid borders, Git modifications,
47−\&..) to display in addition to the file contents. The argument is a comma\-separated list
48−of components to display (e.g. 'numbers,changes,grid') or a pre\-defined style ('full').
49−To set a default style, add the '\-\-style ".."' option to the configuration file or
50−export the BAT_STYLE environment variable (e.g.: export BAT_STYLE=".."). Possible
51−values: *auto*, full, plain, changes, header, grid, numbers.
49+Configure which elements (line numbers, file headers, grid borders, Git
50+modifications, ..) to display in addition to the file contents. The
51+argument is a comma\-separated list of components to display (e.g.
52+\&'numbers,changes,grid') or a pre\-defined style ('full'). To set a default
53+style, add the '\-\-style=".."' option to the configuration file or export
54+the BAT_STYLE environment variable (e.g.: export BAT_STYLE=".."). Possible
55+values: *auto*, full, plain, changes, header, grid, numbers, snip.
5256.HP
5357\fB\-p\fR, \fB\-\-plain\fR
5458.IP
55−Only show plain style, no decorations. This is an alias for '\-\-style plain'. When '\-p'
56−is used twice ('\-pp'), it also disables automatic paging (alias for '\-\-style plain
57−\fB\-\-pager\fR=\fI\,never\/\fR').
59+Only show plain style, no decorations. This is an alias for
60+\&'\-\-style=plain'. When '\-p' is used twice ('\-pp'), it also disables
61+automatic paging (alias for '\-\-style=plain \fB\-\-pager\fR=\fI\,never\/\fR').
5862.HP
5963\fB\-n\fR, \fB\-\-number\fR
6064.IP
61−Only show line numbers, no other decorations. This is an alias for '\-\-style numbers'
65+Only show line numbers, no other decorations. This is an alias for
66+\&'\-\-style=numbers'
6267.HP
6368\fB\-A\fR, \fB\-\-show\-all\fR
6469.IP
65−Show non\-printable characters like space, tab or newline. Use '\-\-tabs' to control the
66−width of the tab\-placeholders.
70+Show non\-printable characters like space, tab or newline. Use '\-\-tabs' to
71+control the width of the tab\-placeholders.
6772.HP
6873\fB\-r\fR, \fB\-\-line\-range\fR <N:M>...
6974.IP
@@ -83,52 +88,57 @@ Highlight the N\-th line with a different background color
8388.HP
8489\fB\-\-color\fR <when>
8590.IP
86−Specify when to use colored output. The automatic mode only enables colors if an
87−interactive terminal is detected. Possible values: *auto*, never, always.
91+Specify when to use colored output. The automatic mode only enables colors
92+if an interactive terminal is detected. Possible values: *auto*, never,
93+always.
8894.HP
8995\fB\-\-italic\-text\fR <when>
9096.IP
91−Specify when to use ANSI sequences for italic text in the output. Possible values:
92−always, *never*.
97+Specify when to use ANSI sequences for italic text in the output. Possible
98+values: always, *never*.
9399.HP
94100\fB\-\-decorations\fR <when>
95101.IP
96−Specify when to use the decorations that have been specified via '\-\-style'. The
97−automatic mode only enables decorations if an interactive terminal is detected. Possible
98−values: *auto*, never, always.
102+Specify when to use the decorations that have been specified via
103+\&'\-\-style'. The automatic mode only enables decorations if an interactive
104+terminal is detected. Possible values: *auto*, never, always.
99105.HP
100106\fB\-\-paging\fR <when>
101107.IP
102−Specify when to use the pager. To control which pager is used, set the PAGER or
103−BAT_PAGER environment variables (the latter takes precedence) or use the '\-\-pager'
104−option. To disable the pager permanently, set BAT_PAGER to an empty string or set
105−\&'\-\-paging never' in the configuration file. Possible values: *auto*, never, always.
108+Specify when to use the pager. To control which pager is used, set the
109+PAGER or BAT_PAGER environment variables (the latter takes precedence) or
110+use the '\-\-pager' option. To disable the pager permanently, set BAT_PAGER
111+to an empty string or set '\-\-paging=never' in the configuration file.
112+Possible values: *auto*, never, always.
106113.HP
107114\fB\-\-pager\fR <command>
108115.IP
109−Determine which pager is used. This option will overwrite the PAGER and BAT_PAGER
110−environment variables. The default pager is 'less'. To disable the pager completely, use
111−the '\-\-paging' option. Example: '\-\-pager "less \fB\-RF\fR"'.
116+Determine which pager is used. This option will overwrite the PAGER and
117+BAT_PAGER environment variables. The default pager is 'less'. To disable
118+the pager completely, use the '\-\-paging' option. Example: '\-\-pager "less
119+\fB\-RF\fR"'.
112120.HP
113121\fB\-\-wrap\fR <mode>
114122.IP
115−Specify the text\-wrapping mode (*auto*, never, character). The '\-\-terminal\-width' option
116−can be used in addition to control the output width.
123+Specify the text\-wrapping mode (*auto*, never, character). The
124+\&'\-\-terminal\-width' option can be used in addition to control the output
125+width.
117126.HP
118127\fB\-\-tabs\fR <T>
119128.IP
120−Set the tab width to T spaces. Use a width of 0 to pass tabs through directly
129+Set the tab width to T spaces. Use a width of 0 to pass tabs through
130+directly
121131.HP
122132\fB\-u\fR, \fB\-\-unbuffered\fR
123133.IP
124−This option exists for POSIX\-compliance reasons ('u' is for 'unbuffered'). The output is
125−always unbuffered \- this option is simply ignored.
134+This option exists for POSIX\-compliance reasons ('u' is for 'unbuffered').
135+The output is always unbuffered \- this option is simply ignored.
126136.HP
127137\fB\-\-terminal\-width\fR <width>
128138.IP
129−Explicitly set the width of the terminal instead of determining it automatically. If
130−prefixed with '+' or '\-', the value will be treated as an offset to the actual terminal
131−width. See also: '\-\-wrap'.
139+Explicitly set the width of the terminal instead of determining it
140+automatically. If prefixed with '+' or '\-', the value will be treated as
141+an offset to the actual terminal width. See also: '\-\-wrap'.
132142.HP
133143\fB\-h\fR, \fB\-\-help\fR
134144.IP