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)