pkg-kde git quick guide
As of the end of August 2010, KDE packages are maintained in git and few kde-extras packages maintained in git.
To obtain a list of these packages, please see the pkg-kde git index.
If you do not have write acces to the remote git repository you only need to execute:
git clone git://git.debian.org/BRANCH_PATH
where BRANCH_PATH is the path to the branch given on the git index. For example, to fetch the pkg-kde/kde-extras/bangarang.git branch, you would run:
git clone git://git.debian.org/pkg-kde/kde-extras/bangarang.git
If you have write permissions in the repository, you can download a copy with this order:
git clone git+ssh://YOUR-ALIOTH-USERNAME@git.debian.org/git/BRANCH_PATH
You need to replace YOUR-ALIOTH-USERNAME with your login name (user or user-guest) and BRANCH_PATH with the appropriate path, as described above.Don't forget to read the git guidelines.
Creating a packaging branch
ssh to git.debian.org and cd to /git/pkg-kde/ or an appropriate subfolder thereof, like /git/pkg-kde/kde-extras. Then run:
This will setup the branch with commit hooks that will send commit mail to the pkg-kde-commits mailing list and to firstname.lastname@example.org.
You can then procede to import the upstream tarball as described below and start adding your packaging, or you can import an existing source package, replacing the text in capitals as required. The BRANCH_PATH of the fresh repository is pkg-kde/sourcepackagename.git, or, if you chose a subfolder, something like pkg-kde/kde-extras/sourcepackagename.git.
cd /path/to/debian/sources git-import-orig PACKAGE_VERSION.dsc cd PACKAGE git remote add origin git+ssh://YOUR-ALIOTH-USERNAME@git.debian.org/git/BRANCH_PATH git push origin master upstream pristine-tar --tags
Using the packaging branch
Upstream tarballs are nearly always stored in the pristine-tar branch and upstream code in the upstream branch.
After cloning the remote repository, you'll need to checkout these branches in order to access them:
git checkout --track origin/pristine-tar git checkout --track origin/upstream
Importing a new upstream release
To import a new upstream tarball, run:
git-import-orig --pristine-tar [-u version] /path/to/upstream-version.tar.gz
You can find more information on how to use git with packaging branches here on the Debian wiki.
You can also browse the repository using your web browser by visiting the pkg-kde git index.