diff --git a/pages/common/bat.md b/pages/common/bat.md index 8c93cd30b..23fd84dbd 100644 --- a/pages/common/bat.md +++ b/pages/common/bat.md @@ -4,7 +4,7 @@ > A `cat` clone with syntax highlighting and Git integration. > More information: . -- Print the contents of one or more files to `stdout`: +- Pretty print the contents of one or more files to `stdout`: `bat {{path/to/file1 path/to/file2 ...}}` @@ -12,18 +12,26 @@ `bat {{path/to/file1 path/to/file2 ...}} > {{path/to/target_file}}` -- Append several files into the target file: +- Remove decorations and disable paging (`--style plain` can be replaced with `-p`, or both options with `-pp`): -`bat {{path/to/file1 path/to/file2 ...}} >> {{path/to/target_file}}` +`bat --style plain --pager never {{path/to/file}}` -- Number all output lines: +- Highlight a specific line or a range of lines with a different background color: -`bat --number {{path/to/file}}` +`bat {{--highlight-line|-H}} {{10|5:10|:10|10:|10:+5}} {{path/to/file}}` -- Syntax highlight a JSON file: +- Show non-printable characters like space, tab or newline: -`bat --language json {{path/to/file.json}}` +`bat {{--show-all|-A}} {{path/to/file}}` + +- Remove all decorations except line numbers in the output: + +`bat {{--number|-n}} {{path/to/file}}` + +- Syntax highlight a JSON file by explicitly setting the language: + +`bat {{--language|-l}} json {{path/to/file.json}}` - Display all supported languages: -`bat --list-languages` +`bat {{--list-languages|-L}}`