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

Holger Levsen [11/Feb 12:15pm GMT] wrote:
> yes, its not experimental since a week. Hardly mature enough to be recommended
> for *everyone* (as your patch did) which youself have documented on
> https://wiki.debian.org/tag2upload#Not%20supported
>
> btw, I'd expect this URL (until the hash sign probably :) to be included
> in src:devref! (this URL or another which is the canonical documentation
> for tag2upload.)

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---

-- 
Sean Whitton

-----BEGIN PGP SIGNATURE-----

iQJNBAEBCgA3FiEEm5FwB64DDjbk/CSLaVt65L8GYkAFAmmNxLYZHHNwd2hpdHRv
bkBzcHdoaXR0b24ubmFtZQAKCRBpW3rkvwZiQG/YD/4yEtMzZXsZnUEorc5Jpme9
+/NMs4yCK4Sq/pO/73FoydNvlmq1zfpB9p6w4TgEK4s9xR8Z3fKWfdeSvG007HyM
Abnlv/x16NwSfXT7XIqtimv2oTMJyckY0I54h8GsbCCn3tOntacGZkC0bAOAP874
4/iGAbHk4pEsJ+Dxv82M1Ovlv5TPULfSJi5h2ShgStsGcH4FIep2J8KX0ZpBV997
ytUnMuimiAcXDmv7Vo/55QgOm21XjYjJOMInGQsabaYzPfaAMgE55a5F2iaWK7Jx
EuPtUtXFYRM3A4PFmW1AewRYK2xLZZ94DenvvrSivGHzk6kSzs8mkVtCaJJ4Mqld
66W1B/td0b0uxCSmpKmutRZXzvWdGAjB43UEPrhvgq4yLuVCi3r9ls3Ys0ytw+Qa
EyRbQF36JPn9YF2cNsnDJI93XutcTmYz1/0btTYb3pWHaGvUzc2VbzUCnpOdko5c
MH0YSiwMEfVWSYdaFBwezoVuecK4YR9IyTTuMSnRDs+bYPdL5Jc2hAkhLadntcmD
bGak4nhXjYShRqLQTgWSevR39JrgWLDnPpJerZta1Q5kn9Hqwlw7FW+zMAN9JmNN
4KcvM3p8VC+Hu+17NhgpIxEQ4j4fI/qWTiJqzyUaymIS0sCeFLgWNrdoapSXpo8d
wrU0zSv9P0PZazHCHOlO8A==
=kLbs
-----END PGP SIGNATURE-----