dgit 3.12_dgit-user_7 - en to pt translation catalogue (77 entries)

note: type: =head1
en: NAME
pt: NOME

note: type: =head1
en: SEE ALSO
pt: VEJA TAMBÉM

note: type: =head1
en: SUMMARY
pt: SUMÁRIO

note: type: textblock
en: dgit-user - making and sharing changes to Debian packages, with git
pt: dgit-user - fazer e partilhar alterações a pacotes Debian, com o git

note: type: =head1
en: INTRODUCTION
pt: INTRODUÇÃO

note: type: textblock
en: dgit lets you fetch the source code to every package on your system as if your distro used git to maintain all of it.
pt: git permite-lhe obter o código fonte para cada pacote no seu sistema como se a sua distribuição usasse git para os manter todos lá.

note: type: textblock
en: You can then edit it, build updated binary packages (.debs)  and install and run them.  You can also share your work with others.
pt: Você pode depois edita-los, compilar pacotes binários actualizados (.debs) e instala-los e corre-os.  Você pode também partilhar o seu trabalho com outros.

note: type: textblock
en: This tutorial gives some recipes and hints for this.  It assumes you have basic familiarity with git.  It does not assume any initial familiarity with Debian's packaging processes.
pt: Este tutorial fornece algumas receitas e dicas para isto.  Ele assume que você está basicamente familiarizado com o git.  Não assume nenhuma familiarização inicial com os processos de empacotamento de Debian.

note: type: textblock
en: If you are a package maintainer within Debian; a DM or DD; and/or a sponsee: this tutorial is not for you.  Try L<dgit-nmu-simple(7)>, L<dgit-maint-*(7)>, or L<dgit(1)> and L<dgit(7)>.
pt: Se você é um maintainer de pacotes com Debian; um DM ou DD; e/ou um apadrinhado: este tutorial não é para si.  Tente L<dgit-nmu-simple(7)>, L<dgit-maint-*(7)>, ou L<dgit(1)> e L<dgit(7)>.

note: type: textblock
en: (These runes will be discussed later.)
pt: (Estas runas serão discutidas mais tarde.)

note: type: textblock
en: Occasionally:
pt: Ocasionalmente:

note: type: textblock
en: Later:
pt: Depois:

note: type: =head1
en: FINDING THE RIGHT SOURCE CODE - DGIT CLONE
pt: ENCONTRAR O CÓDIGO FONTE CERTO - CLONE DO DGIT

note: type: textblock
en: dgit clone needs to be told the source package name (which might be different to the binary package name, which was the name you passed to "apt-get install")  and the codename or alias of the Debian release (this is called the "suite").
pt: o clone do dgit precisa que lhe digam o nome do pacote fonte (que pode ser diferente do nome do pacote binário, o qual foi o nome que você passou ao "apt-get install") e o nome de código ou nome alternativo do lançamento Debian (isto é chamado a "suite").

note: type: =head2
en: Finding the source package name
pt: Encontrar o nome do pacote fonte

note: type: textblock
en: For many packages, the source package name is obvious.  Otherwise, if you know a file that's in the package, you can look it up with dpkg:
pt: 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:

