Differences between revisions 54 and 57 (spanning 3 versions)
Revision 54 as of 2009-05-24 07:01:43
Size: 4104
Editor: ?ReinhardTartler
Comment: link to git-buildpackage documentation
Revision 57 as of 2009-05-27 20:15:16
Size: 7498
Editor: ?ReinhardTartler
Comment: rewrite section how to integrate new package to git.debian.org
Deletions are marked like this. Additions are marked like this.
Line 51: Line 51:
== Work with git for newbies == == Proposing new packages for pkg-multimedia ==
Line 53: Line 53:
=== Creating new project git repository ===  * Don't bother with git for packaging new software. Instead, package it properly following DebianPolicy and the [[ http://www.debian.org/doc/developers-reference/ | DevelopersReference ]].
Line 55: Line 55:
$ ssh <user>@git.debian.org  * If you are confident with your package, propose it for review on the pkg-multimedia-maintainers mailing list. Link to your package preferably in a way that can be easily used with [[dget]].

 * Members of the team will then review your package and give you hints how to improve it. If the package is "good enough" (at the reviewer's discretion), he will setup a repository on git.debian.org and integrate your package while preserving attribution.

== Working on existing packages with git for newbies ==

  * We generally follow the workflow and defaults of [[ http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.html | git-buildpackage ]]

 * locate the packaging branch on http://git.debian.org. All pkg-multimedia branches have pkg-multimedia in their url. Click on the leftmost link in that line. That will bring you to the summary of the project.

 * Note the metadata just above the shortlog, it contains 2 URLs, one of
   them starting with `git://`

 * then [[ http://www.kernel.org/pub/software/scm/git/docs/git-clone.html | git-clone(1) ]] to get a copy of the repository. E.g.

{{{
git clone git://git.debian.org/pkg-multimedia/jack-audio-connection-kit.git
}}}

 * Do changes to that branch, build the package, test your changes, and commit early and often!

 * If someone else has committed while you are working on the branch, you need to integrate his changes. For this you have 2 options:

   * if your local changes are rather minor and clean, use git rebase:

{{{
git fetch origin
git rebase origin/master
}}}

  * if you rather don't want to break your history because you think that your changes are rather large and are likely to interfere with the other changes, better merge them with [[ http://www.kernel.org/pub/software/scm/git/docs/git-pull.html | git-pull(1) ]]:

{{{
git pull origin
}}}

 * In case you want to cleanup your local commits before pushing, use [[ http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html | git-rebase(1) ]]:

{{{
git rebase -i origin/master
}}}

   You will be presented a textfile where you can specify what of your local commits you want to modify, drop or squish (merge with the previous one). You can also improve your commit message here.

   Make sure that you don't rewrite already published commits.

 * In order to get comments on your (preferably cleaned up) commits, use [[ http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html | git-format-patch(1) ]] to generate patches of your commits and email them to the mailing list. Any committer can do this while preserving attribution.

 * None of the steps above require membership in the pkg-multimedia alioth group. All of that can be done totally anonymously!

== Tasks for team members ==

=== Uploading proposed package to the team git repository ===

 * First create a repository on git.debian.org:

{{{
$ ssh git.debian.org
Line 60: Line 117:

<user> ''your alioth account user name''
}}}
Line 64: Line 120:
=== Uploading your project to git repository ===  * Then import the sources locally, register the remote archive and push your commits (i.e. upload changes) with the following commands:
Line 66: Line 122:
{{{
Line 68: Line 125:
$ git-import-dsc <project>_0.0.1-1.dsc $ bash # start new subshell for safely modifying variables

$ export GIT_AUTHOR_NAME="Proposers Name"

$ export GIT_AUTHOR_EMAIL="Proposers email"

$ git-import-dsc --prstine-tar <project>_0.0.1-1.dsc
Line 72: Line 135:
$ git remote add alioth ssh://<user>@git.debian.org/git/pkg-multimedia/<project>.git $ git remote add alioth ssh://user@git.debian.org/git/pkg-multimedia/<project>.git
Line 78: Line 141:
$ git push alioth pristine-tar

$ git push alioth
Line 79: Line 146:

$ exit # temporary subshell
}}}

DebianMultimedia


This page contains information already on other pages.
Help is welcome to remove the duplicate parts,
and to update or remove the obsolete parts.
No need to ask before editing.

This page thanks to great work from ?TimHall, shamelessly re-used by dancerj, updated by billitch.

Packages maintained by the Debian Multimedia Team

Here you can find a list of packages maintained by the Debian Multimedia Team:

http://qa.debian.org/developer.php?login=debian-multimedia@lists.debian.org

http://qa.debian.org/developer.php?login=pkg-multimedia-maintainers@lists.alioth.debian.org

New packages should set the Maintainer field to Debian Multimedia Maintainers <pkg-multimedia-maintainers@lists.alioth.debian.org>. Existing packages should move to using that address on a best-effort basis.

All source packages shoud use the pkg-multimedia git area in alioth.

How to help with packaging

The Debian Multimedia Maintainers need help to create new Debian packages and maintain the existing ones. If you want to contribute to this effort, but you are new to the Debian packaging systems, here follows some information to get you started.

Packaging guidelines

  • Packages should use git, as mentioned above. Desirable is being able to use git-buildpackage.
  • Upstream sources should be kept in the upstream branch and the the debian packaging in the master branch.

  • Quilt should be used for patch management, and the master branch should only differ from the upstream branch in files inside the debian/ directory. This means no direct changes to the source in the master branch.

  • The maintainer field should be set to Debian Multimedia Maintainers <pkg-multimedia-maintainers@lists.alioth.debian.org>

  • The git repository should be hosted in alioth, under the pkg-multimedia project. It should forward commit messages to pkg-multimedia-commits@lists.alioth.debian.org and package_cvs@packages.qa.debian.org

    • You can use the setup-repository script in /git/pkg-multimedia to create the bare repository with commit messages enabled. The repository should be named as the source package name for the message forwarding to work (eg, the repository for source package liblo is named liblo.git).
  • The control file should use the Vcs-Git and Vcs-Browser tags.

Workflow guidelines

  • One change per commit. This is very important, it eases review, cherry picking, bisecting (and thus debugging) and backporting.

  • Do not commit the debian changelog along with the changes. It makes cherry picking and backporting changes easier. The changelog is generated with git-dch at the time of upload.
  • After each upload, the first commit should be creating a new changelog entry, to ease testing of unreleased packages.

Documentation

Proposing new packages for pkg-multimedia

  • Don't bother with git for packaging new software. Instead, package it properly following DebianPolicy and the DevelopersReference.

  • If you are confident with your package, propose it for review on the pkg-multimedia-maintainers mailing list. Link to your package preferably in a way that can be easily used with ?dget.

  • Members of the team will then review your package and give you hints how to improve it. If the package is "good enough" (at the reviewer's discretion), he will setup a repository on git.debian.org and integrate your package while preserving attribution.

Working on existing packages with git for newbies

  • locate the packaging branch on http://git.debian.org. All pkg-multimedia branches have pkg-multimedia in their url. Click on the leftmost link in that line. That will bring you to the summary of the project.

  • Note the metadata just above the shortlog, it contains 2 URLs, one of
    • them starting with git://

  • then git-clone(1) to get a copy of the repository. E.g.

git clone git://git.debian.org/pkg-multimedia/jack-audio-connection-kit.git
  • Do changes to that branch, build the package, test your changes, and commit early and often!
  • If someone else has committed while you are working on the branch, you need to integrate his changes. For this you have 2 options:
    • if your local changes are rather minor and clean, use git rebase:

git fetch origin
git rebase origin/master
  • if you rather don't want to break your history because you think that your changes are rather large and are likely to interfere with the other changes, better merge them with git-pull(1):

git pull origin
  • In case you want to cleanup your local commits before pushing, use git-rebase(1):

git rebase -i origin/master
  • You will be presented a textfile where you can specify what of your local commits you want to modify, drop or squish (merge with the previous one). You can also improve your commit message here. Make sure that you don't rewrite already published commits.
  • In order to get comments on your (preferably cleaned up) commits, use git-format-patch(1) to generate patches of your commits and email them to the mailing list. Any committer can do this while preserving attribution.

  • None of the steps above require membership in the pkg-multimedia alioth group. All of that can be done totally anonymously!

Tasks for team members

Uploading proposed package to the team git repository

  • First create a repository on git.debian.org:

$ ssh git.debian.org

$ cd /git/pkg-multimedia

$ ./setup-repository <project>
  • Then import the sources locally, register the remote archive and push your commits (i.e. upload changes) with the following commands:

$ cd /path/to/sources/

$ bash # start new subshell for safely modifying variables

$ export GIT_AUTHOR_NAME="Proposers Name"

$ export GIT_AUTHOR_EMAIL="Proposers email"

$ git-import-dsc --prstine-tar <project>_0.0.1-1.dsc

$ cd <project>

$ git remote add alioth ssh://user@git.debian.org/git/pkg-multimedia/<project>.git

$ git push alioth master

$ git push alioth upstream

$ git push alioth pristine-tar

$ git push alioth

$ git push alioth --tags

$ exit # temporary subshell


Work in progress : We're checking all the WNPP bugs and updating infos on this page.


CategorySound