Bug#1019207: git-buildpackage: Update documentation of gbp-push to reflect skipping debian-branch was dropped

[Evangelos Ribeiro Tzaras]

Package: git-buildpackage
Version: 0.9.28
Severity: wishlist

Dear Maintainer,

the docs (wrongly) mention that one can pass an empty string for the debian-branch,
but apparently this functionality was dropped without updating the documentation.

From `man gbp-push`:

--debian-branch=branch_name
The branch in the Git repository the Debian package is being developed on. If set to
the empty value the branch will not be pushed.

Trying it:

> $ gbp push --debian-branch='' salsa_rw
gbp:error: You are not on branch '' but on 'debian/master'
gbp:error: Use --ignore-branch to ignore or --debian-branch to set the branch name.

> $ gbp push --debian-branch= salsa_rw
gbp:error: You are not on branch '' but on 'debian/master'
gbp:error: Use --ignore-branch to ignore or --debian-branch to set the branch name.


Thanks for maintaing git-buildpackage!

-- System Information:
Debian Release: bookworm/sid
APT prefers testing-debug
APT policy: (500, 'testing-debug'), (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: arm64, i386

Kernel: Linux 5.19.0-1-amd64 (SMP w/32 CPU threads; PREEMPT)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US:en
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages git-buildpackage depends on:
ii devscripts 2.22.2
ii git 1:2.37.2-1
ii man-db 2.10.2-3
ii python3 3.10.6-1
ii python3-dateutil 2.8.1-6
ii python3-pkg-resources 59.6.0-1.2
ii sensible-utils 0.0.17

Versions of packages git-buildpackage recommends:
ii cowbuilder 0.89
ii pbuilder 0.231
ii pristine-tar 1.49
ii python3-requests 2.27.1+dfsg-1

Versions of packages git-buildpackage suggests:
pn python3-notify2 <none>
ii sudo 1.9.11p3-1
ii unzip 6.0-27

-- no debconf information