![]() | ![]() | Building Debian Packages with darcs-buildpackage | ![]() |
---|
You will need to import sources into your darcs-buildpackage archive on several different occasions:
You have existing Debian packages that you would like to maintain with darcs-buildpackage. In this case, you'll want to import one or more full Debian source packages with dbp-importdsc.
You want to package some previously-unpackaged software for Debian. In this case, you'll want to import an upstream tarball with dbp-importorig.
You want to update your Debian package with a new version of upstream source. This case also calls for dbp-importorig.
You want to import Debian sources from someone else (for instance, if someone NMU's a package you maintain) into your tree. dbp-importdsc can handle that.
There are two different programs that handle importing: dbp-importdsc and dbp-importorig. Both are covered in this chapter.
Importing a package is very easy. All you have to do is run dbp-importdsc with the name of a .dsc file to import:
$ dbp-importdsc ~/dpkg/rdiff-backup_0.12.3-1.dsc FIXME: show output
In this example, I had never imported rdiff-backup before. dbp-importdsc therefore initialized the repository for me. It then added and committed the upstream version (the first commit message), committed the Debian diffs (second commit), and noted which version in the archive corresponds to 0.12.3 and 0.12.3-1 (third commit message). (FIXME: these are probably old)
I can run it again with a new version:
$ dbp-importdsc ~/dpkg/rdiff-backup_0.12.5-1.dsc FIXME: show output
dbp-importdsc is smart enough to know not to import an upstream version twice. For instance, if I would now load 0.12.5-2, there would be only two commits: a patch-3 on the Debian tree and a patch-5 on the configs tree. (FIXME: these names are for arch)
dbp-importdsc has a few restrictions: you must always load packages in ascending order of package version. Please see dbp-importdsc(1) for more details.
While dbp-importdsc can solve many problems, sometimes you need to import just upstream sources (the Debian orig.tar.gz file). For this task, dbp-importorig exists. You will often use it if you have already loaded all the Debian versions into your archive, upstream has released a new version, and you want to package that version.
Using dbp-importorig is simple and straightforward; please refer to dbp-importorig(1) for more details.
<<< Getting Started | Common Tasks >>> |