Encontrar o nome do pacote fonte¶

Para muitos pacotes, o nome de pacote fonte é óbvio. Caso contrário, se você souber de um ficheiro que está no pacote, você pode procura-lo com o dpkg:

    % dpkg -S /lib/i386-linux-gnu/libc.so.6 
    libc6:i386: /lib/i386-linux-gnu/libc.so.6
    % dpkg -s libc6:i386
    Package: libc6
    Status: install ok installed
    ...
    Source: glibc

(Neste exemplo, libc6 é um pacote "multi-arch: allowed", o que significa que ele existe em várias compilações diferentes para arquitecturas diferentes. É daí que ":i386" vem.)

Encontrar o lançamento Debian (a "suite")¶

Internamente, as distribuições Debian (e derivadas) normalmente referem os seus lançamentos por nomes de código. Debian também tem nomes alternativos que referem o lançamento estável actual, etc. Assim por exemplo, na altura da escrita de Debian "bookworm" (Debian 12) é Debian "stable"; e a versão atual de Ubuntu é "plucky" (Plucky Puffin, 25.04). Você pode especificar seja o nome de código "bookworm" ou o nome alternativo "stable". Se você não o disser, vai obter "sid", o que é Debian "unstable" - o principal ramo de trabalho em progresso.

Se você não sabe o que está a usar, por favor consulte a sua configuração do apt em /etc/apt/sources* ou em /etc/debian_version

Para Debian, você deve adicionar ",-security" ao final do nome de suite , a menos que esteja em unstable ou testing. Assim, no seu exemplo "bookworm" torna-se "bookworm,-security". (Sim, com uma vírgula.)

Que ramos existem¶

dgit clone irá dar-lhe uma nova árvore de trabalho, e arrumar para si para ficar num ramo chamado algo como "dgit/bookworm,-security" (sim, com uma vírgula no nome de ramo).

Para cada lançamento (como "bookworm") existe um ramo de acompanhamento para os conteúdos do arquivo, chamado "remotes/dgit/dgit/bookworm" (e semelhante para outras suites). Isto pode ser atualizado com "dgit fetch bookworm". Isto, o remote suite branch, é sintetizado pela sua cópia local do dgit. É um avanço rápido.

Debian separa as atualizações de segurança, em "*-security". Dizer ao dgit "bookworm,-security" significa que deve incluir quaisquer atualizações disponíveis em "bookworm-security". A notação com a vírgula é um pedido ao dgit para acompanhar bookworm, ou bookworm-security para ver se há atualização para o pacote lá.

(Você também pode fazer o dgit procurar numa árvore que não foi feita pelo dgit clone. Se não existir um "debian/changelog" você tem de fornecer uma opção "-p"pacote para o dgit procurar.)

Que tipo de árvore fonte você obtém¶

Se o pacote Debian for baseado em algum lançamento do autor, a disposição do código estará parecida com a versão do autor. Você vai achar "git grep" uma boa ajuda para descobrir onde editar.

Os metadados do pacote Debian e os scripts para compilar pacotes binário estão sob "debian/". "debian/control", "debian/changelog" e "debian/rules" são os pontos de partida. O Manual de Política Debian tem a maioria dos detalhes mais profundos.

Para a maioria dos pacotes, vão estar também algumas coisas em "debian/patches/". É melhor ignorar estas. Na medida que são relevantes nas alterações que vão ser aplicadas aos ficheiros, provavelmente por meio de coisas cometidas no histórico do git. O conteúdo debian/patches é ignorado quando se compila binários a partir de ramos git feitos à dgit.

(Para os aficionados de Debian: as árvores git que saem do dgit são "ramos de empacotamento com patches-aplicada sem um directório .pc".)

Que tipo de história você obtém¶

Se estiver com sorte, o histórico será uma versão de, ou baseada em, do histórico git do próprio maintainer Debian, ou do histórico git do autor.

Mas para muitos pacotes o histórico git real não existe, ou não foi publicado num formato à dgit. Assim você pode descobrir que o histórico é um histórico bastante curto inventado pelo dgit.

os históricos do dgit muitas vezes contém commits gerados automaticamente, incluindo commits que não fizeram nenhumas alterações mas serviram para criar um ramo re-baseado de avanço rápido. Isto é particularmente verdade de se combinar ramos como "bookworm,-security".

