Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

 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.

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:
.. _Bitbucket:
.. _original:

.. Local Variables:
.. mode: rst
.. End:

Recent activity

Glenn Hutchings

Commits by Glenn Hutchings were pushed to zondo/ditz-mode

7d6db37 - Bind 'o' to delete-other-windows.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.