Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
88 lines (66 sloc) 3.04 KB
Ditz mode for GNU Emacs
About Ditz and Ditz mode
Ditz_ is a distributed issue tracking system, written in Ruby by William
Morgan, and designed for use with distributed version control systems such
as Mercurial_. Ditz mode is an editing mode for GNU Emacs_, allowing Ditz
commands to be run directly inside an Emacs buffer. You can find the
latest version of Ditz mode at Bitbucket_.
Ditz mode is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version. See the file ``COPYING`` for details.
Getting Started
Setting up Ditz mode
Put ``ditz-mode.el`` in your lisp load path and something like the
following in your ``.emacs``::
(require 'ditz-mode)
(define-key global-map "\C-c\C-d" ditz-prefix)
Setting up Ditz
At the moment, Ditz mode doesn't do the initial setup of Ditz. You must
run ``ditz init`` yourself to produce a ``.ditz-config`` file. Ditz mode
searches for this file, and reads it to get the name of the issue
directory. It looks first in the current directory, and then in parent
directories. Then it looks for the issue directory, first in the current
directory, and then in the directory where it found ``.ditz-config``.
Ditz mode also supports the commands defined in the ``issue-claiming``
plugin, if it's enabled. You'll have to enable the plugin yourself though,
as described in the Ditz documentation.
Using Ditz mode
Once things are set up, you can use ``C-c C-d`` (or whatever prefix you
chose) followed by ``C-h`` to get a list of valid commands. There's also a
menu containing all the Ditz commands, which is useful for checking out all
the bindings.
If you want to Ditz mode with PyDitz_ instead of Ditz, you can customize
the ``ditz-program`` variable.
Other contributed stuff
The ``contrib`` directory contains other Ditz-related files you may be
interested in:
A patch for Ditz which adds indicators to each issue, showing whether
it's a feature or a bug. Ditz mode highlights these specially, if
they're found.
A patch for Ditz which adds an optional count for the ``log`` and
``shortlog`` commands, to limit their output to that many entries.
A Ditz hook to automatically update version control status when issues
are added or removed. At the moment it supports Mercurial_, CVS and
Thanks to Kentaro Kuribayashi <>, author of the original_
Ditz mode. This is an almost (but not quite) complete rewrite.
.. _Ditz:
.. _Emacs:
.. _Mercurial:
.. _PyDitz:
.. _Bitbucket:
.. _original: