![]() | ![]() | Building Debian Packages with darcs-buildpackage | ![]() |
---|
Welcome to darcs-buildpackage, a system that integrates the Debian package build system with Darcs.
darcs-buildpackage is designed to do this for you:
Ability to track changes to both upstream and Debian sources through time
Ability to retrieve any version of the sources from the archive, and build Debian binary and source packages from them.
Generated packages can be built and used by people that have neither Darcs nor darcs-buildpackage installed.
Provide an alternative to systems like dbs and dpatch to help manage patches that Debian applies to packages.
Provide a way to ease collaboration between multiple Debian developers on a single package.
Provide a way to use the merging (update and replay) features of Darcs to help merge Debian changes into new versions of upstream packages.
Make it easy to try darcs-buildpackage and switch back to normal systems if you don't like it.
darcs-buildpackage has these features:
dbp-importdsc will import an entire Debian source package into your Darcs area, handling both upstream and Debian trees automatically. dbp-importdsc can be run repeatedly to import newer versions, maintaining a full change history as it goes along.
dbp-importorig can import an upstream tar.gz or a directory into your archive with a single command.
darcs-buildpackage can use an existing orig.tar.gz, or can build you one from the Darcs archive if necessary.
darcs-buildpackage works for both Debian-native and normal (upstream) packages.
darcs-buildpackage ensures that Darcs metadata (the _darcs directory) doesn't show up in tar.gz or diff.gz files.
Tight integration with darcs_load_dirs for intelligent handling and versioning of file renames upstream.
Autosensing of information wherever possible from Debian changelogs, dsc files, and the darcs environment.
dbp-markdeb can be used to easily checkpoint development into Darcs.
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.
<<< Building Debian Packages with darcs-buildpackage | Getting Started >>> |