Scroll to navigation

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

NOME

git-deborig - tenta produzir Debian orig.tar usando git-archive(1)

RESUMO

git deborig [--force|-f] [--just-print|--just-print-tag-names] [--version=VERSÃO] [COMMITTISH]

DESCRIÇÃO

git-deborig tenta produzir o orig.tar que você precisa para o seu envio ao chamar git-archive(1) numa etiqueta git ou cabeça de ramo existentes. Foi escrito com o fluxo de trabalho do dgit-maint-merge(7) em mente, mas pode ser usado com outros fluxos de trabalho.

git-deborig irá tentar vários nomes de etiquetas comuns. Se falhar, ou se mais do que uma dessas etiquetas comuns estiver presente, você pode especificar a etiqueta ou cabeça de ramo a arquivar na linha de comandos (COMMITTISH em cima).

git-deborig irá sobrepor gitattributes(5) que iriam causar com que o conteúdo do tarball gerado pelo git-archive(1) não fosse idêntico ao do arquivo submetido: os atributos export-subst e export-ignore.

git-deborig deve ser invocado a partir da raiz do repositório git, o qual deve conter debian/changelog.

OPÇÕES

Sobrescreve qualquer orig.tar existente no directório pai.
Em vez de na realidade invocar git-archive(1), escreve informação sobre como este seria invocado. Ignora --force.

The output is, one per line:

Note que ao correr a invocação do git-archive(1) com esta opção pode não produzir os mesmos resultados. Isto porque git-deborig trata de desactivar atributos git que caso contrário são precisos pelo git-archive(1), como detalhado em cima.

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.

Em vez de na realidade invocar git-archive(1), ou mesmo verificar quais etiquetas existem, escreve os nomes de etiquetas que iríamos considerar para o número de versão do autor na primeira entrada no registo de alterações Debian, ou isso fornecido com --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.

Em vez de ler a nova versão de autor a partir da primeira entrada no registo de alterações Debian, usa VERSÃO.

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.

VEJA TAMBÉM

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

AUTOR

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