dgit 13.12_dgit-maint-merge_7 - en to pt translation catalogue (80 entries)

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

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

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

note: type: textblock
en: dgit - tutorial for package maintainers, using a workflow centered around git-merge(1)
pt: dgit - tutorial para maintainers de pacote, usando o fluxo de trabalho centrado em redor do git-merge(1)

note: type: textblock
en: Git histories should be the non-linear histories produced by git-merge(1), preserving all information about divergent development that was later brought together.
pt: Histórias git devem ser as histórias não-lineares produzidas pelo git-merge(1), preservando toda a informação acerca de desenvolvimento divergente que foi mais tarde juntado.

note: type: textblock
en: Maintaining convenient and powerful git workflows takes priority over the usefulness of the raw Debian source package.  The Debian archive is thought of as an output format.
pt: Manter fluxos de trabalho convenientes e poderosos tem prioridade sobre a utilidade do pacote fonte Debian cru.  O arquivo Debian é pensado como um formato de saída.

note: type: textblock
en: For example, we don't spend time curating a series of quilt patches.  However, in straightforward cases, the information such a series would contain is readily available from B<dgit-repos>.
pt: Por exemplo, nós não passamos tempo a curar uma série de patches quilt.  No entanto, e casos diretos, a informação de tais séries iriam conter a sua prontidão disponível a partir de B<dgit-repos>.

note: type: textblock
en: It is more important to have the Debian package's git history be a descendent of upstream's git history than to use exactly the orig.tar that upstream makes available for download.
pt: é mais importante ter o histórico git do pacote Debian 's git a ser um descendente do histórico git do autor do que usar exatamente o orig.tar que o autor torna disponível para descarregar.

note: type: textblock
en: This workflow is less suitable for some packages.  When the Debian delta contains multiple pieces which interact, or which you aren't going to be able to upstream soon, it might be preferable to maintain the delta as a rebasing patch series.  For such a workflow see for example dgit-maint-debrebase(7) and dgit-maint-gbp(7).
pt: Este fluxo de trabalho é menos apropriado para alguns pacotes.  Quando o delta Debian contém múltiplas peças que interagem, ou quando você não vai poder ir ao autor em breve, pode ser preferível manter o delta como uma série de patches re-baseadas.  Para tal fluxo de trabalho veja por exemplo dgit-maint-debrebase(7) e dgit-maint-gbp(7).

note: type: =head1
en: INITIAL DEBIANISATION
pt: A DEBIANIZAÇÃO INICIAL

note: type: textblock
en: This section explains how to start using this workflow with a new package.  It should be skipped when converting an existing package to this workflow.
pt: Esta secção explica como começar a usar este fluxo de trabalho com um novo pacote.  Deve ser saltada quando se converte um pacote existente para este fluxo de trabalho.

note: type: =head3
en: When upstream tags releases in git
pt: Quando etiquetas de autor são lançadas em git

note: type: textblock
en: Suppose that the latest stable upstream release is 1.2.2, and this has been tagged '1.2.2' by upstream.
pt: Supondo que o lançamento de autor estável mais recente é 1.2.2, e isto foi etiquetado '1.2.2' pelo autor.

note: type: textblock
en: Now go ahead and Debianise your package.  Just make commits on the master branch, adding things in the I<debian/> directory.  If you need to patch the upstream source, just make commits that change files outside of the I<debian/> directory.  It is best to separate commits that touch I<debian/> from commits that touch upstream source, so that the latter can be cherry-picked by upstream.
pt: Agora siga e Debianize o seu pacote.  Faça cometidos no ramo mestre, adicionando coisas no directório I<debian/>.  Se você precisa de aplicar patches na fonte do autor, faça cometidos que alteram  ficheiros fora do directório I<debian/>.  É melhor separar os cometidos que mexem em I<debian/> dos cometidos que mexem na fonte do autor, para que mais tarde possam ser escolhidos pelo autor.

