Quando etiquetas de autor são lançadas em git¶

Supondo que o lançamento de autor estável mais recente é 1.2.2, e isto foi etiquetado '1.2.2' pelo autor.

    % git clone -oupstream https://some.upstream/foo.git
    % cd foo
    % git verify-tag 1.2.2
    % git reset --hard 1.2.2
    % git branch --unset-upstream

O comando final desanexa o seu ramo mestre do remoto do autor, assim esse git não tenta empurrar nada para lá, nem fundir cometidos não lançados do autor. Se você que manter uma cópia do seu ramo de empacotamento em salsa.debian.org adicionalmente a dgit-repos, pode fazer algo como isto:

    % git remote add -f origin salsa.debian.org:debian/foo.git
    % git push --follow-tags -u origin master

Agora siga e Debianize o seu pacote. Faça cometidos no ramo mestre, adicionando coisas no directório debian/. Se você precisa de aplicar patches na fonte do autor, faça cometidos que alteram ficheiros fora do directório debian/. É melhor separar os cometidos que mexem em debian/ dos cometidos que mexem na fonte do autor, para que mais tarde possam ser escolhidos pelo autor.

Note que não é preciso manter um ramo 'upstream' separado, a menos que você também esteja envolvido no desenvolvimento do autor. Nós trabalhamos com etiquetas de autor em vez de quaisquer ramos, excepto quando se encaminha patches (veja ENCAMINHAR PATCHES AO AUTOR, em baixo).

Finalmente, você precisa dum tarball original:

    % git deborig

Veja git-deborig(1) se isto falhar.

Este tarball é efémero e facilmente regenerado, assim não o cometemos para lado nenhum (ex. com ferramentas como o pristine-tar(1)).

Verificar lançamentos de tarball do autor

Usando cometidos de autor não etiquetados

    % git tag -s upstream/1.2.2+git20131211.ab34c21 ab34c21

    % git tag -s upstream/$(git show --date=format:%Y%m%d --pretty=format:"1.2.2+git%cd.%h" --quiet upstream/main) upstream/main

Quando o autor lança apenas tarballs¶

Nós precisamos de um ramo de autor virtual com etiquetas de lançamento virtuais. O bp-import-orig(1) pode gerir isto para nós. Para começar

    % mkdir foo
    % cd foo
    % git init

Agora crie debian/gbp.conf:

    [DEFAULT]
    upstream-branch = upstream
    debian-branch = master
    upstream-tag = upstream/%(version)s
    sign-tags = True
    pristine-tar = False
    pristine-tar-commit = False
    [import-orig]
    merge-mode = merge
    merge = False

gbp-import-orig(1) requer um ramo de autor pré-existente:

    % git add debian/gbp.conf && git commit -m "create gbp.conf"
    % git checkout --orphan upstream
    % git rm -rf .
    % git commit --allow-empty -m "initial, empty branch for upstream source"
    % git checkout -f master

Então podemos importar a versão do autor:

    % gbp import-orig --merge --merge-mode=replace ../foo_1.2.2.orig.tar.xz

O nosso ramo de autor não pode ser empurrado para dgit-repos, mas como nós vamos precisar dele sempre que importamos uma nova versão de autor, temos de o empurrar para algum lado. A escolha mais usada é salsa.debian.org:

    % git remote add -f origin salsa.debian.org:debian/foo.git
    % git push --follow-tags -u origin master upstream

Agora você está pronto para prosseguir como em cima, fazendo cometidos para ambos a fonte do autor e o directório debian/.

Nenhum histórico git existente¶

    % dgit clone foo
    % cd foo
    % git remote add -f upstream https://some.upstream/foo.git

Histórico git existente usando outro fluxo de trabalho¶

Em primeiro lugar, se você ainda não tem o histórico git localmente, clone-o, e obtenha o orig.tar correspondente a partir do arquivo:

    % git clone salsa.debian.org:debian/foo
    % cd foo
    % origtargz

Agora despeje qualquer fila de patch existente:

    % git rm -rf debian/patches
    % git commit -m "drop existing quilt patch queue"

Depois torne as novas etiquetas de autor disponíveis:

    % git remote add -f upstream https://some.upstream/foo.git

