.TH "BATDIFF" 1
.SH NAME
batdiff - Diff a file against the current git index, or display the diff between two files.
.SH DESCRIPTION
.P
This script supports using delta as an alternative highlighter for diffs.
.SH "USAGE"
.P
    batdiff [OPTIONS] FILE
.br
    batdiff [OPTIONS] FILE OTHER_FILE
.br
    batdiff --staged
.SH "ENVIRONMENT"
.TS
tab(|) box;
| cB | cB |
| _ | _ |
| l0 |1 l |.
 Variable | Description 
|
.SP
 \fR\fIBATDIFF_USE_DELTA=true\fR | If \fR\fIdelta\fR is installed, use \fR\fIdelta\fR by default. 
.TE

.SH "OPTIONS"
.TS
tab(|) box;
| cB | cB | cB |
| _ | _ | _ |
| l0 |1 l |.
 Short | Long | Description 
||
.SP
 \fR\fI-C\fR | \fR\fI--context=[LINES]\fR | The number of lines to show before and after the differing lines. 
  | \fR\fI--delta\fR | Display diffs using \fR\fIdelta\fR. 
  | \fR\fI--color\fR | Force color output. 
  | \fR\fI--no-color\fR | Force disable color output. 
  | \fR\fI--paging=["never"/"always"]\fR | Enable/disable paging. 
  | \fR\fI--pager=[PAGER]\fR | Specify the pager to use. 
  | \fR\fI--terminal-width=[COLS]\fR | Generate output for the specified terminal width. 
  | \fR\fI--staged\fR | Show staged changes. 
.TE

.SH "CAVEATS"
.P
\fR\fBWhen using \fR\fB\fIbat\fR\fB as the printer:\fR
.P
- Syntax highlighting in diffs between two files is not supported.
.br
- Syntax highlighting in a single-file diff requires \fR\fIbat\fR >= 0.15.
.P
\fR\fBWhen using \fR\fB\fIdelta\fR\fB as the printer:\fR
.P
- The \fR\fI--no-color\fR option does not remove all color output.