Package: git-buildpackage Version: 0.9.30 Severity: normal Dear Maintainer,
I would like to import the first version of an upstream source into a fresh gbp-maintained debian package. I have the usual debian branch files under debian/ prepped, the working tree is ready for an uscan. $ git ls-tree HEAD 040000 tree 4c37e44470bd093f9b15f925366c84757828cbb3 debian $ git branch -a * debian $ gbp import-orig --uscan --pristine-tar gbp:error: Repository does not have branch 'upstream' for upstream sources. If there is none see file:///usr/share/doc/git-buildpackage/manual-html/gbp.import.html#GBP.IMPORT.CONVERT on howto create it otherwise use --upstream-branch to specify it. Of course it doesn't, there is none. Let's see. The first and most obvious issue is that the #-location doesn't exist. "GBP" doesn't figure once in the HTML. But finding a "Starting a Debian™ package from scratch" sexion in the index, I navigated to file://localhost/usr/share/doc/git-buildpackage/manual-html/gbp.import.fromscratch.html which says (these are the entire contents of this document, barring header/footer): Starting a Debian™ package from scratch So far, we assumed you already have a Debian™ package to start with, but what if you want to start a new package? First, create an empty repository: mkdir package-0.1 cd package-0.1 git init Then, you import the upstream sources, branch off the upstream-branch branch and add the Debian™ files (e.g. via dh_make): gbp import-orig -u 0.1 ../package-0.1.tar.gz dh_make That's it, you're done. If you want to publish your new repository, you can use gbp create-remote-repo. (a) Why on earth does the directory have a version in it? (b) gbp import-orig doesn't have an -u option: $ man gbp-import-orig | grep -- '-u\b' $ and even if it did, I don't see how it would materially change the error. (c) I didn't realise, until evaluating this literally phrase-by-phrase, what "branch off the upstream-branch branch" was supposed to mean, and the entire "Then, you import the upstream sources, branch off the upstream-branch branch and add the Debian™ files" sequence is incomprehensible: (c1) this describes a sequence of "import -> create upstream branch -> add debian files"; import where? this is impossible (c2) what in god's name does "branch off the upstream-branch branch" mean (c3) what is "the upstream-branch branch". I've never seen a branch called "upstream-branch". Why does it spec that instead of the documented default of "upstream"? (c4) no but really. does it try to mean to spec git checkout -b upstream git import-orig ... or what? Because that's what I did finally after I violated (c1) and that worked but. well. (d) I think this whole thing is worse than just saying Repository does not have branch 'upstream' for upstream sources. Use --upstream-branch or create it with git checkout -b upstream, then gbp import-orig again. (e) This will also fix the "see [url] on howto create it" salad. Best, наб -- System Information: Debian Release: 12.4 APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 'stable-debug'), (500, 'stable') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 6.1.0-9-amd64 (SMP w/24 CPU threads; PREEMPT) Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_FIRMWARE_WORKAROUND, TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE=en_GB: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.23.4+deb12u1 ii git 1:2.39.2-1.1 ii man-db 2.11.2-2 ii python3 3.11.2-1+b1 ii python3-dateutil 2.8.2-2 ii python3-pkg-resources 66.1.1-1 ii python3-yaml 6.0-3+b2 ii sensible-utils 0.0.17+nmu1 Versions of packages git-buildpackage recommends: pn cowbuilder | pbuilder | sbuild <none> ii pristine-tar 1.50 ii python3-requests 2.28.1+dfsg-1 Versions of packages git-buildpackage suggests: pn python3-notify2 <none> ii sudo 1.9.13p3-1+deb12u1 ii unzip 6.0-28 -- no debconf information
signature.asc
Description: PGP signature