Agora você simplesmente precisa assegurar que o seu CABEÇALHO git é compatível com o dgit, isto é, é exatamente o que obteria se corresse dpkg-buildpackage -i'(?:^|/)\.git(?:/|$)' -I.git -S e depois desempacotasse o pacote fonte resultante.

Para conseguir isto, você pode precisar de apagar debian/source/local-options. Uma maneira de ter o dgit a verificar o seu progresso é correr dgit build-source.

O primeiro dgit push vai requerer --trust-changelog. Se este é o primeiro dgit push do pacote, considere passar --deliberately-not-fast-forward em vez de --trust-changelog. Isto evita introduzir um novo cometer de origem no seu histórico git. (Este cometer de origem iria representar o envio não-dgit mais recente do pacote, mas isto já deve estar representado no seu histórico git.)

configuração do dgit¶

Nós temos de dizer ao dgit para não tentar manter uma fila linear de patches para a fonte do autor:

    git config dgit.default.quilt-mode single

Este comando deve ser executado em cada clone git deste pacote, incluindo os seus co-maintainers. Não o defina mais globalmente, porque não é uma boa predefinição para trabalhar em pacotes fonte Debian em geral.

debian/source/options¶

Nós definimos uma opção de pacote fonte para ajudar o dpkg a lidar com as alterações à fonte do autor:

    auto-commit

Nós não precisamos de criar este ficheiro se estiver a usar a versão 1.0 do formato de pacote fonte.

Obtendo o lançamento¶

Quando etiquetas de autor são lançadas em git

    % git fetch --tags upstream

Se você quer empacotar um cometido de autor não etiquetado (porque o autor não etiqueta os lançamentos ou porque você quer empacotar um instantâneo de desenvolvimento do autor), veja "Usando cometidos de autor não etiquetados" em cima.

Quando o autor lança apenas tarballs

Você vai precisar do debian/gbp.conf de "Quando o autor lança apenas tarballs", em cima. Você vai também precisar do seu ramo de autor. Em cima, nós envia-mos isto para salsa.debian.org. Você vai precisar de clonar ou ir buscar de lá, em vez de confiar apenas em dgit clone/dgit fetch.

Então, ou

    % gbp import-orig ../foo_1.2.3.orig.tar.xz

ou se você tiver um ficheiro watch a funcionar

    % gbp import-orig --uscan

No seguinte, substitua 1.2.3 por upstream/1.2.3.

Revisar e fundir o lançamento¶

É boa ideia pre-visualizar a fusão do novo lançamento de autor. Primeiro, verifique por quaisquer ficheiros novos ou apagados que podem precisar ser declarados no seu ficheiro copyright:

    % git diff --name-status --diff-filter=ADR master..1.2.3 -- . ':!debian'

Você pode depois pré-visualizar o diff da fusão completa:

    % git merge-tree `git merge-base master 1.2.3` master 1.2.3 | $PAGER

Assim que estiver satisfeito com o que vai ser fundido, atualize o seu pacote:

    % git merge 1.2.3
    % dch -v1.2.3-1 New upstream release.
    % git add debian/changelog && git commit -m changelog

Se você obteve um tarball a partir do autor, está pronto para tentar uma compilação. Se você fundiu uma etiqueta git a partir do autor, você vai precisar de primeiro gerar um tarball:

    % git deborig

Quando etiquetas de autor são lançadas em git¶

Nós criamos uma etiqueta DFSG-limpo para fundir no mestre:

    % git checkout -b pre-dfsg 1.2.3
    % git rm evil.bin
    % git commit -m "upstream version 1.2.3 DFSG-cleaned"
    % git tag -s 1.2.3+dfsg
    % git checkout master
    % git branch -D pre-dfsg

Antes de fundir a nova etiqueta 1.2.3+dfsg para mestre, você deve primeiro determinar se poderá ser perigoso legalmente para o material não-livre ficar acessível publicamente no histórico git em dgit-repos.

Se poderá ser perigoso, existe um grande problema; neste caso por favor consulte os seus administradores do arquivo (para Debian isto é o administrador do dgit dgit-owner@debian.org e os mestres de ftp ftpmaster@ftp-master.debian.org).

Quando o autor lança apenas tarballs¶

A maneira mais fácil de lidar com isto é adicionar um campo Files-Excluded a debian/copyright, e uma definição uversionmangle em debian/watch. Veja uscan(1). Em alternativa, veja a opção --filter detalhada em gbp-import-orig(1).