note: type: textblock
en: Note that there is no need to maintain a separate 'upstream' branch, unless you also happen to be involved in upstream development.  We work with upstream tags rather than any branches, except when forwarding patches (see FORWARDING PATCHES UPSTREAM, below).
pt: 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).

note: type: textblock
en: Finally, you need an orig tarball:
pt: Finalmente, você precisa dum tarball original:

note: type: textblock
en: See git-deborig(1) if this fails.
pt: Veja git-deborig(1) se isto falhar.

note: type: textblock
en: This tarball is ephemeral and easily regenerated, so we don't commit it anywhere (e.g. with tools like pristine-tar(1)).
pt: Este tarball é efémero e facilmente regenerado, assim não o cometemos para lado nenhum (ex. com ferramentas como o pristine-tar(1)).

note: type: =head3
en: Verifying upstream's tarball releases
pt: Verificar lançamentos de tarball do autor

note: type: textblock
en: It can be a good idea to compare upstream's released tarballs with the release tags, at least for the first upload of the package.  If they are different, you might need to add some additional steps to your I<debian/rules>, such as running autotools.
pt: Pode ser boa ideia comparar os tarballs de lançamento do autor com as etiquetas de lançamento, pelo menos para o primeiro envio do pacote.  Se forem diferentes, você pode precisar de adicionar alguns passos adicionais ao seu I<debian/rules>, tais como correr ferramentas automáticas.

note: type: textblock
en: A convenient way to perform this check is to import the tarball as described in the following section, using a different value for 'upstream-tag', and then use git-diff(1) to compare the imported tarball to the release tag.  If they are the same, you can use upstream's tarball instead of running git-deborig(1).
pt: Uma maneira conveniente de efetuar este teste é importar o tarball como descrito na secção seguinte, usando um valor diferente para 'upstream-tag', e depois usar git-diff(1) para comparar o tarball importado com a etiqueta de lançamento.  Se forem iguais, você pode usar o tarball do autor em vez de correr git-deborig(1).

note: type: =head3
en: Using untagged upstream commits
pt: Usando cometidos de autor não etiquetados

note: type: textblock
en: Sometimes upstream does not tag their releases, or you want to package an unreleased git snapshot.  In such a case you can create your own upstream release tag, of the form B<upstream/>I<ver>, where I<ver> is the upstream version you plan to put in I<debian/changelog>.  The B<upstream/> prefix ensures that your tag will not clash with any tags upstream later creates.
pt: Por vezes o autor não etiqueta os seus lançamentos, ou você quer empacotar um instantâneo de git não lançado.  Em tais casos você pode criar a sua própria etiqueta de lançamento de autor, no formato B<upstream/>I<ver>, onde I<ver> é a versão de autor que você planeia colocar em I<debian/changelog>.  O prefixo B<upstream/> assegura que a sua etiqueta não vai colidir com nenhumas etiquetas que o autor crie mais tarde.

note: type: textblock
en: For example, suppose that the latest upstream release is 1.2.2 and you want to package git commit ab34c21 which was made on 2013-12-11.  A common convention is to use the upstream version number 1.2.2+git20131211.ab34c21 and so you could use
pt: Por exemplo, suponha que o lançamento mais recente do autor é 1.2.2 e você quer empacotar o cometido git ab34c21 que foi feito em 2013-12-11.  Uma convenção comum é usar a versão de autor número 1.2.2+git20131211.ab34c21 e assim você podia usar

note: type: textblock
en: to obtain a release tag, and then proceed as above.
pt: para obter a etiqueta de lançamento, e depois proceder como em cima.

note: type: textblock
en: One can generate such a versioned tag using git show's --pretty option.  e.g.:
pt: Pode-se gerar tal etiqueta versionada usando a opção --pretty do git show.  exemplo:

note: type: =head3
en: When upstream releases only tarballs
pt: Quando o autor lança apenas tarballs

