653b465c74
Redesign this hook around `after-focus-change-function`, along with
debouncing, to prevent it from triggering too aggressively (due to
misbehaving desktop environments, elisp packages that tinker with frame
focus, or accidental (and rapid) focus changes by the user).
`doom-switch-{window,buffer}-hook` have also been simplified, and
`doom-switch-window-hook` now will not trigger when focusing another
frame (only when you switch windows *within* any one frame).
This also fixes diff-hl not updating when refocusing an Emacs frame.
:tools magit
Description unfold
This module provides Magit, an interface to the Git version control system.
Maintainers
Module flags
- +forge
-
Enable Forge; a porcelain for managing Github issues and PRs from within
Emacs. Will take a while on first run to build
emacsql-sqlite.
Packages
- doom-package:evil-magit if doom-module::editor evil +everywhere
- doom-package:forge if doom-module:+forge
- doom-package:code-review if doom-module:+forge
- doom-package:magit
Hacks
- doom-package:magit has been modified to recognize
$XDG_CACHE_HOME/git/credential/socket. - doom-package:magit has been modified to invalidate the projectile cache when you check out a new branch or commit.
- doom-package:magit has been modified to revert repo buffers (e.g. after changing branches) when you later switch to them, rather than all at once.
- doom-package:forge was modified to defer compilation of emacsql-sqlite until you try to use forge, rather than when magit first loads (which could be as soon as startup).
TODO Changelog
This module does not have a changelog yet.
Installation
Enable this module in your doom! block.
This module requires:
- Git
- doom-module:+forge requires a Github API token
- doom-package:code-review will also require a token setup (see configuration for your particular forge)
TODO Usage
This module's usage documentation is incomplete. Complete it?
Start magit with <leader> g g (M-x magit-status).
If you are new to Magit, see the Getting Started section of its project readme.
TODO Configuration
This module's configuration documentation is incomplete. Complete it?
Enable Gravatars
To enable gravatars when viewing commits:
;; in $DOOMDIR/config.el
(after! magit
(setq magit-revision-show-gravatars '("^Author: " . "^Commit: ")))Enable granular diff-highlights for all hunks
By default, changes are highlighted linewise for all but the selected hunk. This is so for performance reasons. You can enable character-wise highlights for all visible hunks with:
;; in $DOOMDIR/config.el
(after! magit
(setq magit-diff-refine-hunk 'all))Troubleshooting
There are no known problems with this module. Report one?
Frequently asked questions
"I recently updated and now I get 'deferred error : (wrong-type-argument sequencep code-review–auth-token-set\?)' whenever I try to review'"
The previous package "github-review" was replaced with a package that supercedes it called "code-review", which requires a simple change in your authinfo file.
machine api.github.com login yourlogin^github-review password MYTOKENGOESHEREbecomes
machine api.github.com login yourlogin^code-review password MYTOKENGOESHERETODO Appendix
This module has no appendix yet. Write one?