dgit 13.17 dgit_7 - en to pt translation catalogue (97 entries)

note: type: TH
en: Debian Project
pt: Projeto Debian

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

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

note: type: Plain text
en: dgit - principles of operation
pt: dgit - princípios de operação

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

note: type: Plain text
en: B<dgit> treats the Debian archive as a version control system, and bidirectionally gateways between the archive and git.  The git view of the package can contain the usual upstream git history, and will be augmented by commits representing uploads done by other developers not using dgit.  This git history is stored in a canonical location known as B<dgit-repos> which lives on a dedicated git server.
pt: O B<dgit> trata o arquivo Debian como um sistema de controle de versão, e usa gateways bidirecionais entre o arquivo e git.  A vista git do pacote pode conter o histórico git usual do autor, e será aumentado por cometidos que representam envios feitos por outros desenvolvedores que não usam o dgit.  Este histórico git é guardado numa localização canónica conhecida como B<dgit-repos> que vive num servidor git dedicado.

note: type: Plain text
en: git branches suitable for use with dgit can be edited directly in git, and used directly for building binary packages.  They can be shared using all conventional means for sharing git branches.  It is not necessary to use dgit to work with dgitish git branches.  However, dgit is (usually) needed in order to convert to or from Debian-format source packages.
pt: os ramos git apropriados para se usar com dgit podem ser editados diretamente em git, e usados diretamente para compilar pacotes binário.  Eles podem ser partilhados usando todos os meios convencionais para partilhar ramos git.  Não é necessário usar o dgit para trabalhar com ramos git em modo dgit.  No entanto, o dgit é (geralmente) necessário de modo a converter para ou de pacotes fonte de formato Debian.

note: type: Plain text
en: Reference manual and documentation catalogue.
pt: Manual de referência e catálogo de documentação.

note: type: Plain text
en: Tutorials and workflow guides.  See dgit(1) for a list.
pt: Tutoriais e guias de fluxo de trabalho.  Veja dgit(1) para uma lista.

note: type: SH
en: MODEL
pt: MODELO

note: type: Plain text
en: You may use any suitable git workflow with dgit, provided you satisfy dgit's requirements:
pt: Você pode usar qualquer fluxo de trabalho git apropriado com o dgit, desde que satisfaça os requerimentos do dgit:

note: type: Plain text
en: dgit maintains a pseudo-remote called B<dgit>, with one branch per suite.  This remote cannot be used with plain git.
pt: o dgit mantém um pseudo-remoto chamado B<dgit>, com um ramo por suite.  Este remoto não pode ser usado com git simples.

note: type: Plain text
en: The B<dgit-repos> repository for each package contains one ref per suite named B<refs/dgit/>I<suite>.  These should be pushed to only by dgit.  They are fast forwarding.  Each push on this branch corresponds to an upload (or attempted upload).
pt: O repositório B<dgit-repos> para cada pacote contém uma referência por suite chamada B<refs/dgit/>I<suite>.  Para estes só se deve empurrar pelo dgit.  São de avanço rápido  Cada empurrar neste ramo corresponde a um envio (ou envio tentado).

note: type: Plain text
en: However, it is perfectly fine to have other branches in dgit-repos; the dgit-repos repo for the package can even be the same as the `origin' remote, although this is not generally the case in Debian.
pt: No entanto, não há problema em ter outros ramos no dgit-repos; o repositório dgit-repos para o pacote pode até ser o mesmo que o remoto `origin', apesar de isto não ser geralmente o caso em Debian.

note: type: Plain text
en: dgit push-* will also make signed tags called B<archive/debian/>I<version> (with version encoded a la DEP-14)  and push them to dgit-repos.  These are used at the server to authenticate pushes.
pt: dgit push-* irá também fazer etiquetas assinadas chamadas B<archive/debian/>I<versão> (com versão codificada em DEP-14)  e empurra-as para o dgit-repos.  Estas são usadas no servidor para autenticar o que é empurrado.

note: type: Plain text
en: Uploads made by dgit contain an additional field B<Dgit> in the source package .dsc.  (This is added by dgit push-*.)  This specifies: a commit (an ancestor of the dgit/suite branch) whose tree is identical to the unpacked source upload; the distro to which the upload was made; a tag name which can be used to fetch the git commits; and a url to use as a hint for the dgit git server for that distro.
pt: Envios feitos pelo dgit contêm um campo adicional B<Dgit> no pacote fonte .dsc.  (Isto é adicionado por dgit push-*.)  Isto especifica: um cometido (um antepassado do ramo dgit/suite) cuja árvore é idêntica ao envio de fonte desempacotada; a distribuição para a qual o envio foi feito; um nome de etiqueta que pode ser usado para ir buscar os cometidos git; e um url para usar como dica para o servidor git dgit para essa distribuição.

