Skip to content
Jonas Bernoulli edited this page Oct 2, 2013 · 37 revisions

Also see the FAQ and the list of all outstanding issues.

There should be a new release

Definitely, soon. But the issues in the following milestones have to be addressed first: a, b. We will enter feature freeze soonish.

Marmalade package

If you are using the development version of Emacs you have to also use the development version of Magit by either using Melpa or installing Magit from git. This is due to an incompatible change in delete-directory in Emacs-bzr.

New Commit Workflow

The main benefit of the new workflow is that we can avoid duplicating functionality available from git. But unfortunately it only works when Emacsclient knows how to connect to the Emacs server. Also some features of the old commit mode have not yet made their way to the new mode.

The old workflow might be partially restored by offering vc-git-log-edit as an option. Nothing decided yet.

Commit mode and emacsclient

Magit recently switched from magit-log-edit-mode to git-commit-mode to edit commit messages. This caused a few problems, and these issues are being investigated and addressed.

Creating a commit opens a new Emacs instance

That is what happens when everything else fails, it's the fallback we added as last resort, so that you can at least finish the commit.

On GNU/Linux and the BSDs finding the emacsclient executable usually works without any problems. Unfortunately it is possible to install Emacs on OS X and Windows in a usable fashion without actually placing the emacs and emacsclient executables on $PATH. We have added various hacks to deal with such breakage.

Since you are reading this, it appears we missed yet another special case. To quickly work around this locate the executable manually and set magit-emacsclient-executable accordingly. But please also inform as about the specifics of your installation, so that we can add a fix for other users who have installed Emacs in a similar fashion.

Commit popup

The command used to initiate a commit (c) is now a popup like other major commands. This was done for consistency with the rest of Magit and because it is no longer possible to turn on --amend while editing the message. Some people who have initially complained about this eventually come to prefer the new way; hang in there once you have unlearned the old key bindings you might like the change too.

Commit mechanism blocks some other operation

This will be fixed. Doing so involves addressing the oldest open issue, and there is a reason that has been open for so long. It is still possible to display a diff while editing the message but it is not possible to e.g. edit two commit messages in different repositories at the same time.

Toggling --amend on and off while editing message is no longer possible

This change will not be reverted. It makes little sense to do that while editing the commit message. One reason for that is that one doesn't get the old message when turning on amending while already in the message buffer.

Also doing so is actually impossible with the new commit workflow. --amend now has to be toggled in the commit popup or using a prefix argument to magit-commit.

Recently removed options

Option magit-status-insert-tags-line

This option is no longer required. To disable showing the tags in the status buffer remove hook function magit-insert-status-tags-line from hook variable magit-status-insert-sections-hook, either using the Custom interface, or by adding this to you init file:

(remove-hook 'magit-status-insert-sections-hook
             'magit-insert-status-tags-line)

Ps: You may also reorder the functions on this hook to change the order of sections in the status buffer.