From c6553f08af18f3b9a0a512036400c2329695f0c2 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Tue, 8 Mar 2011 19:35:39 -0400 Subject: [PATCH] add README.source --- debian/README.source | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 debian/README.source diff --git a/debian/README.source b/debian/README.source new file mode 100644 index 00000000..8a707372 --- /dev/null +++ b/debian/README.source @@ -0,0 +1,36 @@ +Building syncevolution for Debian +--------------------------------- + +The source package needs no special instructions; the discussion here +is about working with the git repository. + +Patches are exported based on debian/source/git-patches; each line is +an argument to git-format-patch. The variables $DEB_VERSION and +$UPSTREAM_VERSION are the Debian and upstream version being exported. +You can either use git-format-patch manually, or install gitpkg +version 0.17 or later. + +1) To have the patches automatically exported at source package creation time + + a) to setup gitpkg, run + + % git config gitpkg.deb-export-hook /usr/share/gitpkg/hooks/quilt-patches-deb-export-hook + + b) run + + % gitpkg master + + to make a source package. + +2) To manually export patches, run + + % ./debian/rules export-patches + +The original source tarballs are stored in the git repo using +pristine-tar. You can (optionally) check out the current tarball by + + git branch pristine-tar origin/pristine-tar + # UPSTREAM should be the current upstream version + pristine-tar checkout ../syncevolution_$(UPSTREAM).orig.tar.gz + + -- David Bremner , Tue, 8 Mar 2011 19:34:24 -0400