NAME

       bat - manual page for bat

DESCRIPTION

       bat - a cat(1) clone with syntax highlighting and Git integration.

USAGE

              bat [OPTIONS] [FILE]...

              bat <SUBCOMMAND>

OPTIONS

       General remarks

              Command-line  options  like  '-l'/'--language' that take values can be specified as
              either '--language value', '--language=value', '-l value' or '-lvalue'.

       -l, --language <language>

              Explicitly set the language for syntax highlighting. The language can be  specified
              as  a name (like 'C++' or 'LaTeX') or possible file extension (like 'cpp', 'hpp' or
              'md'). Use '--list-languages'  to  show  all  supported  language  names  and  file
              extensions.

       -L, --list-languages

              Display a list of supported languages for syntax highlighting.

       -m, --map-syntax <from:to>...

              Map  a file extension or file name to an existing syntax. For example, to highlight
              *.conf files with the INI syntax, use  '-m  conf:ini'.  To  highlight  files  named
              '.myignore' with the Git Ignore syntax, use '-m .myignore:gitignore'.

       --theme <theme>

              Set  the  theme  for  syntax highlighting. Use '--list-themes' to see all available
              themes. To set a default theme, add the '--theme="..."' option to the configuration
              file or export the BAT_THEME environment variable (e.g.: export BAT_THEME="...").

       --list-themes

              Display a list of supported themes for syntax highlighting.

       --style <style-components>

              Configure   which   elements   (line  numbers,  file  headers,  grid  borders,  Git
              modifications, ..) 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:  *auto*,  full,  plain,  changes,  header,
              grid, numbers, snip.

       -p, --plain

              Only  show  plain style, no decorations. This is an alias for '--style=plain'. When
              '-p'  is  used  twice  ('-pp'),  it  also  disables  automatic  paging  (alias  for
              '--style=plain --pager=never').

       -n, --number

              Only   show   line   numbers,   no   other   decorations.  This  is  an  alias  for
              '--style=numbers'

       -A, --show-all

              Show non-printable characters like space, tab or newline. Use '--tabs'  to  control
              the width of the tab-placeholders.

       -r, --line-range <N:M>...

              Only print the specified range of lines for each file. For example:

              --line-range 30:40
                     prints lines 30 to 40

              --line-range :40
                     prints lines 1 to 40

              --line-range 40:
                     prints lines 40 to the end of the file

       -H, --highlight-line <N>...

              Highlight the N-th line with a different background color

       --color <when>

              Specify  when  to  use colored output. The automatic mode only enables colors if an
              interactive terminal is detected. Possible values: *auto*, never, always.

       --italic-text <when>

              Specify when to use ANSI sequences for italic text in the output. Possible  values:
              always, *never*.

       --decorations <when>

              Specify  when  to  use  the decorations that have been specified via '--style'. The
              automatic mode only enables decorations if an  interactive  terminal  is  detected.
              Possible values: *auto*, never, always.

       --paging <when>

              Specify  when  to  use  the pager. To control which pager is used, set the PAGER or
              BAT_PAGER environment variables (the latter takes precedence) or use the  '--pager'
              option.  To  disable the pager permanently, set BAT_PAGER to an empty string or set
              '--paging=never' in  the  configuration  file.   Possible  values:  *auto*,  never,
              always.

       --pager <command>

              Determine  which  pager is used. This option will overwrite the PAGER and BAT_PAGER
              environment  variables.  The  default  pager  is  'less'.  To  disable  the   pager
              completely, use the '--paging' option. Example: '--pager "less -RF"'.

       --wrap <mode>

              Specify  the  text-wrapping mode (*auto*, never, character). The '--terminal-width'
              option can be used in addition to control the output width.

       --tabs <T>

              Set the tab width to T spaces. Use a width of 0 to pass tabs through directly

       -u, --unbuffered

              This option exists for POSIX-compliance reasons ('u'  is  for  'unbuffered').   The
              output is always unbuffered - this option is simply ignored.

       --terminal-width <width>

              Explicitly  set  the width of the terminal instead of determining it automatically.
              If prefixed with '+' or '-', the value will be treated as an offset to  the  actual
              terminal width. See also: '--wrap'.

       -h, --help

              Print this help message.

       -V, --version

              Show version information.

ARGS

              <FILE>...

              File(s) to print / concatenate. Use a dash ('-') or no argument at all to read from
              standard input.

SUBCOMMANDS

              cache Modify the syntax-definition and theme cache

                                                                                           BAT(1)