dgit 13.12_dgit-nmu-simple_7 - en to pt translation catalogue (33 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-nmu-simple - tutorial for DDs wanting to NMU with git
pt: dgit-nmu-simple - tutorial para DDs que querem fazer NMU com o git

note: type: =head1
en: INTRODUCTION AND SCOPE
pt: INTRODUÇÃO E ESCOPO

note: type: textblock
en: This tutorial describes how a Debian Developer can do a straightforward NMU of a package in Debian, working (only) in git.
pt: Este tutorial descreve como um Desenvolvedor Debian pode fazer um NMU direto de um pacote em Debian, trabalhando (apenas) em git.

note: type: textblock
en: This document won't help you decide whether an NMU is a good idea or whether it be well received.  The Debian Developers' Reference has some (sometimes questionable) guidance on this.
pt: Este documento não vai ajuda-lo a decidir se um NMU é uma boa ideia ou se vai ser bem recebido.  O Referência a Desenvolvedores Debian tem algumas orientações sobre isto (por vezes questionáveis).

note: type: textblock
en: Conversely, you do not need to know anything about the usual maintainer's git workflow.  If appropriate, you can work on many different packages, making similar changes, without worrying about the individual maintainers' git practices.
pt: Por outro lado, você não precisa de saber nada sobre o normal fluxo de trabalho git dos maintainers.  Se for apropriado, você pode trabalhar em muitos pacotes diferentes, fazendo alterações semelhantes, sem se preocupar com as práticas git individuais dos maintainers.

note: type: textblock
en: This tutorial only covers changes which can sensibly be expressed as a reasonably small number of linear commits (whether to Debian packaging or to upstream files or both).
pt: Este tutorial apenas cobre alterações que podem ser expressadas sensivelmente como um pequeno número razoável de cometeres lineares (seja para empacotamento Debian ou para ficheiros do autor ou ambos).

note: type: textblock
en: If you want to do a new upstream version, you probably want to do as the maintainer would have done.  You'll need to find out what the maintainer's git practices are and consult the appropriate C<dgit-maint-*(7)> workflow tutorial,
pt: Se você deseja fazer uma nova versão de autor, vai provavelmente querer fazer como o maintainer teria feito.  Você precisa de descobrir quais são as práticas git do maintainer e consultar o tutorial de fluxo de trabalho C<dgit-maint-*(7)> apropriado.

note: type: verbatim
en:     % dgit clone glibc bookworm
        % cd glibc
        % git am ~/glibc-security-fix.diff
        % dch --nmu "Apply upstream's fix for foo bug."
        % git add debian/changelog && git commit -m"NMU changelog entry"
        % dpkg-buildpackage -uc -b
        [ run your tests ]
        % dch -r && git add debian/changelog && git commit -m"Finalise NMU"
        % dgit -wgf sbuild -A -d trixie
        [ any final tests on generated .debs ]
        % dgit -wgf [--delayed=5] push-source bookworm
        [ enter your gnupg passphrase as prompted ]
        [ see that push and upload are successful ]
        [ prepare and email NMU diff (git-diff, git-format-patch) ]
pt:     % dgit clone glibc bookworm
        % cd glibc
        % git am ~/glibc-security-fix.diff
        % dch --nmu "Apply upstream's fix for foo bug."
        % git add debian/changelog && git commit -m"NMU changelog entry"
        % dpkg-buildpackage -uc -b
        [ correr os seus testes ]
        % dch -r && git add debian/changelog && git commit -m"Finalise NMU"
        % dgit -wgf sbuild -A -d trixie
        [ quaisquer testes finais nos .debs gerados ]
        % dgit -wgf [--delayed=5] push-source bookworm
        [ insira a sua frase-passe gnupg quando pedida ]
        [ veja se o empurrar e o envio tiveram sucesso ]
        [ prepare e envie email do diff do NMU (git-diff, git-format-patch) ]

note: type: =head1
en: WHAT KIND OF CHANGES AND COMMITS TO MAKE
pt: QUE TIPO DE ALTERAÇÕES E COMETERES A FAZER

note: type: textblock
en: When preparing an NMU, the git commits you make on the dgit branch should be simple linear series of commits with good commit messages.  The commit messages will be published in various ways, including perhaps being used as the cover messages for generated quilt patches.
pt: Quando preparar um NMU, o cometer de git que fizer no ramo dgit deve ser uma série de cometeres lineares simples com boas mensagens do cometido.  As mensagens do cometido irão ser publicadas de várias maneiras, incluindo talvez serem usadas como mensagens de capa para as patches quilt geradas.

note: type: textblock
en: Do not make merge commits.  Do not try to rebase to drop existing patches - if you need to revert a change which is actually a Debian patch, use git-revert.
pt: Não faça cometeres de fusão.  Não tente re-basear para deitar fora patches existentes - se precisar de reverter uma alteração que é realmente uma patch Debian, use git-revert.

note: type: textblock
en: If you need to modify a Debian patch, make a new commit which fixes what needs fixing, and explain in the commit message which patch it should be squashed with (perhaps by use of a commit message in C<git rebase --autosquash -i> format).
pt: Se você precisar modificar uma patch Debian, faça um novo cometer que corrija o que precisa ser corrigido, e explique na mensagem do cometido qual patch deve ser esborrachada (talvez usando uma mensagem do cometido no formato C<git rebase --autosquash -i>).

note: type: textblock
en: (Of course if you have specific instructions from the maintainer, you can follow those instead.  But the procedure in this tutorial is legitimate for any maintainer, in the sense that it should generate an upload to which the maintainer cannot reasonably object.)
pt: (É claro que se você tiver instruções específicas do maintainer, você pode seguir essas em vez destas.  Mas o procedimento deste tutorial é legítimo para qualquer maintainer, no sentido que deve gerar um envio para o qual o maintainer não pode razoavelmente objetar.)

note: type: =head1
en: PREPARING AND REVISING THE LOCAL BRANCH
pt: PREPARANDO E REVISANDO O RAMO LOCAL

note: type: textblock
en: The dgit/sid branch is a normal local git branch tracking a (synthetic) upstream branch.  So you can freely rewrite any commits that you have made locally and haven't pushed anywhere, as normal,
pt: O ramo dgit/sid é um ramo git local normal que segue um ramo do autor (sintético).  Assim você pode livremente rescrever quaisquer cometidos que fez localmente e não os empurrou para lado nenhum, como é normal.

note: type: textblock
en: The one thing that's weird is the "quilt fixup" commits (that turn up if you do eg dgit sbuild).  If you're rebasing them at all, you can and should just drop them; dgit will then regenerate them as needed.
pt: Uma coisa que é esquisita é os cometeres "quilt fixup" (que aparecem se você fizer ex dgit sbuild).  Se você estiver a re-basear-los de todo, você pode e deve apenas larga-los; o dgit irá depois regenera-los conforme necessário.

note: type: textblock
en: All of this follows from one underlying fact:
pt: Tudo isto baseia-se num facto subjacente:

note: type: textblock
en: dgit doesn't have invisible git state somewhere.  So if you rebase away the quilt fixup, and rework your branch, your branch is still good because it looks just like it would do, if you'd just made those commits straight off.  (NB git-debrebase B<does> have weird off-branch state.)
pt: O dgit não tem estado git invisível em nenhum lado.  Assim se você re-basear para fora o quilt fixup, e re-trabalhar o seu ramo, o seu ramo vai continuar bem porque parece-se tal como ficava se você apenas fizesse esses cometeres diretamente. (NB git-debrebase B<tem> um estado fora-de-ramo esquisito.)

note: type: =head1
en: RELEVANT BRANCHES
pt: RAMOS RELEVANTES

note: type: textblock
en: dgit clone will put you on a branch like C<dgit/sid>.  There is a pseudo-remote called C<dgit> which also contains a branch like C<dgit/sid>, so you do things like C<git diff dgit/dgit/sid> to see what changes you have made.
pt: O dgit clone irá coloca-lo num ramo como C<dgit/sid>.  Existe um pseudo-remoto chamado C<dgit> que também contém um ramo como C<dgit/sid>, então você faz coisas como C<git diff dgit/dgit/sid> para ver as alterações que você fez.

note: type: =head1
en: KEEPING YOUR WORKING TREE TIDY
pt: MANTER A SUA ÁRVORE DE TRABALHO ORGANIZADA

note: type: textblock
en: Don't forget to C<git add> any new files you create.  Otherwise git clean (which is requested with the C<-wgf> option in the recipe above)  will delete them.
pt: Não esqueça de fazer C<git add> a quaisquer novos ficheiros que crie.  Caso contrário o git clean (que é requisitado com a opção C<-wgf> na receita em cima) irá apaga-los.

note: type: textblock
en: Many package builds leave dirty git trees.  So, commit before building.  That way you can use C<git reset --hard>.
pt: Muitas compilações de pacote deixam as árvores git sujas.  Assim, cometer antes de compilar.  Desse modo você pode usar C<git reset --hard>.

note: type: textblock
en: If you follow this approach you don't need to care about the build dirtying the tree.  It also means you don't care about the package clean target, which is just as well because many package clean targets are broken.
pt: Se você seguir esta abordagem não precisa de se preocupar com o sujar da compilação na árvore.  Também significa que não se preocupa com o alvo de limpeza do pacote, o que também está bem porque muitos alvos de limpeza de pacote estão estragados.

note: type: =head1
en: OTHER GIT BRANCHES
pt: OUTROS RAMOS GIT

note: type: textblock
en: The dgit git history (visible in gitk and git log)  is not necessarily related to the maintainer's or upstream's git history (if any).
pt: O histórico git do dgit (visível com gitk e o log do git)  não está necessariamente relacionado com o histórico git do maintainer ou do autor (se existir).

note: type: textblock
en: If the maintainer has advertised a git repo with Vcs-Git dgit will set up a remote for it, so you can do
pt: Se o maintainer publicitou um repositório git com Vcs-Git, o dgit irá configurar um remoto para ele, assim você pode fazer

note: type: textblock
en: You can cherry pick changes from there, for example.  Note that the maintainer's git history may not be suitable for use with dgit.  For example, it might be a patches-unapplied branch or even contain only a debian/ directory.
pt: Você pode escolher alterações a partir de lá, por exemplo.  Note que o histórico git do maintainer pode não ser apropriado para usar com o dgit.  Por exemplo, pode existir um ramo de patches-não-aplicadas ou até conter apenas um directório debian/.

note: type: =head1
en: UPLOADING TO DELAYED
pt: ENVIAR PARA ATRASADO

note: type: textblock
en: You can use dgit's I<--delayed> option to upload to the DELAYED queue.  However, you should read the warning about this option in dgit(1).
pt: Você pode usar a opção I<--delayed> do dgit para enviar para a fila de espera ATRASADA.  No entanto, você deve ler o aviso sobre esta opção em dgit(1).
