diff options
author | Axel Beckert <abe@deuxchevaux.org> | 2015-04-28 23:16:41 +0200 |
---|---|---|
committer | Axel Beckert <abe@deuxchevaux.org> | 2015-04-28 23:16:41 +0200 |
commit | 1e841579629865b404ac155b274e298b07f756ca (patch) | |
tree | edcdab00577c8cfa16897509c19de4c33d8b2663 | |
parent | b4c17e7c69f7b334f22dbe3ee0d3857045cf5667 (diff) | |
download | zsh-1e841579629865b404ac155b274e298b07f756ca.tar.gz zsh-1e841579629865b404ac155b274e298b07f756ca.zip |
Use "gbp dch" instead of "git-dch" in helper scripts and package build docs
git-dch is history as of git-buildpackage 0.6.24.
-rwxr-xr-x | debian/bin/do-dch | 6 | ||||
-rwxr-xr-x | debian/bin/urcl | 4 | ||||
-rw-r--r-- | debian/gbp.conf | 4 | ||||
-rw-r--r-- | debian/pkg-zsh-workflow.md | 33 |
4 files changed, 24 insertions, 23 deletions
diff --git a/debian/bin/do-dch b/debian/bin/do-dch index f07b9bd41..da40d6bcb 100755 --- a/debian/bin/do-dch +++ b/debian/bin/do-dch @@ -1,7 +1,7 @@ #!/bin/sh -# This runs git-dch with appropriate options. +# This runs "gbp dch" with appropriate options. # -# All given options are handed over to git-dch without tampering. You +# All given options are handed over to "gbp dch" without tampering. You # should probably give a --since="..." definition, so the program knows # were to start. Also, when you're planning on a release, pass `-R'. For # snapshots, use `-S'. @@ -11,7 +11,7 @@ # # At the end an editor is spawned on debian/changelog no matter what. -git-dch \ +gbp dch \ --spawn-editor=never \ "$@" diff --git a/debian/bin/urcl b/debian/bin/urcl index 0ad1f1393..8bfd8926f 100755 --- a/debian/bin/urcl +++ b/debian/bin/urcl @@ -1,11 +1,11 @@ #!/bin/sh # -# Seems like `git-dch' doesn't work well with non-linear histories. With +# Seems like `gbp dch' doesn't work well with non-linear histories. With # pkg-zsh we do have merges everytime an upstream release is done. That's # where "Upstream Release ChangeLog" comes into play. It takes a set of # commit hashes and produces an initial changelog update for those # situations in which an upstream release tag was merged. After that, -# the situation can be reduced to a linear history again and `git-dch' +# the situation can be reduced to a linear history again and `gbp dch' # will do just fine. # # This script is pretty dumb, so some manual adjustments might be needed diff --git a/debian/gbp.conf b/debian/gbp.conf index bc1dd705e..7b458d531 100644 --- a/debian/gbp.conf +++ b/debian/gbp.conf @@ -6,8 +6,8 @@ debian-branch = debian upstream-tag = zsh-%(version)s debian-tag = debian/%(version)s -# Options only affecting git-dch -[git-dch] +# Options only affecting "gbp dch" +[gbp-dch] id-length = 8 meta = True multimaint-merge = True diff --git a/debian/pkg-zsh-workflow.md b/debian/pkg-zsh-workflow.md index 1db83f229..be7d10626 100644 --- a/debian/pkg-zsh-workflow.md +++ b/debian/pkg-zsh-workflow.md @@ -173,8 +173,9 @@ should be tagged `debian/${zsh_version}-${n+1}`. ### Updating debian/changelog This file should *not* be updated manually. The changes should be -inserted by running the `git-dch` tool from the package -`git-buildpackage` before a new release is about to be made. +inserted by running the `gbp dch` command from the package +`git-buildpackage` (see gbp-dch(1)) before a new release is about to +be made. Changelog entries should be prefixed by a `[$hashsum] ` string, where `$hashsum` is a string that represents the first eight characters of @@ -184,10 +185,10 @@ Also, if multiple authors are involved in a changelog entry-set, each author should only appear once in the series with all her/his changes listed below her/him in chronological order. -Given that `debian/gbp.conf` is up-to-date, using the git-dch(1) tool -will result in the desired changelog format: +Given that `debian/gbp.conf` is up-to-date, using the `gbp dch` +command will result in the desired changelog format: - % git-dch + % gbp dch If you absolutely *must* make changelog entries by other means, you should make sure that you prefix any resulting commits with @@ -238,13 +239,13 @@ If old patches were still around, that could lead to conflicts when those would be applied during the build process. The message for the merge commit should be set to "New upstream -release" to allow `git-dch` to pick it up correctly later. **TODO**: +release" to allow `gbp dch` to pick it up correctly later. **TODO**: Doesn't really work. ### Insert initial changelog for the new upstream release -`git-dch` seems to be in trouble with non-linear histories. Therefore -we introduced a small helper script that will help `git-dch` to a +`gbp dch` seems to be in trouble with non-linear histories. Therefore +we introduced a small helper script that will help `gbp dch` to a linear history again. Basically, you after merging the upstream release tag into the debian @@ -298,8 +299,8 @@ the according bug report and/or CVE numbers, e.g. like this: + [babeabed] Fixes CVE-2014-9876 When creating a commit with these changelog changes, you may want to -prefix the commit message with `[dch-ignore] ` or add `-m "Git-Dch: -Ignore"` to the commit command so it doesn't come up in later git-dch +prefix the commit message with `[dch-ignore] ` or add `-m "Gbp-Dch: +Ignore"` to the commit command so it doesn't come up in later `gbp dch` runs. @@ -335,13 +336,13 @@ There are many ways to do this. Important is: ### Update changelog again for the release -The `do-dch` helper script should be used to do this. It wraps git-dch +The `do-dch` helper script should be used to do this. It wraps `gbp dch` with appropriate options and weeds out any commits that are prefixed with "[dch-ignore] ". All options to the script are turned over to -git-dch and at least `--since=…` should be used. +`gbp dch` and at least `--since=…` should be used. At this particular point the sha1 of the previous initial changelog -update commit would be a good idea. Also "-R" to tell git-dch to +update commit would be a good idea. Also "-R" to tell `gbp dch` to prepare the changelog for an actual commit. So: % debian/bin/do-dch --since=1234deadbeef -R @@ -365,8 +366,8 @@ Generating packages Alternatively, `git-buildpackage` (short `gbp`) also provides ways of building packages from our packaging codebase. And since we are using -the `gbp dch` command (formerly `git-dch` tool from this utility suite -anyway, the tool should be available already. +the `gbp dch` command (formerly the `git-dch` tool from this utility +suite anyway, the tool should be available already. `git-buildpackage` allows building the package from within the package repository and is currently avial @@ -505,7 +506,7 @@ TODO uploaded/accepted. * How and when to push tags. Debian Perl Group's `dpt push` (from the package `pkg-perl-tools`) comes in handy. -* `git commit -m 'Something unimportant' -m 'Git-Dch: Ignore'` +* `git commit -m 'Something unimportant' -m 'Gbp-Dch: Ignore'` * `export QUILT_PATCHES=debian/patches` should be mentioned under *Repository setup*, not under *Verify that the package builds*. * `* New upstream release` changelog entries should have the git |