Next: , Previous: Quick Start, Up: Quick Start


3.1 Setting up Patcher

The first thing to do is to make patcher aware of your “SuperProj” project. Put this in your .emacs file:

     (setq patcher-projects
             '(("SuperProj" "/home/me/superproj"
             :to-address "superproj-devel@superproj.org"
             :commit-privilege t
             :themes (git))))

As you can imagine, patcher-projects is a user option in which you store information about the projects you want to manage with Patcher. It is actually a list of what's called project descriptors. Here's the meaning of the only project descriptor we have in the example above: we have a project named “SuperProj”, located in /home/me/superproj and for which emails should be sent to superproj-devel@superproj.org. In addition to that, this project is handled by Git.

Note the particular syntax for specifying the mailing address. This is what's called a project option. Contrary to the project's name and directory, which are mandatory and always appear as the first and second elements of a project descriptor, project options are optional and can appear in any order. Note also that we have used a :themes option for specifying the revision control system in use. A “theme” is a set of options with particular values. Patcher happens to come with some predefined themes, including one for Git.