note: type: textblock
en: We need a virtual upstream branch with virtual release tags.  gbp-import-orig(1) can manage this for us.  To begin
pt: 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

note: type: textblock
en: Now create I<debian/gbp.conf>:
pt: Agora crie I<debian/gbp.conf>:

note: type: textblock
en: gbp-import-orig(1) requires a pre-existing upstream branch:
pt: gbp-import-orig(1) requer um ramo de autor pré-existente:

note: type: textblock
en: Then we can import the upstream version:
pt: Então podemos importar a versão do autor:

note: type: textblock
en: Our upstream branch cannot be pushed to B<dgit-repos>, but since we will need it whenever we import a new upstream version, we must push it somewhere.  The usual choice is B<salsa.debian.org>:
pt: O nosso ramo de autor não pode ser empurrado para B<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 é B<salsa.debian.org>:

note: type: textblock
en: You are now ready to proceed as above, making commits to both the upstream source and the I<debian/> directory.
pt: Agora você está pronto para prosseguir como em cima, fazendo cometidos para ambos a fonte do autor e o directório I<debian/>.

note: type: =head1
en: CONVERTING AN EXISTING PACKAGE
pt: CONVERTER UM PACOTE EXISTENTE

note: type: textblock
en: This section explains how to convert an existing Debian package to this workflow.  It should be skipped when debianising a new package.
pt: Esta secção explica como converter um pacote Debian existente para este fluxo de trabalho.  Deve ser saltada quando se está a debianizar um pacote novo.

note: type: =head2
en: No existing git history
pt: Nenhum histórico git existente

note: type: =head2
en: Existing git history using another workflow
pt: Histórico git existente usando outro fluxo de trabalho

note: type: textblock
en: First, if you don't already have the git history locally, clone it, and obtain the corresponding orig.tar from the archive:
pt: 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:

note: type: textblock
en: Now dump any existing patch queue:
pt: Agora despeje qualquer fila de patch existente:

note: type: textblock
en: Then make new upstream tags available:
pt: Depois torne as novas etiquetas de autor disponíveis:

note: type: textblock
en: Now you simply need to ensure that your git HEAD is dgit-compatible, i.e., it is exactly what you would get if you ran B<dpkg-buildpackage -i'(?:^|/)\.git(?:/|$)' -I.git -S> and then unpacked the resultant source package.
pt: Agora você simplesmente precisa assegurar que o seu CABEÇALHO git é compatível com o dgit, isto é, é exatamente o que obteria se corresse B<dpkg-buildpackage -i'(?:^|/)\.git(?:/|$)' -I.git -S> e depois desempacotasse o pacote fonte resultante.

note: type: textblock
en: To achieve this, you might need to delete I<debian/source/local-options>.  One way to have dgit check your progress is to run B<dgit build-source>.
pt: Para conseguir isto, você pode precisar de apagar I<debian/source/local-options>.  Uma maneira de ter o dgit a verificar o seu progresso é correr B<dgit build-source>.

note: type: textblock
en: The first dgit push will require I<--trust-changelog>.  If this is the first ever dgit push of the package, consider passing I<--deliberately-not-fast-forward> instead of I<--trust-changelog>.  This avoids introducing a new origin commit into your git history.  (This origin commit would represent the most recent non-dgit upload of the package, but this should already be represented in your git history.)
pt: O primeiro dgit push vai requerer I<--trust-changelog>.  Se este é o primeiro dgit push do pacote, considere passar I<--deliberately-not-fast-forward> em vez de I<--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.)

note: type: =head1
en: SOURCE PACKAGE AND GIT CONFIGURATION
pt: PACOTE FONTE E CONFIGURAÇÃO DO GIT

note: type: =head2
en: dgit configuration
pt: configuração do dgit

