History

Henrik Lissner 1eb3fd3449 bump: :ui Alexander-Miller/treemacs@76807bef3c -> Alexander-Miller/treemacs@9986d6cd3d Bad-ptr/persp-mode.el@7a594a3d8f -> Bad-ptr/persp-mode.el@df95ea710e abo-abo/ace-window@0577c426a9 -> abo-abo/ace-window@77115afc1b abo-abo/hydra@9e9e00cb24 -> abo-abo/hydra@317e1de330 dgutov/diff-hl@dabb7be628 -> dgutov/diff-hl@d20f16bf5e dimitri/switch-window@8d9fe251d8 -> dimitri/switch-window@71ef2f54c9 ema2159/centaur-tabs@f4cef95acb -> ema2159/centaur-tabs@a2890d968d emacs-lsp/lsp-treemacs@2894e6dec5 -> emacs-lsp/lsp-treemacs@a48763ba5d joostkremers/writeroom-mode@eac1da790f -> joostkremers/writeroom-mode@1fd52848eb k-talo/volatile-highlights.el@9a20091f0c -> k-talo/volatile-highlights.el@513c8b73cd rolandwalker/nav-flash@2e31f32085 -> rolandwalker/nav-flash@5d4b485678 rolandwalker/unicode-fonts@47f2397ade -> rolandwalker/unicode-fonts@44d0a22420 seagle0128/doom-modeline@b66d5e5006 -> seagle0128/doom-modeline@6125309c2c tarsius/hl-todo@e52285965b -> tarsius/hl-todo@a627d33214		2023-02-20 22:47:23 -05:00
..
autoload
config.el	fix(vc-gutter): add missing autoloads	2023-02-18 01:00:59 -05:00
packages.el	bump: :ui	2023-02-20 22:47:23 -05:00
README.org	docs: change link format	2022-10-05 01:01:19 +02:00

:ui vc-gutter

Description unfold

This module displays a diff of the current file (against HEAD) in the fringe. Supports Git, Svn, Hg, and Bzr.

+diff-hl: Use doom-package:diff-hl instead of git-gutter to power the VC gutter. It is a little faster, but is slightly more prone to visual glitching. doom-package:diff-hl is intended to replace git-gutter at some point in the future.
+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).

The VC gutter will be updated when pressing ESC, leaving insert mode (evil users), or refocusing the frame or window where it is active.
If doom-module:+pretty is enabled
- The fringes that both git-gutter-fringe and diff-hl define will be replaced with a set of thin bars. This achieves a slicker look closer to git-gutter's appearance in VSCode or Sublime Text, but may look weird for themes that swap their faces' :foreground and :background (like modus-themes).
- The fringes are moved to the outside of the margins (closest to the frame edge), so they have some breathing space away from the buffer's contents.
If doom-package:+diff-hl is enabled:
- diff-hl-revert-hunk displays a preview popup of the hunk being reverted. It takes up ~50% of the frame, by default, whether you're reverting 2 lines or 20. Since this isn't easily customized, it has been advised to shrink this popup to the side of its contents.
- diff-hl-revert-hunk will sometimes move the cursor to an unexpected location (the bounds of hunks, is my guess), but this is not intuitive and often unexpected. Cursor movements have been suppressed for it.
If +diff-hl is not enabled:
- Sometimes, git-gutter:next-hunk and git-gutter:previous-hunk get confused about the order of hunks. They have been advised to fix this (although the hack is a little inefficient).

This module does not have a changelog yet.

This module requires any of Git, Svn, Hg, and/or Bazaar to get gutter diffs in projects version controlled by them.

🔨 This module has no usage documentation yet. Write some?

🔨 This module has no configuration documentation yet. Write some?

There are no known problems with this module. Report one?

This module has no FAQs yet. Ask one?

🔨 This module has no appendix yet. Write one?