Se o maintainer do pacote está a usar git após dgit clone você pode descobrir que existe um "vcs-git" remoto útil que refere ao repositório do maintainer do pacote Debian. Você pode ver o que lá está com "git fetch vcs-git". Mas use o que lá encontrar com cuidado: os repositórios de maintainers Debian muitas vezes têm conteúdos que são muito confusos e idiossincráticos. Em particular, você pode precisar de aplicar manualmente as patches que estão em debian/patches antes de fazer qualquer outra coisa.

Cometa sempre antes de compilar¶

    % wget 'https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=28250;mbox=yes;msg=89' | patch -p1 -u
    % git commit -a -m 'Fix libc lost output bug'

Compilações de pacote Debian são muitas vezes bastantes desarrumadas: elas podem modificar ficheiros que são também cometidos para o git, ou deixar resultados e ficheiros temporários não cobertos pelo ".gitignore".

Se você cometer sempre, você pode usar

    % git clean -xdf
    % git reset --hard

para arrumar tudo após um compilação. (Se você se esqueceu de cometer, não use esses comandos; em vez disso, saiba que pode usar "git add -p" para ajudar a cometer aquilo que realmente quer manter.)

Estes são comandos destrutivos que apagam todos os novos ficheiros (assim você tem de se lembrar de dizer "git add") e deitam fora as edições de cada ficheiro (assim você tem de se lembrar de cometer).

Atualize o changelog (pelo menos uma vez) antes de compilar¶

    % gbp dch -S --since=dgit/dgit/sid --ignore-branch --commit

Os binários que você compilar irão ter um número de versão que em última análise vem de "debian/changelog". Você vai querer ser capaz de distinguir os seus binários dos da sua distribuição.

Assim você deve atualizar "debian/changelog" para adicionar uma nova estrofe no topo, para a sua compilação.

Esta runa fornece uma maneira fácil de fazer isto. Adiciona uma nova entrada no changelog com uma mensagem pouco informativa e um número de versão plausível (contendo um bocadinho do seu id de cometido ao git).

Se desejar ser mais sofisticado, o pacote "dpkg-dev-el" tem um bom modo Emacs para editar changelogs. Em alternativa, você pode editar o changelog com outro editor de texto, ou correr "dch" ou "gbp dch" com opções diferentes. Escolher um bom número de versão é um pouco complicado e um tratamento completo está para lá do escopo deste tutorial.

Realmente compilar¶

    % sudo apt-get build-dep .
    % dpkg-buildpackage -uc -b

dpkg-buildpackage é a ferramenta principal para compilar um pacote fonte Debian. "-uc" significa não assinar com pgp os resultados. "-b" significa compilar todos os pacotes binário, mas não compilar um pacote fonte.

Usar o sbuild¶

Você pode compilar numa chroot de schroot, com o sbuild, em vez de o fazer no seu ambiente principal. (sbuild é usado pelos daemons de compilação de Debian.)

    % git clean -xdf
    % sbuild -d trixie -A --no-clean-source \
             --dpkg-source-opts='-Zgzip -z1 --format=1.0 -sn'

Note que isto vai parecer deixar um "pacote fonte" (.dsc e .tar.gz) no directório pai, mas esse pacote fonte não deve ser usado. Estará provavelmente estragado. Para mais informação veja bug Debian #868527.

Pacotes fonte¶

O ramo git não é suficiente para compilar um pacote fonte da maneira que Debian faz. Os pacotes fonte são um pouco desajeitados para se trabalhar. Na verdade muitos históricos git plausíveis ou árvores git não podem ser convertidos num pacote fonte apropriado. Assim Eu recomendo que você partilhe o seu ramo git em vez disto.

Se um ramo git não for suficiente, e precisar de fornecer um pacote fonte mas não se interessa pelo seu formato/disposição (por exemplo porque algum software que tem consome pacotes fonte, e não históricos git) você pode usar esta receita para gerar um pacote fonte "3.0 (nativo)", o que é apenas um tarball com acompanhado dum ficheiro de metadados .dsc:

    % echo '3.0 (native)' >debian/source/format
    % git commit -m 'switch to native source format' debian/source/format
    % dgit -wgf build-source

Se você precisar de fornecer um pacote fonte bonito, esteja preparado para muito mais trabalho. Vai precisar de ler muito mais, talvez começando com dgit-nmu-simple(7), dgit-sponsorship(7) ou dgit-maint-*(7)