Introduction

Table of Contents
Purpose
Features
Usage Overview

Welcome to darcs-buildpackage, a system that integrates the Debian package build system with Darcs.


Purpose

darcs-buildpackage is designed to do this for you:


Features

darcs-buildpackage has these features:


Usage Overview

Here is a high-level overview of the Debian development process using darcs-buildpackage.

You'll start by creating your ~/.darcs-buildpackage configuration file and making a directory to store your Darcs repositories, if you don't already have one.

Next, it's time to bring your packages into Darcs. If you have some existing Debian packages, you'll import as much history as you like by using dbp-importdsc. Otherwise, to start a new package in darcs-buildpackage, you'll use dbp-importorig to bring in the upstream sources. Then, you'll use darcs get to copy the upstream area to the Debian area.

As you work on your Debian sources, you'll use darcs-buildpackage in place of debuild or dpkg-buildpackage (darcs-buildpackage passes all its arguments to debuild for you). You can use standard Darcs commands, such as darcs record or darcs changes, to commit changes and view history. When you have a final version of a Debian package, you'll upload it and run dbp-markdeb to tag the version for future reference.