[git-buildpackage] Updates to Debian Developers Reference about git-buildpackage

[Johannes Schauer Marin Rodrigues]

Hi,

Quoting Otto Kekäläinen (2025-05-17 03:48:03)
> I noticed that the DDR was almost void of information about git-buildpackage,
> despite it being the most common tool maintainers use on daily basis. I
> addressed it by adding some info, and just wanted to share here that
> https://salsa.debian.org/debian/developers-reference/-/commit/5cc63e9c0d0e9efd81b0d53b84adf62ea3044dc8
> got included in the latest version of
> https://www.debian.org/doc/manuals/developers-reference/

from your commit message:

> majority of Debian Developers use git-buildpackage

how do you know?

>From your text:

> git-buildpackage offers the most convenient way to create and maintain
> patches in Debian that so they are submit upstream

"that so they are submitted upstream" -> no idea what you wanted to write there
instead

> For details, see git-buildpackage man pages [...] and having git remote
> ``upstreamvcs`` to easily cherry-pick patches to and from upstream git
> branches

The git-buildpackage man page does not mention upstreamvcs at all.

> Note that easiest way to both check if your package has been NMUed, and also
> automatically download and commit the changes into a git-buildpackage
> maintained git repository is to run ``gbp import-dsc --verbose --pristine-tar
> apt:<package>/sid``.

You don't know whether the package in question actually uses `--pristine-tar`
so that switch might be harmful.

> This example command assumes you are working on the ``debian/latest`` branch
> preparing the next upload to Debian unstable

How does that command assume the `debian/latest` branch? It works just fine on
whatever branch is the default packaging branch for the package in question and
last I checked, "master" was still the default for gbp, no?

> and it assumes your ``apt`` has the ``deb-src`` line active for Debian
> unstable.

Your command uses "sid". It might make sense to avoid confusion of the reader
to use the same (unstable or sid) in both places or point out that they are
interchangeable.

Thanks!

cheers, josch
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: signature
URL: <http://lists.sigxcpu.org/pipermail/git-buildpackage/attachments/20250517/d7ac5dcf/attachment.sig>