note: type: textblock
en: We must tell dgit not to try to maintain a linear queue of patches to the upstream source:
pt: Nós temos de dizer ao dgit para não tentar manter uma fila linear de patches para a fonte do autor:

note: type: textblock
en: This command should be executed in each git clone of this package, including your co-maintainer's.  Don't set it more globally, because it is not a good default for working on Debian source packages in general.
pt: 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.

note: type: textblock
en: We set a source package option to help dpkg handle changes to the upstream source:
pt: Nós definimos uma opção de pacote fonte para ajudar o dpkg a lidar com as alterações à fonte do autor:

note: type: textblock
en: You don't need to create this file if you are using the version 1.0 source package format.
pt: Nós não precisamos de criar este ficheiro se estiver a usar a versão 1.0 do formato de pacote fonte.

note: type: =head1
en: BUILDING AND UPLOADING
pt: COMPILAR E ENVIAR

note: type: textblock
en: As another alternative to B<dgit build> and friends, you can use a tool like gitpkg(1).  This works because like dgit, gitpkg(1) enforces that HEAD has exactly the contents of the source package.  gitpkg(1)  is highly configurable, and one dgit user reports using it to produce and test multiple source packages, from different branches corresponding to each of the current Debian suites.
pt: Como outra alternativa para B<dgit build> e amigos, você pode usar uma ferramenta tipo gitpkg(1).  Isto funciona porque como o dgit, o gitpkg(1) força que o CABEÇALHO tenha exatamente o conteúdo do pacote fonte.  O gitpkg(1)  é altamente configurável, e um utilizador do dgit reportou que o usa para produzir e testar múltiplos pacotes fonte, de ramos diferentes correspondentes a cada uma das suites atuais Debian.

note: type: =head1
en: NEW UPSTREAM RELEASES
pt: NOVOS LANÇAMENTOS DO AUTOR

note: type: =head2
en: Obtaining the release
pt: Obtendo o lançamento

note: type: textblock
en: If you want to package an untagged upstream commit (because upstream does not tag releases or because you want to package an upstream development snapshot), see "Using untagged upstream commits" above.
pt: 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.

note: type: textblock
en: You will need the I<debian/gbp.conf> from "When upstream releases only tarballs", above.  You will also need your upstream branch.  Above, we pushed this to B<salsa.debian.org>.  You will need to clone or fetch from there, instead of relying on B<dgit clone>/B<dgit fetch> alone.
pt: Você vai precisar do I<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 B<salsa.debian.org>.  Você vai precisar de clonar ou ir buscar de lá, em vez de confiar apenas em B<dgit clone>/B<dgit fetch>.

note: type: textblock
en: Then, either
pt: Então, ou

note: type: textblock
en: or if you have a working watch file
pt: ou se você tiver um ficheiro watch a funcionar

note: type: textblock
en: In the following, replace I<1.2.3> with I<upstream/1.2.3>.
pt: No seguinte, substitua I<1.2.3> por I<upstream/1.2.3>.

note: type: =head2
en: Reviewing & merging the release
pt: Revisar e fundir o lançamento

note: type: textblock
en: It's a good idea to preview the merge of the new upstream release.  First, just check for any new or deleted files that may need accounting for in your copyright file:
pt: É 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:

note: type: textblock
en: You can then review the full merge diff:
pt: Você pode depois pré-visualizar o diff da fusão completa:

note: type: textblock
en: Once you're satisfied with what will be merged, update your package:
pt: Assim que estiver satisfeito com o que vai ser fundido, atualize o seu pacote:

note: type: textblock
en: If you obtained a tarball from upstream, you are ready to try a build.  If you merged a git tag from upstream, you will first need to generate a tarball:
pt: 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:

note: type: =head1
en: HANDLING DFSG-NON-FREE MATERIAL
pt: MANUSEAR MATERIAL DFSG-NÃO-LIVRE

note: type: textblock
en: We create a DFSG-clean tag to merge to master:
pt: Nós criamos uma etiqueta DFSG-limpo para fundir no mestre:

