Skip to content

Latest commit

 

History

History
98 lines (77 loc) · 3.63 KB

README.org

File metadata and controls

98 lines (77 loc) · 3.63 KB

:tools magit

Description

This module provides Magit, an interface to the Git version control system.

Maintainers

  • @hlissner

Become a maintainer?

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).

Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module requires:

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.

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 MYTOKENGOESHERE

becomes

machine api.github.com login yourlogin^code-review password MYTOKENGOESHERE

Appendix

󱌣 This module has no appendix yet. Write one?