note: type: Plain text
en: Uploads not made by dgit are represented in git by commits which are synthesised by dgit.  The tree of each such commit corresponds to the unpacked source; there is a commit with the contents, and a pseudo-merge from last known upload - that is, from the contents of the dgit/suite branch.  Depending on the source package format, the contents commit may have a more complex structure, but ultimately it will be a convergence of stubby branches from origin commits representing the components of the source package.
pt: Os envios não feitos pelo dgit são representados em git por cometidos que são sintetizados pelo dgit.  A árvore de cada tal cometido corresponde à fonte desempacotada; há um cometido com o conteúdo, e uma pseudo-fusão a partir do último envio conhecido - isto é, a partir do conteúdo do ramo dgit/suite.  Dependendo do formato do pacote fonte, o cometido de conteúdo pode ter uma estrutura mais complexa, mas no final irá ser uma convergência de ramos pequeninos a partir cometidos de origem que representam os componentes do pacote fonte.

note: type: Plain text
en: dgit expects trees that it works with to have a B<dgit> (pseudo) remote.  This refers to the dgit-created git view of the corresponding archive.
pt: O dgit espera que as árvores com que trabalha tenham um B<dgit> (pseudo) remoto.  Isto refere-se à vista git criada por dgit do arquivo correspondente.

note: type: Plain text
en: The dgit archive tracking view is synthesised locally, on demand, by each copy of dgit.  The tracking view is always a descendant of the dgit-repos suite branch (if one exists), but may be ahead of it if uploads have been done without dgit.  The archive tracking view is always fast forwarding within each suite.
pt: A vista de acompanhamento do arquivo dgit é sintetizada localmente, a pedido, por cada cópia do dgit.  A vista de acompanhamento é sempre um descendente do ramo de suite dgit-repos (se um existir), mas pode estar à frente dele se foram feitos envios sem o dgit.  A vista de acompanhamento do arquivo é sempre de avanço rápido dentro de cada suite.

note: type: Plain text
en: dgit push-* can operate on any commit which is a descendant of the suite tracking branch.
pt: dgit push-* pode operar em qualquer cometido que seja um descendente do ramo de acompanhamento da suite.

note: type: Plain text
en: dgit does not make a systematic record of its imports of orig tarball(s).  So it does not work by finding git tags or branches referring to orig tarball(s).  The orig tarballs are downloaded (by dgit clone) into the parent directory, as with a traditional (non-gitish) dpkg-source workflow.  You need to retain these tarballs in the parent directory for dgit build and dgit push-*.  (They are not needed for purely-git-based workflows.)
pt: O dgit não faz um registo sistemático das suas importações de tarball(s) de origem.  Assim não funciona ao encontrar etiquetas ou ramos git que façam referência a tarball(s) de origem.  Os tarballs de origem são descarregados (por dgit clone) para o directório pai, como um fluxo de trabalho tradicional (não-à-git) do dpkg-source.  Você precisa de reter estes tarballs no directório pai para o dgit build e dgit push-*.  (Eles não são necessários para fluxos de trabalho puramente-baseados-em-git.)

note: type: Plain text
en: dgit repositories could be cloned with standard (git) methods.  However, the dgit repositories do not contain uploads not made with dgit.  And for sourceful builds / uploads the orig tarball(s) will need to be present in the parent directory.
pt: Os repositórios dgit podiam ser clonados com métodos standard (git).  No entanto, os repositórios dgit não contêm envios não feitos com dgit.  E para compilações / envios de fonte abundante os tarball(s) de origem precisam estar presentes no directório pai.

note: type: Plain text
en: To a user looking at the archive, changes pushed in a simple NMU using dgit look like reasonable changes made in an NMU: in a `3.0 (quilt)' package the delta from the previous upload is recorded in new patch(es) constructed by dpkg-source.
pt: Para um utilizador a olhar para um arquivo, as alterações empurradas num NMU simples a usar dgit parecem alterações razoáveis feitas num NMU: num pacote `3.0 (quilt)' o delta do envio anterior é guardado em novas patch(es) construídas pelo dpkg-source.

note: type: SH
en: COMBINED SUITES
pt: SUITES COMBINADAS

note: type: Plain text
en: dgit can synthesize a combined view of several underlying suites.  This is requested by specifying, for I<suite,> a comma-separated list:
pt: O dgit pode sintetizar uma vista combinada de várias suites subjacentes.  Isto é requisitado ao especificar uma lista separada por vírgulas, por I<suite,>:

note: type: Plain text
en: This facility is available with dgit clone, fetch and pull, only.
pt: Esta facilidade está disponível com dgit clone, apenas busca e puxa.

note: type: Plain text
en: dgit will fetch the same package from each specified underlying suite, separately (as if with dgit fetch).  dgit will then generate a pseudomerge commit on the tracking branch B<remotes/dgit/dgit/>I<suite> which has the tip of each of the underlying suites as an ancestor, and which contains the same as the suite which has the highest version of the package.
pt: O dgit vai buscar o mesmo pacote de cada suite subjacente especificada, em separado (como se com dgit fetch).  O dgit vai depois gerar um cometido de pseudo-fusão no ramo de acompanhamento B<remotes/dgit/dgit/>I<suite> o qual tem a ponta de cada uma das suites subjacentes como um antepassado, e que contem o mesmo que a suite que tiver a versão mais alta do pacote.

