> == Link to magit from org documents ==
> The [https://github.com/sigma/org-magit org-magit] package provides a link type to magit for OrgMode.
Magit is an emacs mode for interacting with the Git version control system. It’s written by MariusVollmer, of GNU/Guile fame. PhilJackson took over as maintainer for quite some time, and now Magit is collectively maintained by YannHodique, RemiVanicat? and PeterWeisberg?.
Getting started with Magit is really easy:
Other handy keys:
After you are hooked check the info manual, it’s not that big.
Version 0.7 (March 2009) of Magit (the version in Debian Squeeze) didn’t support TRAMP. Somewhere between there and 1.0 (March 2011) TRAMP support was added. February-August 2009 Ian Eure maintained a fork (github) that added support for TRAMP. Since more recent versions of the official Magit, you should use that. You still see some references to Ian’s version around the net, they can be ignored.
Had to change magit-escape-for-shell to:
(defun magit-escape-for-shell (str) (if (or (string= str "git") (string-match "^--" str)) str (concat "'" (replace-regexp-in-string "'" "'\\''" str) "'")))
To make it work on windows. – RodrigoWanderley
mo-git-blame is a great addition as a frontend for git blame (which magit currently does not provide)
Update: magit does provide a blame mode called
Don’t really like the highlights on diff mode… Made it optional using:
(defcustom magit-use-highlights nil "Use highlights in diff buffer." :group 'magit :type 'boolean)
And then changed magit-highlight-section as follows:
(defun magit-highlight-section () (let ((section (magit-current-section))) - (when (not (eq section magit-highlighted-section)) + (when (and (not (eq section magit-highlighted-section)) + magit-use-highlights)
A more future-proof solution would be to customize magit-item-highlight face to make it stand out less. These settings look ok-ish with Emacs 24 and the tango-dark theme:
(eval-after-load "magit" '(set-face-attribute 'magit-item-highlight nil :foreground "#ffffff" :background "#3f4747"))
Or you can simply override magit-highlight-section with an empty implementation:
(eval-after-load "magit" ;; no highlight (defun magit-highlight-section ())
– Li Feng
If you are using Emacs 24.4 on Linux with inotify support then you can get the status buffer to automatically update on file changes by loading the file magit-inotify.el from
contrib/ (https://github.com/magit/magit/blob/master/contrib/magit-inotify.el) and activating the
magit-inotify-mode minor mode.