Scroll to navigation

git-deborig(1) git-deborig git-deborig(1)

NAME

git-deborig - versucht, mittels git-archive(1) Debians orig.tar zu erstellen.

SYNOPSIS

git deborig [--force|-f] [--just-print|--just-print-tag-names] [--version=VERSION] [COMMITTISH]

DESCRIPTION

git-deborig versucht, das orig.tar, das Sie zum Hochladen benötigen, zu erstellen, indem es git-archive(1) auf einer bestehenden Git-Markierung oder Kopf eines Zweiges aufrufen. Es wurde unter Berücksichtigung des Arbeitsablaufs von dgit-maint-merge(7) geschrieben, kann aber auch mit anderen Arbeitsabläufen benutzt werden.

git-deborig wird mehrere geläufige Markierungsnamen durchprobieren. Falls dies fehlschlägt oder mherere dieser Markierungen vorhanden sind, können Sie die Markierung oder den Kopf des Zweiges zum Archivieren auf der Befehlszeile (COMMITTISH oben) angeben.

git-deborig wird gitattributes(5) außer Kraft setzen. letzteres würde dazu führen, dass der Inhalt des durch git-archive(1) erstellten Tarballs nicht mit dem archivierten Commitish übereinstimmt: den Attributen export-subst und export-ignore.

git-deborig sollte von der Wurzel des Git-Depots aufgerufen werden, das debian/changelog enthalten sollte.

OPTIONS

überschreibt jede existierende orig.tar im übergeordneten Verzeichnis.
gibt, anstatt git-archive(1) tatsächlich aufzurufen, Informationen aus, was beim Aufruf geschehen würde. Ignoriert --force.

The output is, one per line:

Beachten Sie, dass das Ausführen von git-archive(1) dessen Aufruf mit dieser Option ausgegeben wird, möglicherweise nicht dieselbe Ausgabe erzeugt. Dies liegt daran, dass git-deborig Git-Attribute deaktiviert, die anderenfalls durch git-archive(1) beherzigt würden, wie oben erklärt.

Exits with status 6 (and an error message) if the tag situation is confusing or ambiguous, and the problem could be fixed by a config change.

Instead of actually invoking git-archive(1), or even checking which tags exist, print the tag names we would consider for the upstream version number in the first entry in the Debian changelog, or that supplied with --version.

The output is just a list, and omits information about tag priority order. Prefer --just-print, which uses a more sophisticated algorithm to select the correct tag.

benutzt VERSION, statt die Version von den Originalautoren aus dem ersten Eintrag des Debian-Changelogs zu lesen.

UPSTREAM TAG SELECTION

CONFIGURING DIRECT USE OF UPSTREAM TAGS

Normally, it is best to use upstream git tags directly, and not import upstream tarballs or retag upstream releases.

git-deborig tries to guess the right upstream tag, from the version number. By default it expects the real upstream tag to be version or vversion

You can override this by creating a debian/gbp.conf containing something like this:

 [export-orig]
 upstream-tag = foo-%(version)s

This will also make gbp export-orig and Debian Salsa CI use the nominated upstream tag directly.

If you want new upstream releases shown on Debian QA packages, or to use uscan, you need to configure uscan separately. See uscan(1).

If you use gbp import-orig instead (we recommend against that), git-deborig will use the tags created by gbp import-orig. Real upstream information is then provided to gbp invocations. consult its documentation.

ALGORITHM REFERENCE

git-deborig looks for tags in this order:

[export-orig] upstream-tag = ... in gbp.conf
This is the value which would also be used by gbp export-orig.

%(version)s is replaced with the upstream version number, transformed according to DEP-14. See gbp.conf(5) and Python 3 configparser for full details.

This is the tag format used by gbp import-orig's synthetic tarball imports, by default.
Finally, if exactly one of these tags exist, git-deborig will use it. If neither or both exist, it is an error.

SEE ALSO

git-archive(1), dgit-maint-merge(7), dgit-maint-debrebase(7)

AUTHOR

The original author of git-deborig and this manpage is Sean Whitton <spwhitton@spwhitton.name>. They are now maintained by others.

dgit+tag2upload team Debian Project