note: type: Plain text
en: The package must exist in mainsuite, but need not exist in the subsuites.
pt: O pacote tem de existir na suite principal, mas não precisa existir nas sub-suites.

note: type: Plain text
en: If a specified subsuite starts with B<-> then mainsuite is prepended.
pt: Se uma sub-suite especificada começar com B<-> então é prefixado mainsuite.

note: type: Plain text
en: So, for example, B<stable,-security> means to look for the package in stable, and stable-security, taking whichever is newer.  If stable is currently trixie, dgit clone would leave you on the branch B<dgit/trixie,-security>.
pt: Assim, por exemplo, B<stable,-security> significa procurar o pacote em stable, e stable-security, tomando qual deles for mais recente.  Se stable for atualmente trixie, o dgit clone iria deixa-lo no ramo B<dgit/trixie,-security>.

note: type: Plain text
en: Combined suites are not supported by the dgit build operations.  This is because those options are intended for building for uploading source packages, and look in the changelog to find the relevant suite.  It does not make sense to name a dgit-synthesised combined suite in a changelog, or to try to upload to it.
pt: Suites combinadas não são suportadas pelas operações de compilação do dgit.  Isto porque essas opções destinam-se para compilação para enviar pacotes fonte, e procurar no registo de alterações para encontrar a suite relevante.  Não faz sentido nomear uma suite combinada sintetizada pelo dgit num registo de alterações, ou tentar enviar para ela.

note: type: Plain text
en: When using this facility, it is important to always specify the same suites in the same order: dgit will not make a coherent fast-forwarding history view otherwise.
pt: Ao usar esta facilidade, é importante especificar sempre as mesmas suites na mesma ordem: caso contrário o dgit não irá fazer uma vista de histórico de avanço rápido coerente.

note: type: Plain text
en: The history generated by this feature is not normally suitable for merging back into upstreams, as it necessarily contains unattractive pseudomerges.
pt: O histórico gerado por esta funcionalidade não é normalmente apropriado para fundir de volta em autorias, pois contém necessariamente pseudo-fusões não atrativas.

note: type: SH
en: LIMITATIONS
pt: LIMITAÇÕES

note: type: Plain text
en: Because the synthesis of the suite tracking branches is done locally based only on the current archive state, it will not necessarily see every upload not done with dgit.  Also, different versions of dgit (or the software it calls)  might import the same .dscs differently (although we try to minimise this).  As a consequence, the dgit tracking views of the same suite, made by different instances of dgit, may vary.  They will have the same contents, but may have different history.
pt: Porque a síntese dos ramos de acompanhamento de suite é feita localmente com base apenas no estado do arquivo atual, não irá necessariamente ver todos os envios não feitos com o dgit.  Também, versões diferentes do dgit (ou do software que ele chama)  podem importar os mesmos .dscs de maneira diferente (apesar de tentarmos minimizar isto).  Como consequência, as vistas de acompanhamento do dgit da mesma suite, feita por instâncias diferentes do dgit, podem variar.  Elas irão ter o mesmo conteúdo, mas podem ter um histórico diferente.

note: type: Plain text
en: There is no uniform linkage between the tracking branches for different suites.  The Debian infrastructure does not do any automatic import of uploads made without dgit.  It would be possible for a distro's infrastructure to do this; in that case, different dgit client instances would see exactly the same history.
pt: Não há nenhuma vinculação uniforme entre os ramos de acompanhamento para suites diferentes.  A infraestrutura Debian não faz nenhuma importação automática dos envios feitos sem o dgit.  Seria possível para uma infraestrutura de distribuição fazer isto; nesse caso, diferentes instâncias de clientes dgit iriam ver exatamente o mesmo histórico.

note: type: Plain text
en: There has been no bulk import of historical uploads into Debian's dgit infrastructure.  To do this it would be necessary to decide whether to import existing vcs history (which might not be faithful to dgit's invariants)  or previous non-Dgit uploads (which would not provide a very rich history).
pt: Não tem havido nenhuma importação a granel de envios históricos para a infraestrutura dgit de Debian.  Para fazer isto seria necessário decidir se devemos importar históricos vcs existentes (que podem não ser fiéis às invariantes do dgit) ou envios não-Dgit anteriores (que não iriam fornecer um histórico muito rico).

note: type: Plain text
en: git represents only file executability.  git does not represent empty directories, or any leaf objects other than plain files and symlinks.  The behaviour of Debian source package formats on objects with unusual permissions is complicated.  Some pathological Debian source packages will no longer build if empty directories are pruned (or if other things not reproduced by git are changed).  Such sources cannot be worked with properly in git, and therefore not with dgit either.
pt: O git representa apenas executabilidade de ficheiros.  O git não representa directórios vazios, ou quaisquer objetos folha para além de ficheiros simples e links simbólicos.  O comportamento dos formatos de pacote fonte Debian em objetos com permissões não usuais é complicado.  Alguns pacotes fonte Debian patológicos não irão mais compilar se os directórios vazios forem podados (ou se outras coisas não reproduzidas por git forem alteradas).  Tais fontes não pode ser trabalhadas de modo apropriado em git, e por isso também não com dgit.