note: type: textblock
en: Before merging the new 1.2.3+dfsg tag to master, you should first determine whether it would be legally dangerous for the non-free material to be publicly accessible in the git history on B<dgit-repos>.
pt: 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 B<dgit-repos>.

note: type: textblock
en: If it would be dangerous, there is a big problem; in this case please consult your archive administrators (for Debian this is the dgit administrator dgit-owner@debian.org and the ftpmasters ftpmaster@ftp-master.debian.org).
pt: 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).

note: type: textblock
en: The easiest way to handle this is to add a B<Files-Excluded> field to I<debian/copyright>, and a B<uversionmangle> setting in I<debian/watch>.  See uscan(1).  Alternatively, see the I<--filter> option detailed in gbp-import-orig(1).
pt: A maneira mais fácil de lidar com isto é adicionar um campo B<Files-Excluded> a I<debian/copyright>, e uma definição B<uversionmangle> em I<debian/watch>.  Veja uscan(1).  Em alternativa, veja a opção I<--filter> detalhada em gbp-import-orig(1).

note: type: =head1
en: FORWARDING PATCHES UPSTREAM
pt: ENCAMINHAR PATCHES AO AUTOR

note: type: textblock
en: The basic steps are:
pt: Os passos básicos são:

note: type: textblock
en: Create a new branch based off upstream's master branch.
pt: Criar um novo ramo baseado no ramo mestre do autor.

note: type: textblock
en: git-cherry-pick(1) commits from your master branch onto your new branch.
pt: Fazer cometidos git-cherry-pick(1) do seu ramo mestre para o seu novo ramo.

note: type: textblock
en: Push the branch somewhere and ask upstream to merge it, or use git-format-patch(1) or git-request-pull(1).
pt: Empurre o ramo para algum lado e peça ao autor para o fundir, ou use git-format-patch(1) ou git-request-pull(1).

note: type: textblock
en: For example (and it is only an example):
pt: Por exemplo (e é só mesmo um exemplo):

note: type: verbatim
en:     % # fork foo.git on GitHub
        % git remote add -f fork git@github.com:spwhitton/foo.git
        % git checkout -b fix-error upstream/master
        % git config branch.fix-error.pushRemote fork
        % git cherry-pick master^2
        % git push
        % # submit pull request on GitHub
pt:     % # bifurca foo.git em GitHub
        % git remote add -f fork git@github.com:spwhitton/foo.git
        % git checkout -b fix-error upstream/master
        % git config branch.fix-error.pushRemote fork
        % git cherry-pick master^2
        % git push
        % # submete pedido de puxar no GitHub

note: type: textblock
en: Note that when you merge an upstream release containing your forwarded patches, git and dgit will transparently handle "dropping" the patches that have been forwarded, "retaining" the ones that haven't.
pt: Note que quando você funde um lançamento de autor que contém as suas patches encaminhadas, o git e o dgit irão de modo transparente lidar como "largar" as patches que foram encaminhadas, e "reter" as que não foram.

note: type: =head1
en: INCORPORATING NMUS
pt: INCORPORAR NMUS

note: type: textblock
en: Alternatively, you can apply the NMU diff to your repository.  The next push will then require I<--trust-changelog>.
pt: Em alternativa, você pode aplicar o diff NMU no seu repositório.  O próximo empurrar irá então requerer I<--trust-changelog>.

note: type: =head1
en: AUTHOR
pt: AUTOR

note: type: textblock
en: This tutorial was written and is maintained by Sean Whitton <spwhitton@spwhitton.name>.  It contains contributions from other dgit contributors too - see the dgit copyright file.
pt: Este tutorial foi escrito e é mantido por Sean Whitton <spwhitton@spwhitton.name>.  Contém contributos de outros contribuidores do dgit também - veja o ficheiro copyright do dgit.
