Bug#1127616: developers-reference: should document using git-debpush to upload

Holger Levsen <[email protected]> Thu, 12 Feb 2026 14:15:39 +0000

Newsgroups	gmane.linux.debian.devel.policy
Message-ID	<aY3giwQ5czT3kCSe__17300.692030561$1770905848$gmane$org@layer-acht.org>

On Thu, Feb 12, 2026 at 12:16:54PM +0000, Sean Whitton wrote:
> How's this, then:
> 
> --8<---------------cut here---------------start------------->8---
> diff --git a/source/pkgs.rst b/source/pkgs.rst
> index 41d0147..02a7696 100644
> --- a/source/pkgs.rst
> +++ b/source/pkgs.rst
> @@ -359,7 +359,13 @@ All of the corresponding architecture-dependent and architecture-independent
>  binary packages, for all architectures, will be built automatically by
>  the build daemons in a controlled and predictable environment
>  (see :ref:`wanna-build` for more details).
> -However, there are several situations where this is not possible.
> +
> +For many source-only uploads you can use tag2upload instead, which means that
> +you only need to push a signed Git tag to Salsa, instead of generating and
> +signing ``.dsc`` and ``.changes`` files yourself.
> +See https://wiki.debian.org/tag2upload\ .
> +
> +There are several situations where a source-only upload is not possible.
> 
>  The first upload of a new source package (see :ref:`newpackage`)
>  must include binary packages, so that they can be reviewed by the
> --8<---------------cut here---------------end--------------->8---

looks great to me, thanks! (feel free to commit this directly to the main branch,
obviously an MR is fine as well and I'd also be happy to massage this into git for you, 
if you'd prefer that)


-- 
cheers,
	Holger

 ⢀⣴⠾⠻⢶⣦⠀
 ⣾⠁⢠⠒⠀⣿⡁  holger@(debian|reproducible-builds|layer-acht).org
 ⢿⡄⠘⠷⠚⠋⠀  OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C
 ⠈⠳⣄

The empty vessel makes the greatest sound. (William Shakespeare)

signature.asc (application/pgp-signature, 833 B)