welcome: please sign in

Diff for "DebianPackaging"

Differences between revisions 1 and 31 (spanning 30 versions)
Revision 1 as of 2008-01-15 02:56:52
Size: 3795
Editor: MichaelOlson
Comment: Rough initial contents
Revision 31 as of 2008-12-13 03:14:18
Size: 258
Editor: 170
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This page describes how to make custom Debian packages for HCoop.

[[TableOfContents()]]

= Making a new custom package =

If you want to make changes to an existing Debian package, and we haven't
made our own custom package before, then do the following.

{{{
mkdir -p /afs/hcoop.net/common/debian/<pkg>/<upstream-version>
cd /afs/hcoop.net/common/debian/<pkg>/<upstream-version>
# Browse http://packages.debian.org/<pkg> and find a link to a dsc file
dget -x http://path/to/file.dsc
# Or if you already have the .dsc, .diff.gz, and orig tarball downloaded,
# then do dpkg-source -x path/to/file.dsc instead.
git-import-dsc --debian-branch=debian <pkg>-<ver>.dsc
}}}

This last step creates a subdirectory named after the package. The subdirectory
has the complete source, including the {{{./debian}}} directory. The original
tarball (without {{{./debian}}}) is in the "upstream" branch, and the
original stuff plus Debian changes would be in the "debian" branch, and a copy of
the contents of the "debian" branch is placed in the "master" branch. You will
be in the "master" branch now.

Make your HCoop-specific changes (preferably in an incremental and atomic
fashion) and commit them using git.

= Building a package =

First, make sure you are on the "master" branch by running:

{{{
git branch -l
}}}

If you see an asterisk by "master", you're on the right branch.

If we want to build the package with some uncommitted changes, as a
sanity check, then do:

  git-buildpackage --git-ignore-new

When it comes time to test the changes, build the package using:

  git-buildpackage

The packages will be built and placed in the parent directory. To
indicate that we are done making changes to this particular version of
the Debian package, tag it with:

  git-buildpackage --git-tag

This makes the package version show up when you do "git tag -l", for
easy diffing and viewing.

= New package from Debian etch =

When a new Debian package comes out, and we want to incorporate their
changes, the routine would look something like this (untested):

  cd ..
  dget -x <URL to dsc file on packages.debian.org>
  cd <pkgname>
  git checkout debian
  export GIT_WORK_TREE=../<pkgname>-<ver>
  git add . ; git add -u .
  git commit -m "Import <pkgname>-<ver>"
  unset GIT_WORK_TREE
  rm -fr ../<pkgname>-<ver>
  git tag -a -m "<pkgname>-<ver>" debian/<pkgname>-<ver>
  git checkout master
  git rebase debian
  [fix any conflicts, particularly in debian/changelog]
  [use the git-commit command as hinted at by rebase, if conflicts
   need to be resolved]
  [make a new debian/changelog entry and list the changes that were kept
   in our version. this is how Ubuntu does it, but we could probably
   omit the list of changes, since we know exactly what changes we have
   made.]
  [commit, build packages, and tag as in the previous instructions]

The rebase command checks out the debian changes, and then replays our
changes on top, committing the result if there are no conflicts (or
printing the command to call after resolving conflicts, if conflicts
exist). This conceptually indicates that we want to stick close to
Debian's packaging, with a few necessary modifications for our setup.

A wrapper script would be handy to do much of the heavy lifting in the
first half of the above list. The work flow could then be:

  cd ..
  dget <URL to dsc file on packages.debian.org>
  cd <pkgname>
  git-import-new-dsc ../<pkgname-ver>.dsc
  [the above deduces the package name and version from the name of
   the dsc file]
  [fix any conflicts, particularly in debian/changelog]
  [continue with previous instructions ...]

= New upstream package not yet in Debian etch =

Write me.
<a href='http://clpatric.strefa.pl/bugbassed-1333.html'>custom neon signs</a> <a href="http://clpatric.strefa.pl/bugbassed-1333.html">custom neon signs</a> [link=http://clpatric.strefa.pl/bugbassed-1333.html]custom neon signs[/link]
----
CategoryCategory

DebianPackaging (last edited 2021-08-07 20:01:46 by ClintonEbadi)