note: type: SH
en: READ-ONLY DISTROS
pt: DISTRIBUIÇÕES APENAS-LEITURA

note: type: Plain text
en: Distros which do not maintain a set of dgit history git repositories can still be used in a read-only mode with dgit.  Currently Ubuntu is configured this way.
pt: Distribuições que não mantêm um conjunto de repositórios git com histórico dgit podem ainda ser usadas num modo de só-leitura com dgit.  Atualmente Ubuntu está configurada desta maneira.

note: type: SH
en: GITATTRIBUTES
pt: ATRIBUTOS DO GIT

note: type: Plain text
en: git has features which can automatically transform files as they are being copied between the working tree and the git history.  The attributes can be specified in the source tree itself, in B<.gitattributes>.  See B<gitattributes>(5).
pt: O git tem funcionalidades que podem transformar ficheiros automaticamente quando estão a ser copiados entre a árvore de trabalho e o histórico git.  Os atributos podem ser especificados na própria árvore fonte, em B<.gitattributes>.  Veja B<gitattributes>(5).

note: type: Plain text
en: These transformations are context-sensitive and not, in general, reversible, so dgit operates on the principle that the dgit git history contains the actual contents of the package.  (When dgit is manipulating a .dsc, it does so in a private area, where the transforming gitattributes are defused, to achieve this.)
pt: Estas transformações são sensíveis ao contexto e não são, em geral, revertíveis, assim o dgit opera no principio que o histórico git do dgit contem o conteúdo atual do pacote.  (Quando o dgit manipula um .dsc, fá-lo numa área privada, onde os atributos git de transformação são desarmados para se obter isto.)

note: type: Plain text
en: If transforming gitattributes are used, they can cause trouble, because the working tree files can differ from the git revision history (and therefore from the source packages).  dgit warns if it finds a .gitattributes file (in a package being fetched or imported), unless the transforming gitattributes have been defused.
pt: Se os atributos git de transformação forem usados, eles podem causar problemas, porque os ficheiros da árvore de trabalho podem ser diferentes do histórico de revisão git (e assim dos pacotes fonte).  O dgit avisa se encontrar um ficheiro .gitattributes (no pacote a ser procurado ou importado), a menos que os atributos git de transformação tenham sido desarmados.

note: type: Plain text
en: dgit clone and dgit setup-new-tree disable transforming gitattributes by default, by creating a suitable .git/info/attributes.  See B<dgit setup-new-tree> and B<dgit setup-gitattributes> in dgit(1).
pt: Os dgit clone e dgit setup-new-tree desativam os atributos git de transformação por predefinição, ao criar um .git/info/attributes apropriado.  Veja B<dgit setup-new-tree> e B<dgit setup-gitattributes> em dgit(1).

note: type: Plain text
en: If upstream relies on gitattributes for anything important, you must reproduce the effect in debian/rules and/or a Debian-specific patch.
pt: Se o autor confia em atributos git para qualquer coisa importante, você tem de reproduzir o efeito em debian/rules e/ou um caminho especifico de Debian.

note: type: SH
en: PACKAGE SOURCE FORMATS
pt: FORMATOS FONTE DE PACOTE

note: type: Plain text
en: If you are not the maintainer, you do not need to worry about the source format of the package.  You can just make changes as you like in git.  If the package is a `3.0 (quilt)' package, the patch stack will usually not be represented in the git history.
pt: Se você não é um maintainer, não precisa de se preocupar com o formato fonte do pacote.  Você pode apenas fazer as alterações que quer em git.  Se o pacote for um pacote `3.0 (quilt)', a pilha de patch não será geralmente representada no histórico git.

note: type: SH
en: FILE EXECUTABILITY
pt: EXECUTABILIDADE DO FICHEIRO

note: type: Plain text
en: Debian source package formats do not always faithfully reproduce changes to executability.  But dgit insists that the result of dgit clone is identical (as far as git can represent - see Limitations, above)  to the result of dpkg-source -x.
pt: Os formatos de pacote fonte Debian nem sempre reproduzem fielmente alterações para executabilidade.  Mas o dgit insiste que o resultado do dgit clone seja idêntico (até onde o git consegue representar - veja Limitações, em cima) ao resultado de dpkg-source -x.

