There's quite a lot in this release, with contributions from 8 different people.

Firstly a breaking change: some deprecated options are no longer supported: in particular plus-color and minus-color. See https://github.com/dandavison/delta/pull/914. A description of this change and what you need to do if you're affected by it is below.

Secondly, improvements, including:

• A (much-needed) short help text is now available: use delta -h. Delta is the proud possessor of 100 command-line options, so I think this is going to be helpful.
• git blame output now displays line numbers (thanks to @th1000s)
• Improvements to file and mode labels by @WayneD
• delta now has a user manual: https://dandavison.github.io/delta/. You can even create a PDF copy (print button in upper-right hand corner), and the README is correspondingly now a much easier read with the minimal required setup instructions and an overview of functionality with screenshots.

Finally some bug fixes, including

• File path hyperlinks (e.g. in diff and grep output) were previously sometimes incorrect, especially when delta was invoked from a directory other than the repo root.
• Some fixes to grep output parsing edge cases

Deprecated options no longer supported:

The options affected here have been deprecated for a couple of years; I hope this doesn't cause you any trouble. Here are the details:

The most common case is that you have something like this in your ~/.gitconfig:

[delta]
    plus-color = my_plus_color
    minus-color = my_minus_color

Please change that to

[delta]
    plus-style = syntax my_plus_color
    minus-style = normal my_minus_color

Here's the list of deprecated options with a summary of how to update them:

minus-color             Deprecated: use `minus-style = normal my_background_color`
plus-color              Deprecated: Use `plus-style = syntax my_background_color`
minus-emph-color        Deprecated: use `minus-emph-style = normal my_background_color`
plus-emph-color         Deprecated: Use `plus-emph-style = syntax my_background_color`
highlight-removed       Deprecated: use `minus-style = syntax my_background_color`
commit-color            Deprecated: use `commit-style = my_foreground_color
                                         commit-decoration-style = my_foreground_color`
file-color              Deprecated: use `file-style = my_foreground_color
                                         file-decoration-style = my_foreground_color`
hunk-style              Deprecated: synonym of `hunk-header-decoration-style`
hunk-color              Deprecated: use `hunk-header-style = my_foreground_color
                                         hunk-header-decoration-style = my_foreground_color`
theme                   Deprecated: use `syntax-theme`

For full documentation, please see delta --help and https://dandavison.github.io/delta/configuration.html.

PRs

• Remove redundent spaces in README example by @TennyZhuang in https://github.com/dandavison/delta/pull/861
• Bump sysinfo from 0.22.2 to 0.22.3 by @dependabot in https://github.com/dandavison/delta/pull/862
• New option blame-code-style by @dandavison in https://github.com/dandavison/delta/pull/870
• Make formatted blame metadata determine color instead of commit by @dandavison in https://github.com/dandavison/delta/pull/871
• Put file-modified label in front of mode changes. by @WayneD in https://github.com/dandavison/delta/pull/874
• Speed up the calling process query by @th1000s in https://github.com/dandavison/delta/pull/869
• DeltaTest improvements by @WayneD in https://github.com/dandavison/delta/pull/876
• Make Config cloneable for DeltaTest, store as Cow<Config> there by @th1000s in https://github.com/dandavison/delta/pull/884
• Fix grep parse bugs by @dandavison in https://github.com/dandavison/delta/pull/865
• Handle a mode change on a renamed file. by @WayneD in https://github.com/dandavison/delta/pull/875
• New option file-transformation to transform file paths by @dandavison in https://github.com/dandavison/delta/pull/887
• Handle blame author names containing parentheses by @th1000s in https://github.com/dandavison/delta/pull/901
• Add OpenBSD installation note by @sizeofvoid in https://github.com/dandavison/delta/pull/894
• Create user manual by @dandavison in https://github.com/dandavison/delta/pull/882
• structopt to clap by @dandavison in https://github.com/dandavison/delta/pull/889
• Drop deprecated options by @dandavison in https://github.com/dandavison/delta/pull/914
• Add clap cosmetic argument names by @dandavison in https://github.com/dandavison/delta/pull/915
• Construct hyperlink file path relative to cwd by @dandavison in https://github.com/dandavison/delta/pull/898
• Bump clap from 3.0.5 to 3.0.7 by @dependabot in https://github.com/dandavison/delta/pull/917
• Cwd fixups by @dandavison in https://github.com/dandavison/delta/pull/918
• Center Align numbers right-ish by @th1000s in https://github.com/dandavison/delta/pull/883
• Blame line numbers by @th1000s in https://github.com/dandavison/delta/pull/885
• Update original mantis-shrimp, add lite version by @2KAbhishek in https://github.com/dandavison/delta/pull/934
• Update sysinfo version by @GuillaumeGomez in https://github.com/dandavison/delta/pull/921
• Update color-moved-support.md by @chtenb in https://github.com/dandavison/delta/pull/935
• Fix unused imports and functions warnings on windows by @th1000s in https://github.com/dandavison/delta/pull/950
• Fix hyperlink absolute paths by @dandavison in https://github.com/dandavison/delta/pull/939

New Contributors

• @TennyZhuang made their first contribution in https://github.com/dandavison/delta/pull/861
• @sizeofvoid made their first contribution in https://github.com/dandavison/delta/pull/894
• @GuillaumeGomez made their first contribution in https://github.com/dandavison/delta/pull/921
• @chtenb made their first contribution in https://github.com/dandavison/delta/pull/935

Full Changelog: https://github.com/dandavison/delta/compare/0.11.3...0.12.0