Scroll to navigation

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

NAME

git-deborig - Tenter de produire orig.tar de Debian avec git-archive(1)

SYNOPSIS

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

DESCRIPTION

git-deborig tente de produire le fichier orig.tar dont vous avez besoin pour votre envoi en appelant git-archive(1) sur une étiquette ou un "head" de branche de git; Il a été écrit en pensant au déroulement de dgit-maint-merge(7) mais peut être utilisé avec d’autres flux de travaux.

git-deborig essaiera plusieurs noms d’étiquette courants. S’il échoue, ou si plus d’une étiquette courante sont présentes, il est possible de préciser en ligne de commande l’étiquette ou le "head" de branche à archiver (objet_d’envoi ci-dessus).

git-deborig remplacera les gitattributes(5) qui pourraient faire que le contenu de l’archive générée par git-archive(1) ne soit pas identique à l’objet d’envoi archivé : les attributs export-subst et export-ignore.

git-deborig devrait être invoqué à partir de la racine du dépôt git qui devrait contenir debian/changelog.

OPTIONS

Écraser tout fichier orig.tar existant dans le répertoire parent.
Au lieu d’invoquer réellement git-archive(1), afficher les informations sur comment il devrait être invoqué. --force est ignoré.

The output is, one per line:

Notez que l’exécution de l’invocation de git-archive(1) produite avec cette option peut ne pas produire la même sortie. C’est parce que git-deborig prend soin de désactiver les attributs de git dont autrement git-archive(1) tient compte, comme cela est détaillé précédemment.

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.

Au lieu d’appeler réellement git-archive (1), ou même de vérifier quels tags existent, affiche les noms de balises considérées comme numéro de version amont dans la première entrée du changelog Debian, ou celle fournie avec --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.

Au lieu de lire la nouvelle version amont, prise dans la première entrée du changelog de Debian, utiliser la VERSION.

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