note: type: Plain text
en: So files that are executable in your git tree must be executable in the result of dpkg-source -x (but often aren't).  If a package has such troublesome files, they have to be non-executable in dgit-compatible git branches.
pt: Assim os ficheiros que são executáveis na sua árvore git têm de ser executáveis no resultado de dpkg-source -x (mas muitas vezes não são).  Se um pacote tem tais ficheiros problemáticos, eles têm de ser não executáveis nos ramos git compatíveis com dgit.

note: type: SH
en: FORMAT 3.0 (QUILT)
pt: FORMATO 3.0 (QUILT)

note: type: Plain text
en: For a format `3.0 (quilt)' source package, dgit may have to make a commit on your current branch to contain metadata used by quilt and dpkg-source.
pt: Para um formato de pacote fonte `3.0 (quilt)', o dgit pode ter de fazer um cometido no seu ramo atual para conter metadados usados por quilt e dpkg-source.

note: type: Plain text
en: This is because `3.0 (quilt)' source format represents the patch stack as files in debian/patches/ actually inside the source tree.  This means that, taking the whole tree (as seen by git or ls) (i)  dpkg-source cannot represent certain trees, and (ii) packing up a tree in `3.0 (quilt)' and then unpacking it does not always yield the same tree.
pt: Isto porque o formato fonte `3.0 (quilt)' representa a pilha de patch como ficheiros em debian/patches/ realmente dentro da árvore fonte.  Isto significa que, tomar a árvore inteira (como visto por git ou ls) (1) o dpkg-source não pode representar certas árvores, e (2) empacotar uma árvore em `3.0 (quilt)' e depois desempacota-la nem sempre resulta na mesma árvore.

note: type: Plain text
en: dgit will automatically work around this for you when building and pushing.  The only thing you need to know is that dgit build, sbuild, etc., may make new commits on your HEAD.  If you're not a quilt user this commit won't contain any changes to files you care about.
pt: O dgit irá contornar isto automaticamente para si ao compilar e empurrar.  A única coisa que precisa de saber é que dgit build, sbuild, etc., pode fazer novos cometidos no seu CABEÇALHO.  Se você não for um utilizador de quilt este cometido não vai conter nenhumas alterações a ficheiros do seu interesse.

note: type: Plain text
en: Simply committing to source files (whether in debian/ or not, but not to patches)  will result in a branch that dgit quilt-fixup can linearise.  Other kinds of changes, including editing patches or merging, cannot be handled this way.
pt: Cometer simplesmente para ficheiros fonte (seja em debian/ ou não, mas não para patches)  irá resultar num ramo que o dgit quilt-fixup pode linearizar.  Outro tipo de alterações, incluindo editar patches ou fundir, não pode ser lidado deste modo.

note: type: Plain text
en: You can explicitly request that dgit do just this fixup, by running dgit quilt-fixup.
pt: Você pode requerer explicitamente que o dgit faça apenas esta correção, ao correr dgit quilt-fixup.

note: type: Plain text
en: If you are a quilt user you need to know that dgit's git trees are `patches applied packaging branches' and do not contain the .pc directory (which is used by quilt to record which patches are applied).  If you want to manipulate the patch stack you probably want to be looking at tools like git-debrebase, gbp pq, or git-dpm.
pt: Se você é um utilizador de quilt precisa de saber que as árvores git do dgit são `ramos de empacotamento de patches aplicadas' e não contêm o directório .pc (que é usado pelo quilt para gravar quais patches estão aplicadas).  Se você quer manipular a pilha de patch você provavelmente vai querer olhar para ferramentas como git-debrebase, gbp pq, ou git-dpm.

note: type: SS
en: quilt fixup error messages
pt: Mensagens de erro de correção do quilt

note: type: Plain text
en: When dgit's quilt fixup fails, it prints messages like this:
pt: Quando o quilt fixup do dgit falha, escreve mensagens como esta:

note: type: Plain text
en: is an import of the .orig tarballs dgit found, with the debian/ directory from your HEAD substituted.  This is a git tree object, not a commit: you can pass its hash to git-diff but not git-log.
pt: é uma importação dos tarballs .orig que o dgit encontra, com o directório debian/ a partir do seu CABEÇALHO substituído.  Isto é um objeto árvore git, não um cometido: você pode passa a sua cinza ao git-diff mas não ao git-log.

note: type: Plain text
en: is another tree object, which is the same as orig but with the patches from debian/patches applied.
pt: é outro objeto árvore, o qual é o mesmo que a origem mas com as patches de debian/patches aplicadas.

note: type: Plain text
en: is of course your own git HEAD.
pt: é, pois claro, o seu próprio CABEÇALHO git.

note: type: Plain text
en: shows whether each of the these trees differs from the others (i) in upstream files excluding .gitignore files; (ii) in upstream .gitignore files.  B<==> indicates equality; B<##> indicates inequality.
pt: mostra se cada uma destas árvores deferem das outras (1) em ficheiros de autor excluindo ficheiros .gitignore; (2) em ficheiros .gitignore do autor.  B<==> indica igualdade; B<##> indica desigualdade.

note: type: Plain text
en: dgit quilt-fixup --quilt=linear walks commits backwards from your HEAD trying to construct a linear set of additional patches, starting at the end.  It hopes to eventually find an ancestor whose tree is identical to o+d/p in all upstream files.
pt: O dgit quilt-fixup --quilt=linear corre os cometidos para trás a partir do seu CABEÇALHO tentando construir um conjunto linear de patches adicionais, começando pelo fim.  Ele espera eventualmente encontrar um antepassado cuja árvore seja idêntica a o+d/p em todos os ficheiros do autor.

note: type: Plain text
en: In the error message, 696c9bd5..84ae8f96 is the first commit child-parent edge which cannot sensibly be either ignored, or turned into a patch in debian/patches.  In this example, this is because it itself changes files in debian/patches, indicating that something unusual is going on and that continuing is not safe.  But you might also see other kinds of troublesome commit or edge.
pt: Na mensagem de erro, 696c9bd5..84ae8f96 é a borda filho-pai do primeiro cometido o qual não pode ser sensivelmente nem ignorado, nem tornado numa patch em debian/patches.  Neste exemplo, isto é porque ele próprio modifica ficheiros em debian/patches, indicando que algo não usual está a acontecer e que continuar não é seguro.  Mas você pode também ver outros tipos de cometido ou borda problemática.

note: type: Plain text
en: Your appropriate response depends on the cause and the context.  If you have been freely merging your git branch and do not need need a pretty linear patch queue, you can use B<--quilt=single> or B<--quilt=smash>.  (Don't use the B<single-debian-patch> dpkg source format option; it has strange properties.)  If you want a pretty linear series, and this message is unexpected, it can mean that you have unwittingly committed changes that are not representable by dpkg-source (such as some mode changes).  Or maybe you just forgot a necessary B<--quilt=> option.
pt: A sua resposta apropriada depende da causa e do contexto.  Se você tem vindo a fundir livremente o seu ramo git e não precisa duma fila de patch linear bonita, você pode usar B<--quilt=single> ou B<--quilt=smash>.  (Não use a opção de formato fonte do dpkg B<single-debian-patch>; tem propriedades estranhas.)  Se você quer uma série linear bonita, e esta mensagem é inesperada, isso pode significar que você tem sem o saber cometido alterações que não são representáveis pelo dpkg-source (tais como algumas alterações de modo).  Ou talvez você tenha apenas esquecido uma opção B<--quilt=> necessária.

note: type: Plain text
en: Finally, this problem can occur if you have provided Debian git tooling such as git-debrebase, git-dpm or git-buildpackage with upstream git commit(s) or tag(s)  which are not 100% identical to your orig tarball(s).
pt: Finalmente, este problema pode ocorrer se você forneceu uma ferramenta git de Debian como o git-debrebase, git-dpm ou git-buildpackage com cometido(s) ou etiqueta(s) git de autor que não são 100% idênticas aos seus tarball(s) de origem.

note: type: SH
en: SPLIT VIEW AND SPLITTING QUILT MODES
pt: VISÃO DIVIDIDA E DIVIDIR MODOS QUILT

note: type: Plain text
en: When working with git branches intended for use with the `3.0 (quilt)' source format dgit can automatically convert a suitable maintainer-provided git branch (in one of a variety of formats)  into a dgit branch.
pt: Quando se trabalha com ramos git destinados a uso com o formato fonte `3.0 (quilt)' o dgit pode converter automaticamente um ramo git apropriado fornecido pelo maintainer (em um de uma variedade de formatos) num ramo dgit.

note: type: Plain text
en: When a splitting quilt mode is selected dgit build commands and dgit push-* will, on each invocation, convert the user's HEAD into the dgit view, so that it can be built and/or uploaded.
pt: Quando é selecionado um modo quilt de dividir, os comandos de compilação do dgit e o dgit push-* irão, em cada invocação, converter o CABEÇALHO do utilizador em vista dgit, para que possa ser compilado e/ou enviado.

note: type: Plain text
en: Split view mode can also be enabled explicitly with the --split-view command line option and the .split-view access configuration key.
pt: O modo de vista dividida também pode ser activado explicitamente com a opção de linha de comandos --split-view e a chave de configuração de acesso .split-view.

note: type: Plain text
en: When split view is in operation, regardless of the quilt mode, any dgit-generated pseudomerges and any quilt fixup commits will appear only in the dgit view.  dgit push-* will push the dgit view to the dgit git server.  The dgit view is always a descendant of the maintainer view.  dgit push-* will also make a maintainer view tag according to DEP-14 and push that to the dgit git server.
pt: Quando a vista dividida está em operação, independentemente do modo quilt, quaisquer pseudo-fusões geradas pelo dgit e quaisquer cometidos fixup de quilt irão aparecer apenas na vista dgit.  O dgit push-* vai empurrar a vista dgit para o servidor git dgit.  A vista dgit é sempre um descendente da vista do maintainer.  O dgit push-* vai também fazer uma etiqueta de vista de maintainer de acordo com DEP-14 e empurrar isso para o servidor git dgit.

note: type: Plain text
en: Splitting quilt modes must be enabled explicitly (by the use of the applicable command line options, subcommands, or configuration).  This is because it is not possible to reliably tell (for example)  whether a git tree for a dpkg-source `3.0 (quilt)' package is a patches-applied or patches-unapplied tree.
pt: Os modos quilt de divisão têm de ser explicitamente ativados (pelo uso das opções de linha de comandos aplicáveis, sub-comandos, ou configuração).  Isto porque não é possível dizer com confiança (por exemplo) se uma árvore git para um pacote dpkg-source `3.0 (quilt)' é uma árvore de patches aplicadas ou patches não aplicadas.

note: type: Plain text
en: Split view conversions are cached in the ref dgit-intern/quilt-cache.  This should not be manipulated directly.
pt: Conversões de vista dividida estão guardadas em cache na referência dgit-intern/quilt-cache.  Isto não deve ser manipulado diretamente.

note: type: SH
en: FILES IN THE ORIG TARBALL BUT NOT IN GIT - AUTOTOOLS ETC.
pt: FICHEIROS NO TARBALL ORIGINAL MAS NÃO EM GIT - AUTOTOOLS ETC.

note: type: Plain text
en: This section is mainly of interest to maintainers who want to use dgit with their existing git history for the Debian package.
pt: Esta secção é principalmente do interesse de maintainers que querem usar o dgit com o seu histórico git existente para o pacote Debian.

note: type: Plain text
en: Some developers like to have an extra-clean git tree which lacks files which are normally found in source tarballs and therefore in Debian source packages.  For example, it is conventional to ship ./configure in the source tarball, but some people prefer not to have it present in the git view of their project.
pt: Alguns desenvolvedores gostar de ter uma árvore git extra-limpa onde faltam ficheiros que normalmente são encontrados em tarballs fonte e assim em pacotes fonte Debian.  Por exemplo, é convencional incluir ./configure no tarball fonte, mas algumas pessoas preferem não o ter presente na vista git do seu projeto.

note: type: Plain text
en: dgit requires that the source package unpacks to exactly the same files as are in the git commit on which dgit push-* operates.  So if you just try to dgit push-* directly from one of these extra-clean git branches, it will fail.
pt: O dgit requer que o pacote fonte desempacote para exatamente os mesmos ficheiros que estão no cometido git no qual o dgit push-* opera.  Assim se você apenas tentar fazer dgit push-* directamente a partir de um destes ramos git extra-limpos, ele irá falhar.

note: type: Plain text
en: As the maintainer you therefore have the following options:
pt: Como maintainer você tem as seguintes opções:

note: type: Plain text
en: Delete the files from your git branches, and your Debian source packages, and carry the deletion as a delta from upstream.  (With `3.0 (quilt)' this means representing the deletions as patches.  You may need to pass --include-removal to dpkg-source --commit, or pass corresponding options to other tools.)  This can make the Debian source package less useful for people without Debian build infrastructure.
pt: Apaga os ficheiros dos seus ramos git, e os seus pacotes fonte Debian, e transporta o apagar como um delta a partir da autoria.  (Com `3.0 (quilt)' isto significa representar o que é apagado com o patches.  Você pode precisar de passar --include-removal ao dpkg-source --commit, ou passar opções correspondentes a outras ferramentas.)  Isto torna o pacote fonte Debian menos útil para pessoas que não tenham a infraestrutura de compilação Debian.

note: type: Plain text
en: Persuade upstream that the source code in their git history and the source they ship as tarballs should be identical.  Of course simply removing the files from the tarball may make the tarball hard for people to use.
pt: Persuadis o autor que o código fonte no histórico git dele e a fonte que ele empacota como tarballs devem ser idênticos.  É claro que remover simplesmente os ficheiros do tarball pode tornar o tarball difícil para pessoas usarem.

note: type: Plain text
en: One answer is to commit the (maybe autogenerated)  files, perhaps with some simple automation to deal with conflicts and spurious changes.  This has the advantage that someone who clones the git repository finds the program just as easy to build as someone who uses the tarball.
pt: Uma resposta é cometer os ficheiros (talvez auto-gerados), talvez com alguma automatização simples para lidar com conflitos e alterações espúrias.  Isto tem a vantagem de se alguém clonar o repositório git, encontra o programa tão fácil de compilar como alguém que usa o tarball.

note: type: Plain text
en: Of course it may also be that the differences are due to build system bugs, which cause unintended files to end up in the source package.  dgit will notice this and complain.  You may have to fix these bugs before you can unify your existing git history with dgit's.
pt: É claro que também pode ser que as diferenças se devam a bugs do sistema de compilação, que faz com que ficheiros indesejados acabem no pacote fonte.  O dgit vai avisar e queixar-se disto.  Você pode ter de corrigir estes bugs antes de puder unificar o seu histórico git existente com o do dgit.

note: type: SH
en: FILES IN THE SOURCE PACKAGE BUT NOT IN GIT - DOCS, BINARIES ETC.
pt: FICHEIROS NO PACOTE FONTE MAS NÃO EM GIT - DOCUMENTOS, BINÁRIOS, ETC.

note: type: Plain text
en: Some upstream tarballs contain build artifacts which upstream expects some users not to want to rebuild (or indeed to find hard to rebuild), but which in Debian we always rebuild.
pt: Alguns tarballs de autor contêm artefactos de compilação que o autor espera que alguns utilizadores não desejem re-compilar (ou que achem difícil de re-compilar), mas esses tais em Debian nós os re-compilamos sempre.

note: type: Plain text
en: Examples sometimes include crossbuild firmware binaries and documentation.  To avoid problems when building updated source packages (in particular, to avoid trying to represent as changes in the source package uninteresting or perhaps unrepresentable changes to such files)  many maintainers arrange for the package clean target to delete these files.
pt: Exemplos por vezes incluem binários de firmware de compilação cruzada e documentação.  Para evitar problemas quando se compila pacotes fonte atualizados (em particular, para evitar tentar representar como alterações não interessantes no pacote fonte ou talvez alterações não representáveis em tais ficheiros) muitos maintainers fazem com que o alvo de limpeza do pacote apague estes ficheiros.

note: type: Plain text
en: dpkg-source does not (with any of the commonly used source formats)  represent deletion of binaries (outside debian/) present in upstream.  Thus deleting such files in a dpkg-source working tree does not actually result in them being deleted from the source package.  Thus deleting the files in rules clean sweeps this problem under the rug.
pt: O dpkg-source não (com qualquer dos formatos fonte geralmente usados) representa o apagar de binários (fora de debian/) presentes na autoria.  Assim apagar tais ficheiros numa árvore de trabalho do dpkg-source não resulta realmente neles a serem apagados do pacote fonte.  Assim apagar os ficheiros em regras de limpeza varre este problema para baixo do tapete.

note: type: Plain text
en: However, git does always properly record file deletion.  Since dgit's principle is that the dgit git tree is the same of dpkg-source -x, that means that a dgit-compatible git tree always contains these files.
pt: No entanto, o git recorda sempre apropriadamente o apagar de ficheiros.  Como o princípio do dgit é que a árvore git do dgit é a mesma de dpkg-source -x, isso significa que uma árvore git compatível com o dgit contém sempre estes ficheiros.

note: type: Plain text
en: For the non-maintainer, this can be observed in the following suboptimal occurrences:
pt: Para o não-maintainer, isto pode ser observado nas seguintes ocorrências sub-ótimas:

note: type: Plain text
en: The package clean target often deletes these files, making the git tree dirty trying to build the source package, etc.  This can be fixed by using B<dgit -wg> aka B<--clean=git>, so that the package clean target is never run.
pt: O alvo de limpeza do pacote muitas vezes apaga estes ficheiros, tornando a árvore git suja ao tentar compilar o pacote fonte, etc.  Isto pode ser corrigido ao usar B<dgit -wg> aka B<--clean=git>, para que o alvo de limpeza do pacote nunca seja executado.

note: type: Plain text
en: The package build modifies these files, so that builds make the git tree dirty.  This can be worked around by using `git reset --hard' after each build (or at least before each commit or push).
pt: A compilação do pacote modifica estes ficheiros, assim as compilações sujam a árvore git.  Isto pode ser contornado ao se usar `git reset --hard' após cada compilação (ou pelo menos antes de cada cometido ou push).

note: type: Plain text
en: From the maintainer's point of view, the main consequence is that to make a dgit-compatible git branch it is necessary to commit these files to git.  The maintainer has a few additional options for mitigation: for example, it may be possible for the rules file to arrange to do the build in a temporary area, which avoids updating the troublesome files; they can then be left in the git tree without seeing trouble.
pt: Do ponto de vista do maintainer, a principal consequência é que para tornar um ramo git compatível com dgit é necessário cometer estes ficheiros para git.  O maintainer tem algumas opções adicionais para mitigação: por exemplo, pode ser possível para o ficheiro de regras organizar para fazer a compilação numa área temporária, o que evita atualizar os ficheiros problemáticos; eles podem depois serem deixados na árvore git sem verem problemas.

note: type: SH
en: PROBLEMS WITH PACKAGE CLEAN TARGETS ETC.
pt: PROBLEMAS COM ALVOS DE LIMPEZA DE PACOTE ETC.

note: type: Plain text
en: A related problem is other unexpected behaviour by a package's B<clean> target.  If a package's rules modify files which are distributed in the package, or simply forget to remove certain files, dgit will complain that the tree is dirty.
pt: Um problema relacionado é outro comportamento inesperado pelo alvo B<clean> de um pacote.  Se uma regra de pacote modificar ficheiros que são distribuídos no pacote, ou se simplesmente se esquecer de remover certos ficheiros, o dgit irá queixar-se que a árvore está suja.

note: type: Plain text
en: Again, the solution is to use B<dgit -wg> aka B<--clean=git>, which instructs dgit to use git clean instead of the package's build target, along with perhaps B<git reset --hard> before each build.
pt: Mais uma vez, a solução é usar B<dgit -wg> aka B<--clean=git>, o qual instruí o dgit a usar git clean em vez do alvo de compilação do pacote, juntamente com talvez B<git reset --hard> antes de cada compilação.

note: type: Plain text
en: This is 100% reliable, but has the downside that if you forget to git add or to commit, and then use B<dgit -wg> or B<git reset --hard>, your changes may be lost.
pt: Isto é 100% fiável, mas tem o contra que se você se esquecer de fazer git add ou de cometer, e depois usar B<dgit -wg> ou B<git reset --hard>, as suas alterações podem ser perdidas.