note: type: textblock
en: (In this example, libc6 is a "multi-arch: allowed" package, which means that it exists in several different builds for different architectures.  That's where C<:i386> comes from.)
pt: (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 C<:i386> vem.)

note: type: =head2
en: Finding the Debian release (the "suite")
pt: Encontrar o lançamento Debian (a "suite")

note: type: textblock
en: Internally, Debian (and derived) distros normally refer to their releases by codenames.  Debian also has aliases which refer to the current stable release etc.  So for example, at the time of writing Debian C<bookworm> (Debian 12) is Debian C<stable>; and the current version of Ubuntu is C<plucky> (Plucky Puffin, 25.04).  You can specify either the codename C<bookworm> or the alias C<stable>.  If you don't say, you get C<sid>, which is Debian C<unstable> - the main work-in progress branch.
pt: 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 C<bookworm> (Debian 12) é Debian C<stable>; e a versão atual de Ubuntu é C<plucky> (Plucky Puffin, 25.04).  Você pode especificar seja o nome de código C<bookworm> ou o nome alternativo C<stable>.  Se você não o disser, vai obter C<sid>, o que é Debian C<unstable> - o principal ramo de trabalho em progresso.

note: type: textblock
en: If you don't know what you're running, please refer to your apt configuration in /etc/apt/sources* or in /etc/debian_version
pt: 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

note: type: textblock
en: For Debian, you should add C<,-security> to the end of the suite name, unless you're on unstable or testing.  Hence, in our example C<bookworm> becomes C<bookworm,-security>.  (Yes, with a comma.)
pt: Para Debian, você deve adicionar C<,-security> ao final do nome de suite , a menos que esteja em unstable ou testing.  Assim, no seu exemplo C<bookworm> torna-se C<bookworm,-security>.  (Sim, com uma vírgula.)

note: type: =head1
en: WHAT DGIT CLONE PRODUCES
pt: O  QUE O CLONE DO DGIT PRODUZ

note: type: =head2
en: What branches are there
pt: Que ramos existem

note: type: textblock
en: dgit clone will give you a new working tree, and arrange for you to be on a branch named like C<dgit/bookworm,-security> (yes, with a comma in the branch name).
pt: dgit clone irá dar-lhe uma nova árvore de trabalho, e arrumar para si para ficar num ramo chamado algo como C<dgit/bookworm,-security> (sim, com uma vírgula no nome de ramo).

note: type: textblock
en: For each release (like C<bookworm>)  there is a tracking branch for the contents of the archive, called C<remotes/dgit/dgit/bookworm> (and similarly for other suites).  This can be updated with C<dgit fetch bookworm>.  This, the I<remote suite branch>, is synthesized by your local copy of dgit.  It is fast forwarding.
pt: Para cada lançamento (como C<bookworm>)  existe um ramo de acompanhamento para os conteúdos do arquivo, chamado C<remotes/dgit/dgit/bookworm> (e semelhante para outras suites).  Isto pode ser atualizado com C<dgit fetch bookworm>.  Isto, o I<remote suite branch>, é sintetizado pela sua cópia local do dgit.  É um avanço rápido.

note: type: textblock
en: Debian separates out the security updates, into C<*-security>.  Telling dgit C<bookworm,-security> means that it should include any updates available in C<bookworm-security>.  The comma notation is a request to dgit to track bookworm, or bookworm-security if there is an update for the package there.
pt: Debian separa as atualizações de segurança, em C<*-security>.  Dizer ao dgit C<bookworm,-security> significa que deve incluir quaisquer atualizações disponíveis em C<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á.

note: type: textblock
en: (You can also dgit fetch in a tree that wasn't made by dgit clone.  If there's no C<debian/changelog> you'll have to supply a C<-p>I<package> option to dgit fetch.)
pt: (Você também pode fazer o dgit procurar numa árvore que não foi feita pelo dgit clone.  Se não existir um C<debian/changelog> você tem de fornecer uma opção C<-p>I<pacote> para o dgit procurar.)

note: type: =head2
en: What kind of source tree do you get
pt: Que tipo de árvore fonte você obtém

note: type: textblock
en: If the Debian package is based on some upstream release, the code layout should be like the upstream version.  You should find C<git grep> helpful to find where to edit.
pt: 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 C<git grep> uma boa ajuda para descobrir onde editar.

note: type: textblock
en: The package's Debian metadata and the scripts for building binary packages are under C<debian/>.  C<debian/control>, C<debian/changelog> and C<debian/rules> are the starting points.  The Debian Policy Manual has most of the in-depth technical details.
pt: Os metadados do pacote Debian e os scripts para compilar pacotes binário estão sob C<debian/>.  C<debian/control>, C<debian/changelog> e C<debian/rules> são os pontos de partida.  O Manual de Política Debian tem a maioria dos detalhes mais profundos.

note: type: textblock
en: For many Debian packages, there will also be some things in C<debian/patches/>.  It is best to ignore these.  Insofar as they are relevant the changes there will have been applied to the actual files, probably by means of actual commits in the git history.  The contents of debian/patches are ignored when building binaries from dgitish git branches.
pt: Para a maioria dos pacotes, vão estar também algumas coisas em C<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.

note: type: textblock
en: (For Debian afficionados: the git trees that come out of dgit are "patches-applied packaging branches without a .pc directory".)
pt: (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".)

note: type: =head2
en: What kind of history you get
pt: Que tipo de história você obtém

note: type: textblock
en: If you're lucky, the history will be a version of, or based on, the Debian maintainer's own git history, or upstream's git history.
pt: 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.

note: type: textblock
en: But for many packages the real git history does not exist, or has not been published in a dgitish form.  So you may find that the history is a rather short history invented by dgit.
pt: 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.

note: type: textblock
en: dgit histories often contain automatically-generated commits, including commits which make no changes but just serve to make a rebasing branch fast-forward.  This is particularly true of combining branches like C<bookworm,-security>.
pt: 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 C<bookworm,-security>.

note: type: textblock
en: If the package maintainer is using git then after dgit clone you may find that there is a useful C<vcs-git> remote referring to the Debian package maintainer's repository for the package.  You can see what's there with C<git fetch vcs-git>.  But use what you find there with care: Debian maintainers' git repositories often have contents which are very confusing and idiosyncratic.  In particular, you may need to manually apply the patches that are in debian/patches before you do anything else!
pt: Se o maintainer do pacote está a usar git após dgit clone você pode descobrir que existe um C<vcs-git> remoto útil que refere ao repositório do maintainer do pacote Debian.  Você pode ver o que lá está com C<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.

note: type: =head1
en: BUILDING
pt: COMPILAÇÃO

note: type: =head2
en: Always commit before building
pt: Cometa sempre antes de compilar

note: type: textblock
en: Debian package builds are often quite messy: they may modify files which are also committed to git, or leave outputs and temporary files not covered by C<.gitignore>.
pt: 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 C<.gitignore>.

note: type: textblock
en: If you always commit, you can use
pt: Se você cometer sempre, você pode usar

note: type: textblock
en: to tidy up after a build.  (If you forgot to commit, don't use those commands; instead, you may find that you can use C<git add -p> to help commit what you actually wanted to keep.)
pt: 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 C<git add -p> para ajudar a cometer aquilo que realmente quer manter.)

note: type: textblock
en: These are destructive commands which delete all new files (so you B<must> remember to say C<git add>)  and throw away edits to every file (so you B<must> remember to commit).
pt: Estes são comandos destrutivos que apagam todos os novos ficheiros (assim você B<tem> de se lembrar de dizer C<git add>) e deitam fora as edições de cada ficheiro (assim você B<tem> de se lembrar de cometer).

note: type: =head2
en: Update the changelog (at least once) before building
pt: Atualize o changelog (pelo menos uma vez) antes de compilar

note: type: textblock
en: The binaries you build will have a version number which ultimately comes from the C<debian/changelog>.  You want to be able to tell your binaries apart from your distro's.
pt: Os binários que você compilar irão ter um número de versão que em última análise vem de C<debian/changelog>.  Você vai querer ser capaz de distinguir os seus binários dos da sua distribuição.

note: type: textblock
en: So you should update C<debian/changelog> to add a new stanza at the top, for your build.
pt: Assim você deve atualizar C<debian/changelog> para adicionar uma nova estrofe no topo, para a sua compilação.

note: type: textblock
en: This rune provides an easy way to do this.  It adds a new changelog entry with an uninformative message and a plausible version number (containing a bit of your git commit id).
pt: 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).

note: type: textblock
en: If you want to be more sophisticated, the package C<dpkg-dev-el> has a good Emacs mode for editing changelogs.  Alternatively, you could edit the changelog with another text editor, or run C<dch> or C<gbp dch> with different options.  Choosing a good version number is slightly tricky and a complete treatment is beyond the scope of this tutorial.
pt: Se desejar ser mais sofisticado, o pacote C<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 C<dch> ou C<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.

note: type: =head2
en: Actually building
pt: Realmente compilar

note: type: textblock
en: dpkg-buildpackage is the primary tool for building a Debian source package.  C<-uc> means not to pgp-sign the results.  C<-b> means build all binary packages, but not to build a source package.
pt: dpkg-buildpackage é a ferramenta principal para compilar um pacote fonte Debian.  C<-uc> significa não assinar com pgp os resultados.  C<-b> significa compilar todos os pacotes binário, mas não compilar um pacote fonte.

note: type: =head2
en: Using sbuild
pt: Usar o sbuild

note: type: textblock
en: You can build in an schroot chroot, with sbuild, instead of in your main environment.  (sbuild is used by the Debian build daemons.)
pt: 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.)

note: type: textblock
en: Note that this will seem to leave a "source package" (.dsc and .tar.gz)  in the parent directory, but that source package should not be used.  It is likely to be broken.  For more information see Debian bug #868527.
pt: 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.

note: type: =head1
en: INSTALLING
pt: INSTALAÇÃO

note: type: textblock
en: You can use C<dpkg -i> to install the .debs that came out of your package.
pt: Você pode usar C<dpkg -i> para instalar os .debs que saíram do seu pacote.

note: type: textblock
en: If the dependencies aren't installed, you will get an error, which can usually be fixed with C<apt-get -f install>.
pt: Se as dependências não estiverem instaladas, vai receber um erro, o que pode ser geralmente corrigido com C<apt-get -f install>.

note: type: =head1
en: Multiarch
pt: Multi-arquitectura

note: type: textblock
en: If you're working on a library package and your system has multiple architectures enabled, you may see something like this:
pt: Se você está a trabalhar num pacote biblioteca e o seu sistema tem várias arquitecturas activas, você pode ver algo como isto:

note: type: textblock
en: The multiarch system used by Debian requires each package which is present for multiple architectures to be exactly the same across all the architectures for which it is installed.
pt: O sistema de multi-arquitectura usado por Debian requer que cada pacote que esteja presente para múltiplas arquitecturas seja exatamente o mesmo entre todas as arquitecturas para quais está instalado.

note: type: textblock
en: The proper solution is to build the package for all the architectures you have enabled.  You'll need a chroot for each of the secondary architectures.  This is somewhat tiresome, even though Debian has excellent tools for managing chroots.  C<sbuild-debian-developer-setup> from the package of the same name and C<sbuild-createchroot> from the C<sbuild> package are good starting points.
pt: A solução apropriada é compilar o pacote para todas as arquitecturas que tem activas.  Você vai precisar duma chroot para cada uma das arquitecturas secundárias.  Isto é um pouco cansativo, mesmo apesar de Debian ter ferramentas excelentes para gerir chroots.  C<sbuild-debian-developer-setup> do pacote com o mesmo nome e C<sbuild-createchroot> do pacote C<sbuild> são bons pontos de partida.

note: type: textblock
en: Otherwise you could deinstall the packages of interest for those other architectures with something like C<dpkg --remove libpcre3:i386>.
pt: Caso contrário você pode desinstalar os pacotes que interessam para as outras arquitecturas com algo como C<dpkg --remove libpcre3:i386>.

note: type: textblock
en: If neither of those are an option, your desperate last resort is to try using the same version number as the official package for your own package.  (The version is controlled by C<debian/changelog> - see above.)  This is not ideal because it makes it hard to tell what is installed, and because it will mislead and confuse apt.
pt: Se nenhuma destas for opção, o seu último recurso desesperado é tentar usar o mesmo número de versão que o pacote oficial para o seu próprio pacote. (A versão é controlada por C<debian/changelog> -veja em cima.)  Isto não é ideal porque torna difícil de perceber o que está instalado, e porque irá confundir e induzir em erro o apt.

note: type: textblock
en: With the "same number" approach you may still get errors like
pt: Com a abordagem "mesmo número" ainda pode ter erros do tipo

note: type: textblock
en: trying to overwrite shared '/usr/include/pcreposix.h', which is different from other instances of package libpcre3-dev
pt: a tentar sobrescreve '/usr/include/pcreposix.h' partilhado, o qual é diferente de outras instâncias do pacote libpcre3-dev

note: type: textblock
en: but passing C<--force-overwrite> to dpkg will help - assuming you know what you're doing.
pt: mas passar C<--force-overwrite> ao dpkg vai ajudar - assumindo que você sabe o que faz.

note: type: =head1
en: SHARING YOUR WORK
pt: PARTILHAR O SEU TRABALHO

note: type: textblock
en: The C<dgit/bookworm,-security> branch (or whatever) is a normal git branch.  You can use C<git push> to publish it on any suitable git server.
pt: O ramo C<dgit/bookworm,-security> (ou qualquer outra coisa) é um ramo git normal.  Você pode usar C<git push> para o publicar em qualquer servidor git apropriado.

note: type: textblock
en: Anyone who gets that git branch from you will be able to build binary packages (.deb)  just as you did.
pt: Qualquer pessoa que obtenha esse ramo git de si será capaz de compilar pacotes (.deb) binário tal como você fez.

note: type: textblock
en: If you want to contribute your changes back to Debian, you should probably send them as attachments to an email to the L<Debian Bug System|https://bugs.debian.org/> (either a followup to an existing bug, or a new bug).  Patches in C<git-format-patch> format are usually very welcome.
pt: Se você deseja contribuir as suas alterações de volta para Debian, deve provavelmente envia-las com o anexos em um email para o L<Debian Bug System|https://bugs.debian.org/> (seja no seguimento de um bug existente, ou num novo bug).  Patches em formato C<git-format-patch> são geralmente bem recebidas.

note: type: =head2
en: Source packages
pt: Pacotes fonte

note: type: textblock
en: The git branch is not sufficient to build a source package the way Debian does.  Source packages are somewhat awkward to work with.  Indeed many plausible git histories or git trees cannot be converted into a suitable source package.  So I recommend you share your git branch instead.
pt: 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.

note: type: textblock
en: If a git branch is not enough, and you need to provide a source package but don't care about its format/layout (for example because some software you have consumes source packages, not git histories)  you can use this recipe to generate a C<3.0 (native)> source package, which is just a tarball with accompanying .dsc metadata file:
pt: 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 C<3.0 (nativo)>, o que é apenas um tarball com acompanhado dum ficheiro de metadados .dsc:

note: type: textblock
en: If you need to provide a good-looking source package, be prepared for a lot more work.  You will need to read much more, perhaps starting with L<dgit-nmu-simple(7)>, L<dgit-sponsorship(7)> or L<dgit-maint-*(7)>
pt: 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 L<dgit-nmu-simple(7)>, L<dgit-sponsorship(7)> ou L<dgit-maint-*(7)>

note: type: =head1
en: INSTALLING NEWER DGIT ON OLDER DISTROS
pt: INSTALAR O NOVO DGIT EM DISTRIBUIÇÕES ANTIGAS

note: type: textblock
en: If dgit breaks with the source package you are working with, this might be due to a bug which would be fixed by upgrading.
pt: Se o dgit quebrar com o pacote fonte em que está a trabalhar, isto pode ser devido a um bug que deveria ser corrigido por uma atualização.

note: type: textblock
en: You can probably directly C<apt install> the latest version of dgit.deb from Debian stable, or Debian testing.
pt: Você pode provavelmente C<apt install> diretamente a versão mais recente do dgit.deb de Debian stable, ou Debian testing.

note: type: textblock
en: Versions of dgit from Debian 13 (trixie) onwards document their installability on old releases in the manpage.  For example, for current Debian testing, see L<https://manpages.debian.org/testing/dgit/dgit.1.en.html>, and look in the section SUPPORT ON OLD DISTRIBUTIONS.
pt: Versões do dgit a partir de Debian 13 (trixie) daqui em diante documentam a sua instabilidade dos lançamentos antigos no manual.  Por exemplo, para Debian testing atual, veja L<https://manpages.debian.org/testing/dgit/dgit.1.en.html>, e consulte a secção SUPORTE EM DISTRIBUIÇÕES ANTIGAS.
