refactor!(vc-gutter): move style defaults behind +pretty

BREAKING CHANGE: This changes moves its default configuration of the
fringe behind a +pretty flag. This won't cause breakage, but will cause
a (possibly unwanted) visual change: git-gutter will use its default
indicators (e.g. + and - symbols) instead of the continuous bars from
before.

To get back the old look, enable `+pretty` on the `:ui vc-gutter`
module.

This was done to make the defaults toggleable, to standardize +pretty,
to document issues with this customization that have been brought up by
members of the Emacs community, and to better document it in comments
for posterity.
This commit is contained in:
Henrik Lissner 2022-08-08 17:36:23 +02:00
parent 232e9d4b91
commit cd9bc5a1fd
No known key found for this signature in database
GPG key ID: B60957CA074D39A3
3 changed files with 41 additions and 2 deletions

View file

@ -13,7 +13,13 @@ Supports Git, Svn, Hg, and Bzr.
[[doom-contrib-maintainer:][Become a maintainer?]]
** Module flags
/This module has no flags./
- +pretty ::
Apply some stylistic defaults to the fringe, enabling thin bars in the fringe.
This look takes after the modern look of git-gutter in VSCode and Sublime
Text, without sacrificing on fringe width (which squeeze other indicators,
like flycheck's, flymake's, or flyspell's). However, this will look bad with
themes that invert the foreground/background of either git-gutter's or
diff-hl's faces (like modus-themes does).
** Packages
- [[doom-package:][git-gutter-fringe]]