svn-buildpackage - en to pt translation catalogue (316 entries)

note: type: Content of the dhdate entity
en: <date>May 2009</date>
pt: <date>Maio 2009</date>

note: type: Attribute 'lang' of: <book>
en: en
pt: pt

note: type: Content of: <book><bookinfo><title>
en: svn-buildpackage - maintaining Debian packages with Subversion
pt: svn-buildpackage - manutenção de pacotes Debian com Subversion

note: type: Content of: <book><bookinfo>
en: <copyright> <year>2003-2007</year> <holder>Eduard Bloch</holder> </copyright> <copyright> <year>2009-2010</year> <holder>Neil Williams</holder> </copyright> <date>Tue Aug 31 21:01:26 BST 2010</date>
pt: <copyright> <year>2003-2007</year> <holder>Eduard Bloch</holder> </copyright> <copyright> <year>2009-2010</year> <holder>Neil Williams</holder> </copyright> <date>Terça Agosto 31 21:01:26 BST 2010</date>

note: type: Content of: <book><bookinfo><releaseinfo>
en: Release: 0.8.2
pt: Lançamento: 0.8.2

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This documentation is part of &dhpackage;.
pt: Esta documentação faz parte de &dhpackage;.

note: type: Content of: <book><bookinfo><legalnotice><para>
en: You should have received a copy of the GNU General Public License along with this program.  If not, see <ulink url="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</ulink>.
pt: Você deverá ter recebido uma cópia do GNU General Public License juntamente com este programa. Se não recebeu, veja <ulink url="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</ulink>.

note: type: Content of: <book><chapter><title>
en: Introduction
pt: Introdução

note: type: Content of: <book><chapter><sect1><title>
en: Purpose
pt: Objectivo

note: type: Content of: <book><chapter><sect1><para>
en: This short document is only intended to give a short help in converting packages to Subversion management. It is primarily intended for developers not really familiar with Subversion or CVS management and/or converting from maintaining their packages using common tools (<command>dpkg-dev</command>, <command>devscripts</command>)  only to version control system Subversion.
pt: Este pequeno documento destina-se apenas a fornecer uma pequena ajuda na conversão de pacotes para gestão de Subversion. É destinado principalmente a programadores não realmente familiarizados com a gestão de Subversion ou CVS e/ou conversão a partir da manutenção dos seus pacotes usando ferramentas comuns (<command>dpkg-dev</command>, <command>devscripts</command>) apenas para o sistema de controle de versão Subversion.

note: type: Content of: <book><chapter><sect1><title>
en: Why a version control system?
pt: Porquê um sistema de controle de versão?

note: type: Content of: <book><chapter><sect1><para>
en: But the first question may be: why use a version control system at all? Look at how the source is handled by the Debian package. First, we have the pure upstream source, which is often maintained by another person. The upstream author has his own development line and releases the source in snapshots (often called releases or program versions).
pt: Mas a primeira questão poderá ser: porquê usar um sistema de controle de versão? Veja como a fonte é manuseada pelo pacote Debian. Primeiro, temos a fonte original pura, que geralmente é mantida por outra pessoa. O autor original tem a sua própria linha de desenvolvimento e lança a fonte em snapshots (geralmente chamadas de lançamentos ou versões do programa).

note: type: Content of: <book><chapter><sect1><para>
en: The Debian maintainer adds an own set of modifications, leading to an own version of the upstream package. The difference set between this two version finally ends in Debian's <filename>.diff.gz</filename> files, and this patchset is often appliable to future upstream versions in order to get the "Debian versions".
pt: O responsável Debian adiciona um conjunto próprio de modificações, levando a uma versão própria do pacote original. O conjunto de diferenças entre estas duas versões acaba finalmente nos ficheiros <filename>.diff.gz</filename> da Debian, e este conjunto-patch é geralmente aplicado às versões originais futuras de modo a obter as "versões Debian".

note: type: Content of: <book><chapter><sect1><para>
en: So the obvious way to deal with source upgrades/changes is using local copies, patch, different patchutils and scripts to automate all this, e.g. <command>uupdate</command>. However, it often becomes nasty and uncomfortable and there is no way to undo changes that you may do by mistakes.
pt: Então a maneira óbvia de lidar com as actualizações/alterações da origem é usar cópias, patch, ferramentas de patch diferentes e scripts locais para automatizar tudo isto, ex. <command>uupdate</command>. No entanto, geralmente torna-se desagradável e desconfortável e não há maneira de desfazer alterações que possa fazer por engano.

note: type: Content of: <book><chapter><sect1><para>
en: At this point, the Subversion system can be used to simplify that work. It does the same things that you normaly would do by-hand but keeps it in an own archive (a repository). It stores the development lines of Upstream and Debian source, keeping them in different directories (different branches). The branches are wired internally (the VCS "knows" the history of the file and tracks the differences between the Upstream and Debian versions).  When a new upstream version is installed, the differences between the old and new upstream versions and the Debian version are merged together.
pt: Neste ponto, o sistema Subversion pode ser usado para simplificar esse trabalho. Faz as mesmas coisas que normalmente faria manualmente mas mantêm um arquivo próprio (um repositório). Armazena as linhas de desenvolvimento das fontes Original e Debian, mantendo-as em directórios diferentes (branches diferentes). Os branches estão ligados internamente (o VCS "conhece" o histórico do ficheiro e segue as diferenças entre as versões Original e Debian). Quando é instalada uma nova versão original, as diferenças entre as versões originais antiga e nova e a versão Debian são juntas.

note: type: Content of: <book><chapter><sect1><para>
en: You can create snapshots of your Debian version ("tag" it)  and switch back to a previous state, or see the changes done in the files. You can store when commiting the file to the repository or place custom tags on the files ("properties") serving various purposes.
pt: Você pode criar imagens da sua versão Debian (etiquetá-las) e mudar para um estado anterior, ou ver as alterações feitas nos ficheiros. Você pode armazenar quando submete o ficheiro para o repositório ou colocar etiquetas personalizadas nos ficheiros ("propriedades") servindo vários objectivos.

note: type: Content of: <book><chapter><sect1><title>
en: Features
pt: Funcionalidades

note: type: Content of: <book><chapter><sect1><para>
en: <command>svn-buildpackage</command> and other scripts around it has been created to do the following things:
pt: O <command>svn-buildpackage</command> e outros scripts em redor dele foram criados para fazer as seguintes coisas:

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Keep Debian package under revision control, which means storing different versions of files in a Subversion repository.
pt: Manter o pacote Debian sob controle de revisão, o que significa armazenar diferentes versões de ficheiros num repositório Subversion.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Allow easy walking back trough time using <command>svn</command> command.
pt: Permitir recuos no tempo fáceis usando o comando <command>svn</command>.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Easy retrieval of past versions.
pt: Recuperação fácil de versões anteriores.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Keep track of upstream source versions and modified Debian versions.
pt: Acompanhar as versões fonte da origem e as versões Debian modificadas.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Easy installation of new upstream versions, merging the Debian changes into it when needed (similar to the <command>uupdate</command> program).
pt: Instalação fácil de novas versões da origem, fusão das alterações de Debian nelas quando necessário (semelhante ao programa <command>uupdate</command>).

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Automated package building in clean environment, notifying about uncommited changes.
pt: Construção de pacote automatizada em ambiente limpo, notificando acerca de alterações não submetidas.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Create version tags when requested to do the final build and update changelog when needed.
pt: Criar etiquetas de versão quando requisitadas para fazer a construção final e actualizar o registo de alterações quando necessário.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: allow co-work of multiple Debian developers on the same project.
pt: permitir trabalho cooperativo de vários programadores Debian no mesmo projecto.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Auto-configure the repository layout, making it easy to use by people without knowing much about Subversion usage (mostly you need only the <command>add</command>, <command>rm</command> and <command>mv</command> commands of <command>svn</command>).
pt: Auto-configurar a disposição do repositório, tornando-o fácil de usar por pessoas que não sabem muito sobre a utilização do Subversion (geralmente você apenas precisa dos comandos <command>add</command>, <command>rm</command> e <command>mv</command> do  <command>svn</command>).

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Allow to store only the Debian specific changes in the repository and merge them into the upstream source in the build area (which nicely completes build systems like <command>dpatch</command> or <command>dbs</command>).
pt: Permitir armazenar apenas as alterações especificas de Debian no repositório e fundi-las com a fonte de origem na área de construção (o que completa muito bem os sistemas de construção como o <command>dpatch</command> ou <command>dbs</command>).

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: If wished, keep the upstream tarballs inside of the repository.
pt: Se desejado, manter os tarballs da origem dentro do repositório.

note: type: Content of: <book><chapter><sect1><title>
en: Contents overview
pt: Visão geral dos conteúdos

note: type: Content of: <book><chapter><sect1><para>
en: There are currently three scripts provided by the <command>svn-buildpackage</command> package:
pt: Existem actualmente três scripts disponibilizados pelo pacote <command>svn-buildpackage</command>:

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>svn-inject</command>: script used to insert an existing Debian package into a Subversion repository, creating the repository layout as needed.
pt: <command>svn-inject</command>: script usado para inserir um pacote Debian existente num repositório Subversion, criando a disposição do repositório como necessário.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>svn-buildpackage</command>: exports the contents of the directory associated with the starting directory from the Subversion repository to the clean environment and build the package there.
pt: <command>svn-buildpackage</command>: exporta o conteúdo do directório associado com o directório de arranque do repositório Subversion para o ambiente limpo e constrói o pacote lá.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>svn-upgrade</command>: similar to <command>uupdate</command>, upgrades the trunk to a new upstream version, preserving and merging Debian specific changes.
pt: <command>svn-upgrade</command>: semelhante ao <command>uupdate</command>, actualiza o trunk para uma nova versão da origem, preservando e fundindo as alterações especificas de Debian.

note: type: Content of: <book><chapter><sect1><title>
en: Popular repository layouts
pt: Disposições de repositório populares

note: type: Content of: <book><chapter><sect1><para>
en: There are different ways to store the packages in the repositories (or in multiple repositories at your choice).  <command>svn-buildpackage</command> normally expects a directory structure similar to the one well described in the Subversion Book, which looks like:
pt: Existem diferentes maneiras de armazenar os pacotes nos repositórios (ou em múltiplos repositórios à sua escolha). O <command>svn-buildpackage</command> espera normalmente uma estrutura de directórios semelhante àquela bem descrita no Livro do Subversion, que se parece como:

note: type: Content of: <book><chapter><sect1><example><title>
en: Directory hierarchy example.
pt: Exemplo de hierarquia de directórios.

note: type: Content of: <book><chapter><sect1><para>
en: <filename>packageA</filename> above may be a typical upstream-based source package and a <filename>projectB</filename> may be a Debian native package with a separate branch created by developer Foo for his own experiments. See <ulink url="http://svnbook.red-bean.com/html-chunk/ch04s02.html"> Subversion Book/Branches</ulink> for more details about using Subversion branches.
pt: O <filename>packageA</filename> em cima pode ser um pacote fonte típico baseado no original e o <filename>projectB</filename> pode ser um pacote nativo Debian com um branch separado criado pelo programador Foo para as suas próprias experiências. Veja <ulink url="http://svnbook.red-bean.com/html-chunk/ch04s02.html"> Subversion Book/Branches</ulink> para mais detalhes acerca de usar os branches de Subversion.

note: type: Content of: <book><chapter><sect1><para>
en: Also note that Tags work quite differently to those in CVS.  Subversion does not maintain magic tags associated with some files.  Instead, it tracks the file state and moves, so Tagging something means creating a copy (inside of the Repository, harddisk-space efficient) of a certain version of the file set. So the Debian branch of the released package source is contained in <filename>trunk/</filename> and is tagged by copying (mirroring) the trunk tree to <filename>tags/DEBIAN-REVISION</filename>. The same happens for the upstream releases. In addition, the most recent upstream version is mirrored to <filename>branches/upstream/current</filename>. After few package upgrade cycles, the directory tree may look like:
pt: Note também que as Etiquetas (Tags) funcionam de modo bem diferentes daquelas no CVS.  O Subversion não mantêm etiquetas mágicas associadas a alguns ficheiros. Em vez disso, acompanha o estado do ficheiro e move, portanto Etiquetar algo significa criar uma cópia (dentro do Repositório, com espaço em disco eficiente) de uma certa versão do conjunto de ficheiros. Então o branch Debian da fonte do pacote lançado é contido no <filename>trunk/</filename> e é etiquetado ao se copiar (fazer mirror) a árvore do trunk para <filename>tags/DEBIAN-REVISION</filename>. O mesmo acontece para os lançamentos da origem. Adicionalmente, a versão original mais recente é copiada em mirror para <filename>branches/upstream/current</filename>. Após alguns ciclos de actualização do pacote, a árvore de directórios pode parecer-se como isto:

note: type: Content of: <book><chapter><sect1><example><title>
en: Example branch directory hierarchy
pt: Exemplo de hierarquia de directório branch

note: type: Content of: <book><chapter><sect1><para>
en: <command>svn-buildpackage</command> also supports the second repository layout suggested in the Subversion Book (function/package) but <command>svn-inject</command> prefers the one documented above. Both <command>svn-buildpackage</command> and <command>svn-upgrade</command> should be able to auto-detect the repository layout and the location of package files.
pt: O <command>svn-buildpackage</command> também suporta a disposição de segundo repositório sugerida no Livro do Subversion (função/pacote) mas o <command>svn-inject</command> prefere o documentado em cima. Ambos <command>svn-buildpackage</command> e <command>svn-upgrade</command> deverão ser capazes de auto-detectar a disposição do repositório e a localização dos ficheiros de pacotes.

note: type: Content of: <book><chapter><sect1><para>
en: In theory, you do not have to follow that examples and place the <filename>trunk</filename>, <filename>branches</filename> and <filename>tags</filename> directory on the locations you like more.  But <command>svn-buildpackage</command> and other scripts won't locate the files automaticaly so you will need to edit the <filename>.svn/deb-layout</filename> file in your working directory and set paths. See the old <ulink url="file:///usr/share/doc/svn-buildpackage/CONFIG">abstract</ulink> about how auto-detection works and the <ulink url="file:///usr/share/doc/svn-buildpackage/examples/config.example"> config example</ulink>.
pt: Em teoria, você não tem que seguir esses exemplos e colocar os directórios <filename>trunk</filename>, <filename>branches</filename> e <filename>tags</filename> nas localizações que mais gosta. Mas o <command>svn-buildpackage</command> e outros scripts não vão localizar os ficheiros automaticamente portanto você precisa editar o ficheiro <filename>.svn/deb-layout</filename> no seu directório de trabalho e definir caminhos. Veja o antigo <ulink url="file:///usr/share/doc/svn-buildpackage/CONFIG">abstract</ulink> acerca de como a auto-detecção funciona e o <ulink url="file:///usr/share/doc/svn-buildpackage/examples/config.example"> exemplo de configuração</ulink>.

note: type: Content of: <book><chapter><sect1><para>
en: Finally, the working directory structure on your development system may look like:
pt: Finalmente, a estrutura de directórios de trabalho no seu sistema de desenvolvimento poderá parecer como isto:

note: type: Content of: <book><chapter><sect1><example><title>
en: Example configuration
pt: Exemplo de configuração

note: type: Content of: <book><chapter><sect1><example><programlisting>
en: dev/ # base directory, may be under version control or not
    dev/foo # trunk directories of various packages
    dev/bar # contents correspond to trunk, see above
    dev/tarballs # where "orig" tarballs are stored, may be under VC or not
    dev/build-area # where the packages are exported temporarily and built
pt: dev/ # directório base, pode estar sob controle de versão ou não
    dev/foo # directórios trunk de vários pacotes
    dev/bar # conteúdo correspondente ao trunk, veja em cima
    dev/tarballs # onde os tarballs de 'origem' são armazenados, pode ser sob VC ou não
    dev/build-area # onde os pacotes são exportados temporariamente e construídos

note: type: Content of: <book><chapter><title>
en: Getting started
pt: Iniciando

note: type: Content of: <book><chapter><para>
en: Besides the packages that are installed by dependencies when you install <command>svn-buildpackage</command>, you may need <command>ssh</command> and the obligatory tool chain: <command>dpkg-dev</command>, <command>build-essential</command> and all the packages they pull into the system.
pt: Para além dos pacotes que são instalados por dependências quando você instala o <command>svn-buildpackage</command>, você pode precisar do <command>ssh</command> e da cadeia de ferramentas obrigatória: <command>dpkg-dev</command>, <command>build-essential</command> e todos os pacotes que eles puxam para o sistema.

note: type: Content of: <book><chapter><sect1><title>
en: Quick guide
pt: Guia rápido

note: type: Content of: <book><chapter><sect1><para>
en: Here is a quick guide for those who wish to build an existing package using an existing, publically available SVN repository. To create own repositories, skip this section and look for more details below.
pt: Aqui está um guia rápido para quem deseja construir um pacote existente, usando um repositório SVN existente e disponível publicamente. Para criar os seus próprios repositórios, salte esta secção e procure mais detalhes em baixo.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: svn co &lt;svn://server/path/to/trunk&gt; package
pt: svn co &lt;svn://server/path/to/trunk&gt; pacote

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: cp dir-where-you-keep-the-source/package_version.orig.tar.gz tarballs/
pt: cp directório-onde-deseja-manter-a-fonte/versão-de-pacote.orig.tar.gz tarballs/

note: type: Content of: <book><chapter><sect1><itemizedlist><para>
en: NOTE: you need the upstream source tarballs, stored under a usual <command>dpkg-source</command>-compatible filename in <filename>tarballs/</filename>
pt: NOTA: você precisa dos tarballs da fonte original, armazenados sob um nome de ficheiro normalmente compatível com <command>dpkg-source</command> em <filename>tarballs/</filename>

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: cd <replaceable>package</replaceable>
pt: cd <replaceable>pacote</replaceable>

note: type: Content of: <book><chapter><sect1><title>
en: Basic svn usage
pt: Utilização svn básica

note: type: Content of: <book><chapter><sect1><para>
en: You need only few commands to start using <command>svn</command> with <command>svn-buildpackage</command> scripts. If you wish to learn more about it, read parts of the <ulink url="http://svnbook.red-bean.com/html-chunk/"> Subversion Book</ulink>. The most used commands are:
pt: Você precisa apenas de alguns comandos para começar a usar o<command>svn</command> com scripts do <command>svn-buildpackage</command>. Se desejar aprender mais acerca dele, leia partes do <ulink url="http://svnbook.red-bean.com/html-chunk/">Livro do Subversion</ulink>. Os comandos mais usados são:

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>add</command> -- put new files unto the revision control.
pt: <command>add</command> -- coloca ficheiros novos em controle de revisão.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>rm</command> -- remove the files from the repository.
pt: <command>rm</command> -- remove os ficheiros do repositório.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>mv</command> -- move files around, leting revision control system know about it.
pt: <command>mv</command> -- move ficheiros, deixando o sistema de controle de revisão saiba disso.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>commit</command> -- commit your changes to the repository.
pt: <command>commit</command> -- submete as suas alterações para o repositório.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>resolved</command> -- tell <command>svn</command> that you have resolved a conflict.
pt: <command>resolved</command> -- diz ao <command>svn</command> que você resolveu um conflito.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>diff</command> -- creates a "<command>diff -u</command>" between two versions, specified by file revision number or by date. See the <command>diff --help</command> output.
pt: <command>diff</command> -- cria um "<command>diff -u</command>" entre duas versões, especificado pelo número de revisão do ficheiro ou pela data. Veja o resultado de <command>diff --help</command>.

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: <command>cat -r <replaceable>revision</replaceable></command> -- useful to browse in some previous revision of the file.
pt: <command>cat -r <replaceable>revision</replaceable></command> -- útil para explorar algumas revisões anteriores do ficheiro.

note: type: Content of: <book><chapter><sect1><para>
en: If you are familiar with CVS you will probably know almost all you need.
pt: Se você está familiarizado com CVS, provavelmente já sabe quase tudo o que precisa.

note: type: Content of: <book><chapter><sect1><title>
en: Creating Subversion repository
pt: Criar o repositório Subversion

note: type: Content of: <book><chapter><sect1><para>
en: The main Subversion repository is easily created with:
pt: O repositório Subversion principal é facilmente criado com:

note: type: Content of: <book><chapter><sect1><example><title>
en: Repository creation example.
pt: Exemplo de criação do repositório.

note: type: Content of: <book><chapter><sect1><example><programlisting>
en: $ svnadmin create <replaceable>repo-directory</replaceable>
pt: $ svnadmin create <replaceable>directório_do_repositório</replaceable>

note: type: Content of: <book><chapter><sect1><para>
en: For our example, we choose the name <filename>svn-deb-repo</filename> and put it in <filename>/home/<replaceable>user</replaceable></filename>.
pt: Para o nosso exemplo, escolhemos o nome <filename>svn-deb-repo</filename> e coloca-mo-lo em <filename>/home/<replaceable>utilizador</replaceable></filename>.

note: type: Content of: <book><chapter><sect1><para>
en: If you plan to keep many packages in the one repository including upstream tarballs, consider to put it on a hard disk with much free space and good performance (especially short disk access times) since the repository will grow and the filesystem may become fragmented over time.
pt: Se você planear manter muitos pacotes em um repositório incluindo os tarballs da origem, considere colocá-lo num disco rijo com muito espaço livre e boa performance (especialmente com tempos curtos de acesso ao disco) porque o repositório irá crescer e o sistema de ficheiros pode ficar fragmentado com o tempo.

note: type: Content of: <book><chapter><sect1><title>
en: Using by multiple developers
pt: Utilização por múltiplos programadores

note: type: Content of: <book><chapter><sect1><para>
en: Multiple developers with local access to the repository may share it using a common group. To do so, create a new group and add all developers to it. Run "chgrp -R sharedGroup repdir ; chmod -R g+s repdir" for the shared group and the repository directory. Now, on local access to this repository everybody will create files with the appropriate group setting. However, the developers will need to set a liberal umask before using <command>svn</command> (like "0022").
pt: Múltiplos programadores com acesso local ao repositório podem partilhá-lo usando um grupo comum. Para o fazer, crie um novo grupo de adicione todos os programadores a ele. Corra "chgrp -R sharedGroup repdir ; chmod -R g+s repdir" para o grupo partilhado e o directório de repositório. Agora, em acesso local a este repositório, todos irão criar ficheiros com as definições de grupo apropriadas. No entanto, os programadores precisam definir um umask liberal antes de usarem o <command>svn</command> (como "0022").

note: type: Content of: <book><chapter><sect1><para>
en: If somebody resists to do so, there is still a brute-force solution: fix the permissions with a post-commit script. However, this is an "unsound" solution and may lead to <emphasis>ALL KINDS OF PROBLEMS</emphasis>.  <emphasis>MAKE SURE THAT YOU ARE AWARE OF THE POSSIBLE CONSEQUENCES BEFORE YOU OPEN THE PANDORA BOX</emphasis>. See <ulink url="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=240630"> Debian BTS</ulink> for details. When you damage your repository, don't blame me and remember that there is "<command>svnadmin recover</command>".
pt: Se alguém resistir a fazê-lo, ainda existe a solução de força-bruta: corrigir as permissões com o script pós-submissão. No entanto, esta é uma solução "pouco sã" que pode levar a <emphasis>TODO O TIPO DE PROBLEMAS</emphasis>. <emphasis>CERTIFIQUE-SE QUE CONHECE TODAS AS CONSEQUÊNCIAS POSSÍVEIS ANTES DE ABRIR A CAIXA DE PANDORA</emphasis>. Veja <ulink url="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=240630"> Debian BTS</ulink> para detalhes. Quando danificar o seu repositório, não aponte as culpas a mim, e lembre-se que existe o "<command>svnadmin recover</command>".

note: type: Content of: <book><chapter><sect1><example><title>
en: post-commit hook example
pt: exemplo de hook de pós-submissão

note: type: Content of: <book><chapter><sect1><example><programlisting>
en: #!/bin/sh
    
    # POST-COMMIT HOOK
    # The following corrects the permissions of the repository files
    
    REPOS="$1"
    REV="$2"
    
    chgrp -R sharedGroup $REPOS
    # replace sharedGroup with your group
    chmod -R g+r $REPOS
    chmod -R g+w $REPOS
pt: #!/bin/sh
    
    # HOOK de PÓS-COMMIT
    # O seguinte corrige as permissões nos ficheiros do repositório
    
    REPOS="$1"
    REV="$2"
    
    chgrp -R sharedGroup $REPOS
    # substitui sharedGroup pelo seu grupo
    chmod -R g+r $REPOS
    chmod -R g+w $REPOS

note: type: Content of: <book><chapter><sect1><title>
en: SVN over SSH
pt: SVN sobre SSH

note: type: Content of: <book><chapter><sect1><para>
en: To run Subversion over SSH, you basically need a shell on the target system and a subversion repository located there which is created following the description above. The repository must be configured for access by the system users of the remote system.
pt: Para correr o Subversion sobre SSH, basicamente você precisa de uma shell no sistema alvo e um repositório Subversion localizado lá o qual está criado seguindo a descrição em cima. O repositório tem de estar configurado para acesso pelos utilizadores de sistema do sistema remoto.

note: type: Content of: <book><chapter><sect1><para>
en: Assuming that your user name on the client system is the same as on the server side, there is not much to configure. Just change the protocol specification from <filename>file://</filename> to <filename>svn+ssh://<replaceable>remoteusername</replaceable>@<replaceable>server-hostname</replaceable></filename> in all examples showed in this manual.
pt: Assumindo que o seu nome de utilizador no sistema cliente é o mesmo que no lado do servidor, não há muito para configurar, apenas altere a especificação de protocolo de <filename>file://</filename> para <filename>svn+ssh://<replaceable>nome_de_utilizador_remoto</replaceable>@<replaceable>nome_de_maquina_servidor</replaceable></filename> em todos os exemplos mostrados neste manual.

note: type: Content of: <book><chapter><sect1><para>
en: Note that during <command>svn-buildpackage</command> tools actions a lot of SSH calls can be made and so the user is asked for his login data. The regular method to deal with that is using an SSH key authentication method together with <command>ssh-agent</command> and <command>ssh-add</command> to cache the passphrase in memory. Another approach, which also brings a significant speed boost, is using a cached SSH connection. This can be done with a new feature of OpenSSH (see <ulink url="http://gcc.gnu.org/wiki/SSH%20connection%20caching"> GCC SSH connection caching howto</ulink>) or a third-party tool like <command>fsh</command>.
pt: Note que durante as acções das ferramentas do <command>svn-buildpackage</command> podem acontecer muitas chamadas SSH e então é pedido ao utilizador os dados do seu login. O método regular para lidar com isto é usar um método de autenticação de chave SSH junto com <command>ssh-agent</command> e <command>ssh-add</command> para colocar em cache a frase passe em memória. Outra solução, que também trás um aumento de velocidade significante, é usar uma ligação SSH em cache. Isto pode ser feito com a nova funcionalidade do OpenSSH (veja <ulink url="http://gcc.gnu.org/wiki/SSH%20connection%20caching"> howto de cache a ligações GCC SSH</ulink>) ou uma ferramenta de terceiros como o <command>fsh</command>.

note: type: Content of: <book><chapter><sect1><para>
en: If you wish to use <command>fsh</command> over <command>ssh</command> you could specify a custom transport method in the subversion configuration. To do so, edit the file <filename>~/.subversion/config</filename> and add the section <filename>[tunnels]</filename> to it, following by your custom transport definition. Example:
pt: Se você deseja usar <command>fsh</command> sobre <command>ssh</command> você pode especificar um método de transporte personalizado na configuração do subversion. Para o fazer, edite o ficheiro <filename>~/.subversion/config</filename> e adicione a secção <filename>[tunnels]</filename> a ele, seguido da sua definição de transporte personalizada. Exemplo:

note: type: Content of: <book><chapter><sect1><example><title>
en: Example of a custom ssh tunnel command.
pt: Exemplo de um comando de túnel ssh personalizado.

note: type: Content of: <book><chapter><sect1><example><programlisting>
en: # personal subversion config with custom ssh tunnel command
    [tunnels]
    # SSH account on svn.d.o
    # compression is enabled in the ssh config
    deb = fsh -l &lt;user&gt;
    # SSH account for NQ intranet, set fix username
    nq = ssh -C -l zomb
pt: # configuração de subversion pessoal com comando de túnel ssh personalizado
    [tunnels]
    # conta SSH em svn.d.o
    # a compressão está activa na configuração do ssh
    deb = fsh -l &lt;user&gt;
    # conta SSH para NQ intranet, define correcção do nome de utilizador
    nq = ssh -C -l zomb

note: type: Content of: <book><chapter><sect1><para>
en: You can use the new defined tunnels in a similar ways as described above but replace <filename>svn+ssh</filename> with <filename>svn+<replaceable>tunnelname</replaceable></filename>, so the final URL looks like:
pt: Você pode usar os novos túneis definidos em modos semelhantes como os descritos em cima mas substitua <filename>svn+ssh</filename> por <filename>svn+<replaceable>nome_do_túnel</replaceable></filename>, para que o URL final fique como:

note: type: Content of: <book><chapter><sect1><programlisting>
en: svn+deb://svn.debian.org/svn/<replaceable>myproject</replaceable>/<replaceable>ourpackage</replaceable>/trunk
pt: svn+deb://svn.debian.org/svn/<replaceable>meuprojecto</replaceable>/<replaceable>nossopacote</replaceable>/trunk

note: type: Content of: <book><chapter><sect1><title>
en: Anonymous access
pt: Acesso anónimo

note: type: Content of: <book><chapter><sect1><para>
en: You can allow outsiders to have anonymous (read-only) access using the <command>svnserve</command> program, as described in the Subversion documentation.
pt: Você pode permitir que estranhos tenham acesso anónimo (só de leitura) usando o programa <command>svnserve</command>, como descrito na documentação do Subversion.

note: type: Content of: <book><chapter><sect1><para>
en: Another method is using HTTP/WebDAV with Apache2. More about a such setup can be found in the Subversion Book and the <ulink url="http://wiki.debian.org/SubversionApache2SSLHowto"> SubversionApache2SSL Howto</ulink>. <ulink url="http://svn.debian.org/">svn.debian.org</ulink> is an example site granting anonymous access to some selected projects hosted there.
pt: Outro método é usar HTTP/WebDAV com Apache2. Mais informação sobre tal configuração pode ser encontrada no Livro do Subversion e no <ulink url="http://wiki.debian.org/SubversionApache2SSLHowto"> SubversionApache2SSL Howto</ulink>. <ulink url="http://svn.debian.org/">svn.debian.org</ulink> é um exemplo de site que garante acesso anónimo a alguns projectos seleccionados hospedados lá.

note: type: Content of: <book><chapter><title>
en: Importing Debian packages
pt: Importar pacotes Debian

note: type: Content of: <book><chapter><sect1><title>
en: Importing from existing source package files
pt: Importar de ficheiros de pacotes fonte existentes

note: type: Content of: <book><chapter><sect1><para>
en: The <command>svn-inject</command> utility is intended to import already packaged source packages into a new subdirectory of the repository, creating the repository layout as needed. Normally, it takes two arguments: the <filename>.dsc</filename> file of your package and the base URL of the Subversion repository.
pt: O utilitário <command>svn-inject</command> destina-se a importar pacotes fonte já empacotados para um novo sub-directório do repositório, criando a disposição do repositório como necessário. Normalmente, requer dois argumentos: o ficheiro <filename>.dsc</filename> do seu pacote e o URL base do repositório Subversion.

note: type: Content of: <book><chapter><sect1><example><title>
en: svn-inject example
pt: exemplo do svn-inject

note: type: Content of: <book><chapter><sect1><para>
en: If you omit the URL, <command>svn-inject</command> will try to use the URL of the current directory as base URL. I would not rely on this, however.
pt: Se você omitir o URL, o <command>svn-inject</command> irá tentar usar o URL do directório actual como URL base. No entanto, eu não confiava nisto.

note: type: Content of: <book><chapter><sect1><title>
en: On-Build-Time merging
pt: Fusão em Tempo de Construção (On-Build-Time)

note: type: Content of: <book><chapter><sect1><para>
en: A special feature of <command>svn-buildpackage</command> is so called <emphasis>mergeWithUpstream</emphasis> mode. Many projects do not want to keep the whole upstream source under revision control, eg. because of the large amount of required disc space and process time. Sometimes it makes sense to keep only the <filename>debian/</filename> directory and maybe few other files under revision control.
pt: Uma funcionalidade especial do <command>svn-buildpackage</command> é o chamado modo <emphasis>mergeWithUpstream</emphasis>. Muitos projectos não querem manter o código de origem completo sob controle de revisão, por exemplo, devido à grande quantidade de espaço de disco necessária e tempo de processamento. Por vezes faz sentido manter apenas o directório <filename>debian/</filename> e talvez mais alguns ficheiros sob controle de revisão.

note: type: Content of: <book><chapter><sect1><para>
en: The task of exporting the source from repository and adding it to the upstream source before building becomes annoying after a little time.  But the <command>svn-buildpackage</command> tools automate most of this work for you by switching to <emphasis>mergeWithUpstream</emphasis> mode if a special flag has been detected: the mergeWithUpstream (Subversion) property of the <filename>debian</filename> directory. <command>svn-buildpackage</command> will merge the trunk with upstream source on build time and <command>svn-upgrade</command> will only update the changed files in this case.
pt: A tarefa de exportar a fonte do repositório e adicioná-la à fonte da origem antes da construção torna-se aborrecida após algum tempo. Mas as ferramentas do <command>svn-buildpackage</command> automatizam a maioria deste trabalho para si ao mudar para modo <emphasis>mergeWithUpstream</emphasis> se for detectada uma bandeira especial: a propriedade mergeWithUpstream (Subversion) do directório <filename>debian</filename>. O <command>svn-buildpackage</command> irá fundir o trunk com a fonte da origem durante a construção e o <command>svn-upgrade</command> irá apenas actualizar os ficheiros alterados neste caso.

note: type: Content of: <book><chapter><sect1><para>
en: To enable this feature during the initial import of the source package, simply add the <option>-o</option> switch to the <command>svn-inject</command> call and it will prepare the source for with <emphasis>mergeWithUpstream</emphasis> mode. This reduces the set of files to those modified for Debian and set the <emphasis>mergeWithUpstream</emphasis> property.
pt: Para activar esta funcionalidade durante a importação inicial do pacote fonte, simplesmente adicione o switch <option>-o</option> à chamada do <command>svn-inject </command> e ele irá preparar a fonte para modo <emphasis>mergeWithUpstream</emphasis>. Isto reduz o conjunto de ficheiros para aqueles modificados para Debian e definir a propriedade <emphasis>mergeWithUpstream</emphasis>.

note: type: Content of: <book><chapter><sect1><para>
en: But what, if you decide to switch to mergeWithUpstream-mode after the package has been injected? To do this, checkout the whole repository, remove the files not changed in the Debian package from both upstream source and Debian branch (<command>svn rm</command>) and set the <emphasis>mergeWithUpstream</emphasis> property on <filename>debian</filename> in the <filename>trunk</filename> directory with: <placeholder type="programlisting" id="0"/>
pt: Mas, e se você decidir mudar para modo mergeWithUpstream após o pacote ter sido injectado? Para fazer isto, verifique o repositório completo, remova os ficheiros não alterados no pacote Debian de ambos fonte de origem e branch Debian (<command>svn rm</command>) e defina a propriedade <emphasis>mergeWithUpstream</emphasis> em <filename>debian</filename> no directório <filename>trunk</filename> com: <placeholder type="programlisting" id="0"/>

note: type: Content of: <book><chapter><sect1><para>
en: If you actually decide to stop using the <emphasis>mergeWithUpstream</emphasis> mode, unset the <emphasis>mergeWithUpstream</emphasis> property as follows: <placeholder type="programlisting" id="0"/>
pt: Se você decidir parar de usar o modo <emphasis>mergeWithUpstream</emphasis>, desconfigure a propriedade <emphasis>mergeWithUpstream</emphasis> como se segue: <placeholder type="programlisting" id="0"/>

note: type: Content of: <book><chapter><sect1><para>
en: If you don't want to store the upstream sources of all your packages in the repository, you can pass the <option>--no-branches</option> switch to <command>svn-inject</command>, which will prevent <command>svn-inject</command> from creating a <filename>branches</filename> subdirectory.
pt: Se não desejar armazenar as fontes de origem de todos os seus pacotes no repositório, você pode passar o switch <option>--no-branches</option> para o <command>svn-inject</command>, o que vai prevenir o <command>svn-inject</command> de criar um sub-directório <filename>branches</filename>.

note: type: Content of: <book><chapter><sect1><sect2><title>
en: <command>dpkg-source</command> format 3.0 support
pt: suporte a formato 3.0 do <command>dpkg-source</command>

note: type: Content of: <book><chapter><sect1><sect2><para>
en: <command>svn-buildpackage</command> can build packages using source format 3.0, including using <filename>../tarballs/foo_1.2.3-1.orig.tar.bz2</filename> in <emphasis>mergeWithUpstream</emphasis> mode.  Ensure that <filename>debian/source/format</filename> exists and has been added to the local Subversion working copy.
pt: O <command>svn-buildpackage</command> pode construir pacotes usando o formato de fonte 3.0, inclusive usando <filename>../tarballs/foo_1.2.3-1.orig.tar.bz2</filename> em modo mergeWithUpstream. Assegure que <filename>debian/source/format</filename> existe e foi adicionado à cópia de trabalho local do Subversion.

note: type: Content of: <book><chapter><sect1><sect2><para>
en: If <filename>debian/source/format</filename> exists and contains <emphasis>3.0 *</emphasis>, <command>svn-buildpackage</command> checks for a <filename>.orig.tar.bz2</filename> in the <filename>tarballs</filename> directory and uses that for the subsequent build.
pt: Se <filename>debian/source/format</filename> existir e conter <emphasis>3.0 *</emphasis>, o <command>svn-buildpackage</command> procura um <filename>.orig.tar.bz2</filename> no directório <filename>tarballs</filename> e usa-o para a construção subsequente.

note: type: Content of: <book><chapter><sect1><sect2><example><title>
en: checking source formats with <command>dpkg-source</command>
pt: verificar formatos fonte com o <command>dpkg-source</command>

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: <command>dpkg-source</command> <option>--print-format</option> needs a little help to understand common layouts used with subversion.  The command needs two directories - the current working directory is used to find the original tarball and the specified directory is used to locate <filename>./debian/changelog</filename>. Change to the directory containing the tarball before running <command>dpkg-source</command> <option>--print-format</option>:
pt: <command>dpkg-source</command> <option>--print-format</option> precisa de alguma ajuda para compreender as disposições comuns usadas com subversion. O comando precisa de dois directórios - o directório de trabalho actual é usado para encontrar o tarball original e o directório especificado é usado para localizar <filename>./debian/changelog</filename>. Mude para o directório que contém o tarball antes de correr <command>dpkg-source</command> <option>--print-format</option>:

note: type: Content of: <book><chapter><sect1><sect2><title>
en: Preparing patches in <command>dpkg-source</command> 3.0 packages
pt: Preparar patches em pacotes 3.0 do <command>dpkg-source</command>

note: type: Content of: <book><chapter><sect1><sect2><para>
en: When using <option>3.0 (quilt)</option> and <option>mergeWithUpstream</option>, use <command>svn-do</command> to unpack the upstream source and then simply edit or patch the files necessary for the first patch.  Then get <command>dpkg-source</command> to prepare the patches for you:
pt: Quando usar <option>3.0 (quilt)</option> e <option>mergeWithUpstream</option>, use o <command>svn-do</command> para desempacotar a fonte da origem e depois simplesmente edite ou aplique patch aos ficheiros necessários para a primeira patch. Depois faça o <command>dpkg-source</command> preparar as patches para si:

note: type: Content of: <book><chapter><sect1><sect2><example><title>
en: Letting <command>dpkg-source</command> prepare patches for <option>3.0 (quilt)</option>
pt: Deixar o <command>dpkg-source</command> preparar patches para <option>3.0 (quilt)</option>

note: type: Content of: <book><chapter><sect1><sect2><para>
en: Now use a serviceable name for the patch and change that name in the <filename>series</filename> file, exit the <command>svn-do</command> subshell for the results to be copied back into <filename>trunk</filename>. Repeat for subsequent patches.
pt: Agora use um nome utilizável para a patch e mude esse nome no ficheiro <filename>series</filename>, termine a sub-shell do <command>svn-do</command> para que os resultados sejam copiados de volta para o <filename>trunk</filename>. Repita para as patches subsequentes.

note: type: Content of: <book><chapter><sect1><title>
en: Using <command>svn-buildpackage</command> with native packages
pt: Usar o <command>svn-buildpackage</command> com pacotes nativos

note: type: Content of: <book><chapter><sect1><para>
en: A native package is designed to work with Debian rather than general GNU/Linux distributions, many depend directly on specific Debian behaviour or other Debian native tools. <emphasis>svn-buildpackage</emphasis> is one such native package.
pt: Um pacote nativo é desenhado para funcionar com Debian em vez da generalidade de distribuições de GNU/Linux, muitos dependem directamente de comportamentos específicos da Debian e outras ferramentas nativas da Debian. O <emphasis>svn-buildpackage</emphasis> é um desses tais pacotes nativos.

note: type: Content of: <book><chapter><sect1><para>
en: With a native package, the contents of the <filename>debian/</filename> directory are included in the source tarball (which uses a plain <filename>.tar.gz</filename> suffix not the <filename>.orig.tar.gz</filename> suffix) and no <filename>.diff.gz</filename> is generated.
pt: Com um pacote nativo, o conteúdo do directório <filename>debian/</filename> está incluído no tarball fonte (que usa um sufixo normal <filename>.tar.gz</filename> e não o sufixo <filename>.orig.tar.gz</filename>) e nenhum <filename>.diff.gz</filename> é gerado.

note: type: Content of: <book><chapter><sect1><para>
en: The principal marker for a native package is the Debian version string. An upstream package uses:
pt: O marcador principal para um pacote nativo é a string de versão Debian. Um pacote da origem usa:

note: type: Content of: <book><chapter><sect1><para>
en: A native package uses:
pt: Um pacote nativo usa:

note: type: Content of: <book><chapter><sect1><sect2><title>
en: Compiled native packages
pt: Pacotes nativos compilados

note: type: Content of: <book><chapter><sect1><sect2><para>
en: Some native packages are compiled from source code and a lot of these packages use autotools like <filename>./configure</filename>, <command>autoreconf</command> and <command>make dist</command>. Such packages can use autotools support to generate a typical GNU or autotools style tarball with support for <emphasis>EXTRA_DIST</emphasis> and similar rules in <filename>Makefile.am</filename>. This allows the maintainers to not need to keep generated files (<filename>configure</filename>, <filename>aclocal.m4</filename>, <filename>ltmain.sh</filename> and <filename>libtool</filename>) in the subversion repository. With this support, the package can directly control which files are included into the source for the native package.
pt: Alguns pacotes nativos são compilados a partir de código fonte e muitos destes pacotes usam autotools como <filename>./configure</filename>, <command>autoreconf</command> e <command>make dist</command>. Tais pacotes podem usar suporte a autotools para gerar um tarbal típico GNU ou ao estilo autotools com suporte para <emphasis>EXTRA_DIST</emphasis> e regras semelhantes em <filename>Makefile.am</filename>. Isto permite que aos responsáveis não precisarem de manter os ficheiros (<filename>configure</filename>, <filename>aclocal.m4</filename>, <filename>ltmain.sh</filename> e <filename>libtool</filename>) gerados no repositório subversion. Com este suporte, o pacote pode controlar directamente quais os ficheiros são incluídos na fonte para o pacote nativo.

note: type: Content of: <book><chapter><sect1><sect2><para>
en: To build such packages with <command>svn-buildpackage</command>, <emphasis>mergeWithUpstream</emphasis> can be used even if the Debian version string indicates a native package. The upstream tarball is the one created by the <command>make dist</command> target and the maintainer can choose how to make that tarball available to <command>svn-buildpackage</command>:
pt: Para construir tais pacotes com <command>svn-buildpackage</command>, pode ser usado o <emphasis>mergeWithUpstream</emphasis> mesmo que a string de versão Debian indique um pacote nativo. O tarball da origem é aquele criado pelo alvo <command>make dist</command> e o responsável pode escolher como tornar esse tarball disponível ao <command>svn-buildpackage</command>:

note: type: Content of: <book><chapter><sect1><sect2><example><title>
en: Using a native tarball and mergeWithUpstream
pt: Usando um tarball nativo e mergeWithUpstream

note: type: Content of: <book><chapter><sect1><sect2><example><programlisting>
en: all-local: Makefile
    	ln -sf $(PACKAGE)-$(VERSION).tar.gz $(PACKAGE)_$(VERSION).orig.tar.gz
pt: all-local: Makefile
    	ln -sf $(PACOTE)-$(VERSÃO).tar.gz $(PACOTE)_$(VERSÃO).orig.tar.gz

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: (Yes, this is an artefact of using mergeWithUpstream.  The <filename>.orig.tar.gz</filename> is not actually used - the Debian version string overrides the merge property.)
pt: (Sim, é um artefacto usar mergeWithUpstream. O <filename>.orig.tar.gz</filename> na realidade não é usado - a string de versão Debian sobrescreve a propriedade de fusão.)

note: type: Content of: <book><chapter><sect1><sect2><para>
en: SVN properties:
pt: Propriedades do SVN:

note: type: Content of: <book><chapter><sect1><sect2><programlisting>
en: $ svn proplist ./debian/
    Properties on 'debian':
      mergeWithUpstream
pt: $ svn proplist ./debian/
    Propriedades em 'debian':
      mergeWithUpstream

note: type: Content of: <book><chapter><sect1><sect2><example><title>
en: Output of using mergeWithUpstream inside a native package
pt: Resultado de usar mergeWithUpstream dentro de um pacote nativo

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: The tarball generated by <command>make dist</command> is located using the <emphasis>origDir</emphasis> property, in this example, set to the top level package directory where <command>make dist</command> would normally create it and where the symlink is also created, as above.
pt: O tarball gerado por <command>make dist</command> é localizado usando a propriedade <emphasis>origDir</emphasis>, neste exemplo, definido para o directório do pacote de nível de topo onde o <command>make dist</command> iria normalmente criá-lo e onde também é criado o link simbólico, como em cima.

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: <command>svn-buildpackage</command> output:
pt: resultados do <command>svn-buildpackage</command>

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: (using langupdate as the example package)
pt: (a usar o langupdate como o pacote do exemplo)

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: Note how the tarball (created by <command>make dist</command> and located by <emphasis>mergeWithUpstream</emphasis> due to the symlink)  is unpacked and then the exported SVN is applied on top. This allows maintainers to test local changes using <option>--svn-ignore</option>.
pt: Note como o tarball (criado pelo <command>make dist</command> e localizado por <emphasis>mergeWithUpstream</emphasis> devido ao link simbólico) é desempacotado e depois o SVN exportado é aplicado no topo. Isto permite aos responsáveis testar alterações locais usando <option>--svn-ignore</option>.

note: type: Content of: <book><chapter><sect1><sect2><title>
en: Native packages not using autotools
pt: Pacotes nativos que não usam autotools

note: type: Content of: <book><chapter><sect1><sect2><example><title>
en: The useNativeDist property.
pt: A propriedade useNativeDist

note: type: Content of: <book><chapter><sect1><sect2><para>
en: When <command>make dist</command> is not available, there are still situations where generated files may need to be included into the source tarball of the native package. <command>svn-buildpackage</command> supports the <emphasis>useNativeDist</emphasis> SVN property (applied to the <filename>./debian/</filename> directory) which allows for customised <command>make native-dist</command> target to be run immediately after the svn export.
pt: Quando <command>make dist</command> não está disponível, ainda existem situações onde os ficheiros gerados podem precisar de ser incluídos no tarball fonte do pacote nativo. O <command>svn-buildpackage</command> suporta a propriedade SVN <emphasis>useNativeDist</emphasis> (aplicada ao directório <filename>./debian/</filename>) o qual permite um destino <command>make native-dist</command> personalizado seja executado imediatamente após a exportação do svn.

note: type: Content of: <book><chapter><sect1><sect2><example><para>
en: <command>svn-buildpackage</command> uses this feature to include the POT file to aid translators. The custom <command>make</command> rule needs to be defined in the top level <filename>Makefile</filename>:
pt: O <command>svn-buildpackage</command> usa esta funcionalidade para incluir o ficheiro POT para ajudar os tradutores. A regra de <command>make</command> personalizada precisa ser definida no <filename>Makefile</filename> do nível do topo:

note: type: Content of: <book><chapter><sect1><sect2><example><programlisting>
en: # adds the POT file to the source tarball
    native-dist: Makefile
    	po4a-build --pot-only
pt: # adiciona o ficheiro POT ao tarball da fonte
    native-dist: Makefile
    	po4a-build --pot-only

note: type: Content of: <book><chapter><sect1><sect2><para>
en: The <emphasis>native-dist</emphasis> target needs to be idempotent and able to run straight from the SVN export. Any changes made by running the target will be directly reflected in the source tarball.  Ensure that no files are removed that would prevent the package being built as a normal Debian package, using only the resulting source package. (e.g. <command>cd</command> into the <filename>build-area</filename>, unpacking the <filename>.dsc</filename> with <command>dpkg-source -x</command> and rebuild the package, then remove the test directory.)
pt: O alvo do <emphasis>native-dist</emphasis> precisa de ser idempotente e ser capaz de correr direito a partir da exportação do SVN. Quaisquer alterações feitas ao correr o alvo serão reflectidas directamente no tarball da fonte. Certifique que nenhuns ficheiros são removidos que possam prevenir que o pacote seja construído como um pacote Debian normal, usando apenas o pacote fonte resultante. (ex. <command>cd</command> para <filename>build-area</filename>, desempacotar o <filename>.dsc</filename> com <command>dpkg-source -x</command> e reconstruir o pacote, então remover o directório de teste.)

note: type: Content of: <book><chapter><sect1><sect2><para>
en: The net result is that the resulting source tarball includes the <filename>po/svn-buildpackage.pot</filename> generated by the <emphasis>make native-dist</emphasis> target without needing to add the generated POT file to SVN (and requiring repeated commits each time the POT file is timestamped).
pt: O próximo resultado é que o tarball fonte resultante inclui o <filename>po/svn-buildpackage.pot</filename> gerado pelo alvo do <emphasis>make native-dist</emphasis> se a necessidade de adicionar o ficheiro POT gerado ao SVN (e requerer submissões repetidas para cada vez que é alterada a hora no ficheiro POT).

note: type: Content of: <book><chapter><title>
en: Common tasks
pt: Tarefas comuns

note: type: Content of: <book><chapter><sect1><para>
en: <command>svn-inject</command> will do the initial checkout for you.  If you need another working copy, run
pt: <command>svn-inject</command> irá fazer o checkout inicial para si. Se você precisar de outra cópia funcional, corra

note: type: Content of: <book><chapter><sect1><example><title>
en: <command>svn-inject</command> initial checkout
pt: initial checkout do <command>svn-inject</command>

note: type: Content of: <book><chapter><sect1><example><programlisting>
en: svn co <replaceable>protocol</replaceable>://<replaceable>repository-base-url</replaceable>/<replaceable>yourpackage</replaceable>
pt: svn co <replaceable>protocolo</replaceable>://<replaceable>url-do-repositorio-base</replaceable>/<replaceable>oseupacote</replaceable>

note: type: Content of: <book><chapter><sect1><title>
en: Building the package
pt: Construir o pacote

note: type: Content of: <book><chapter><sect1><para>
en: Change to your <filename>trunk</filename> directory and run:
pt: Mude para o directório <filename>trunk</filename> e corra:

note: type: Content of: <book><chapter><sect1><para>
en: You may recognise the options above -- they are passed directly to the build command (<command>dpkg-buildpackage</command> by default).  Normally, the build is done in another directory (exporting the source with <computeroutput>cp-la-like</computeroutput> method). If you want the resulting packages to be placed in the directory above, use the <option>--svn-move</option> option. To run Lintian after the build, use <option>--svn-lintian</option> option. More options are described in the <link linkend="sbman">manpage</link>.
pt: Você pode reconhecer as opções em cima -- elas são passadas directamente ao comando de construção (<command>dpkg-buildpackage</command> por predefinição). Normalmente, a construção é feita noutro directório (exportando a fonte com o método <computeroutput>cp-la-like</computeroutput>). Se você desejar que os pacotes resultantes sejam colocados no directório em cima, use a opção <option>--svn-move</option>. Para correr o Lintian após a construção, use a opção <option>--svn-lintian</option>. Mais opções estão descritas no <link linkend="sbman">manual</link>.

note: type: Content of: <book><chapter><sect1><para>
en: To build in a chroot using <command>pdebuild</command>, use:
pt: Para construir uma chroot usando o <command>pdebuild</command>, use:

note: type: Content of: <book><chapter><sect1><example><title>
en: pdebuild example
pt: pdebuild exemplo

note: type: Content of: <book><chapter><sect1><para>
en: For frequently used commands, use an alias in your <filename>~/.bashrc</filename> file:
pt: Para comandos frequentemente usados, use um nome alternativo (alias) no seu ficheiro <filename>~/.bashrc</filename>:

note: type: Content of: <book><chapter><sect1><example><title>
en: Useful aliases
pt: Nomes alternativos (aliases) úteis

note: type: Content of: <book><chapter><sect1><title>
en: Working with source
pt: Trabalhar com a fonte

note: type: Content of: <book><chapter><sect1><para>
en: Every time when you add or modify something, <command>svn-buildpackage</command> won't let you proceed unless suspicious files are in the clean state (unless you use the <option>--svn-ignore</option> switch).  You use the commands described in &quot;<link linkend="basics">basic svn usage</link>&quot; to register the new files (or move or delete the old ones) and commit the changes to the repository.
pt: A cada vez que você adicionar ou modificar algo, o <command>svn-buildpackage</command> não o deixa prosseguir a menos que os ficheiros suspeitos estejam num estado limpo (a menos que você use o switch <option>--svn-ignore</option>).  Você usa os comandos descritos em &quot;<link linkend="basics">utilização básica do svn</link>&quot; para registar os ficheiros novos (ou mover ou apagar os antigos) e submeter as alterações para o repositório.

note: type: Content of: <book><chapter><sect1><title>
en: Handling new upstream versions
pt: Lidar com as novas versões originais

note: type: Content of: <book><chapter><sect1><para>
en: Upgrading with new upstream version normally happens in two steps:
pt: A actualização dom nova versão da origem acontece normalmente em dois passos:

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: the <filename>current</filename> tree in the upstream branch is upgraded with the source from the new upstream package (the old version is kept in repository in <filename>branches/upstream/<replaceable>oldVersion</replaceable></filename>).
pt: a árvore <filename>current</filename> no branch de origem é actualizado com a fonte do novo pacote da origem (a versão antiga é mantida no repositório em <filename>branches/upstream/<replaceable>oldVersion</replaceable></filename>).

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: the version in <filename>trunk/</filename> becomes upgraded by merging the changes between the upstream versions into the <filename>trunk/</filename> directory.
pt: a versão em <filename>trunk/</filename> torna-se actualizada ao se fundir as alterações entre as versões de origem no directório <filename>trunk/</filename>.

note: type: Content of: <book><chapter><sect1><para>
en: The script <command>svn-upgrade</command> (formerly <command>svn-uupdate</command>) does both things for you and also creates a new changelog entry. The first step is done internally by using a third party script (<command>svn_load_dirs</command>, see Subversion book for documentation), the second step is done with the <command>merge</command> command of <command>svn</command>. Just run <command>svn-upgrade</command> from you local working directory (which corresponds the <filename>trunk/</filename> checkout product).
pt: O script <command>svn-upgrade</command> (anteriormente <command>svn-uupdate</command>) faz ambas por si e também cria uma nova entrada no registo de alterações. O primeiro passo é feito internamente ao utilizar um script de terceiros (<command>svn_load_dirs</command>, veja o livro Subversion para documentação), o segundo passo é feito com o comando <command>merge</command> do <command>svn</command>. Corra <command>svn-upgrade</command> a partir do seu directório de trabalho local (ao qual corresponde o produto de verificação do <filename>trunk/</filename>).

note: type: Content of: <book><chapter><sect1><para>
en: After running <command>svn-upgrade</command> some files may be in conflicting state. This is naturally happens if you have modified some files in the upstream package and now upstream did something similar on the same positions so <command>svn merge</command> was confused.
pt: Após correr o <command>svn-upgrade</command> alguns ficheiros podem ficar em estado de conflito. Isto acontece naturalmente se você modificou alguns ficheiros no pacote da origem e agora na origem fizeram algo semelhante nas mesmas posições, então o <command>svn merge</command> ficou confundido.

note: type: Content of: <book><chapter><sect1><para>
en: When <command>svn-upgrade</command> complains about files in conflicting state, fix them manually. When done, use the <command>svn resolved</command> command to mark them as clean and <command>svn commit</command> to update the repository.
pt: Quando o <command>svn-upgrade</command> se queixar de ficheiros em estado de conflito, corrija-os manualmente. Quando pronto, use o comando <command>svn resolved</command> para os marcar como limpos e <command>svn commit</command> para actualizar o repositório.

note: type: Content of: <book><chapter><sect1><title>
en: Finalizing the Revision
pt: Finalizar a Revisão

note: type: Content of: <book><chapter><sect1><para>
en: When you are ready to upload a new revision of your package, everything builds fine, the changelog is cleaned up and the package is tested, you can do the final build and tag the end version. To do so, add <option>--svn-tag</option> switch and after the package is built, it will be tagged (by creating a copy of the <filename>trunk/</filename> directory as said above).
pt: Quando você está pronto para fazer o upload de uma nova revisão do seu pacote, tudo constrói (compila) bem, o registo de alterações é limpo e o pacote é testado, você pode fazer a construção final e etiquetar a versão final. Para o fazer, adicione o switch <option>--svn-tag</option> e após a construção do pacote, ele será etiquetado (ao criar uma cópia do directório <filename>trunk/</filename> como descrito em cima).

note: type: Content of: <book><chapter><title>
en: Command reference
pt: Referência de comando

note: type: Content of: <book><chapter><title>
en: Further documentation
pt: Mais documentação

note: type: Content of: <book><chapter><sect1><title>
en: Various links
pt: Vários links

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Subversion Homepage: <ulink url="http://subversion.tigris.org/">http://subversion.tigris.org</ulink>
pt: Homepage do Subversion: <ulink url="http://subversion.tigris.org/">http://subversion.tigris.org</ulink>

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: The Subversion Book: <ulink url="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</ulink>
pt: O Livro Subversion: <ulink url="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</ulink>

note: type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
en: Subversion vs. CVS and others: <ulink url="http://better-scm.berlios.de/">http://better-scm.berlios.de/</ulink>
pt: Subversion vs. CVS e outros: <ulink url="http://better-scm.berlios.de/">http://better-scm.berlios.de/</ulink>

note: type: Content of: <book><bookinfo>
en: <date>Tue Aug 31 21:01:26 BST 2010</date>
pt: <date>Terça Agosto 31 21:01:26 BST 2010</date>

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This documentation is part of svn-buildpackage.
pt: Esta documentação é parte do svn-buildpackage.

note: type: Content of: <refentry><refentryinfo>
en: <placeholder type="address" id="0"/> <placeholder type="address" id="1"/> <author> <firstname>Eduard</firstname> <surname>Bloch</surname> <contrib>This manual page was written by Eduard Bloch in roff.  </contrib> </author> <author> <firstname>Goneri</firstname> <surname>Le Bouder</surname> <contrib>Converted manpages to SGML.</contrib> </author> <author> &dhfirstname; &dhsurname; <contrib>Converted manpages to DocBook XML and current Debian maintainer </contrib> </author> <copyright> <year>2009</year> <holder>&dhusername;</holder> </copyright> &dhdate;
pt: <placeholder type="address" id="0"/> <placeholder type="address" id="1"/> <author> <firstname>Eduard</firstname> <surname>Bloch</surname> <contrib>Este manual foi escrito por Eduard Bloch em roff.  </contrib> </author> <author> <firstname>Goneri</firstname> <surname>Le Bouder</surname> <contrib>Converteu o manual para SGML.</contrib> </author> <author> &dhfirstname; &dhsurname; <contrib>Converteu o manual para DocBook XML e é o responsável Debian actual </contrib> </author> <copyright> <year>2009</year> <holder>&dhusername;</holder> </copyright> &dhdate;

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: build Debian packages from SVN repository
pt: constrói pacotes Debian a partir de repositório SVN

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>&dhpackage;</command> <arg>[ <replaceable>OPTIONS</replaceable>... ] [ <replaceable>OPTIONS</replaceable> for <command>dpkg-buildpackage</command> ] </arg>
pt: <command>&dhpackage;</command> <arg>[ <replaceable>OPÇÕES</replaceable>... ] [ <replaceable>OPÇÕES</replaceable> para o <command>dpkg-buildpackage</command> ] </arg>

note: type: Content of: <refentry><refsect1><title>
en: DESCRIPTION
pt: DESCRIÇÃO

note: type: Content of: <refentry><refsect1><para>
en: Builds a Debian package from a Subversion repository. The source code repository must be in the format created by <command>svn-inject</command>, and this script must be executed from the working directory (<filename>trunk/<replaceable>package</replaceable></filename>).
pt: Constrói um pacote Debian a partir de um repositório Subversion. O repositório de código fonte tem de estar no formato criado pelo <command>svn-inject</command>, e este script tem de ser executado no directório de trabalho (<filename>trunk/<replaceable>pacote</replaceable></filename>).

note: type: Content of: <refentry><refsect1><para>
en: By default, the working directory is used as the main source directory (assuming the whole upstream source is being stored in the repository).  The alternative is so called "merge mode". With this method, only the <filename>debian</filename> directory (and maybe some other modified files) are stored in the repository.  At build time, the contents of the svn trunk are copied to the extracted tarball contents (and can overwrite parts of it). To choose this working model, set the <command>svn</command> property <emphasis>mergeWithUpstream</emphasis> on the <filename>debian</filename> directory
pt: Por predefinição, o directório de trabalho é usado como o directório de fonte principal (assumindo que toda a fonte original está armazenada no repositório). A alternativa é o chamado "modo merge". Com este método, apenas o directório <filename>debian</filename> (e talvez outros ficheiros modificados) são armazenados no repositório. Durante a construção, o conteúdo do trunk svn é copiado para o conteúdo do tarball extraído (e pode sobrescrever partes dele). Para escolher este modelo de trabalho, defina a propriedade <userinput>mergeWithUpstream</userinput> do <command>svn</command> no directório <filename>debian</filename>.

note: type: Content of: <refentry><refsect1><para>
en: <emphasis>mergeWithUpstream</emphasis> requires that the build system can prepare a tarball, typically using <command>make dist</command> and autotools. All upstream packages will have some form of tarball creation support and native packages that use autotools or which have internal tarball support can use <emphasis>mergeWithUpstream</emphasis> to handle generated files that are needed to build the package but are not present in SVN. See the HOWTO guide for examples of how this can be done. Native packages that do not use autotools and do not have internal tarball support can still add generated files to the source package tarball using the <emphasis>useNativeDist</emphasis> make target in the top level <filename>Makefile</filename>. This custom target must be idempotent and only modify / generate the desired files using only the exported SVN source and build dependencies. To allow <command>svn-buildpackage</command> to use an <command>make native-dist</command> target in your top level <filename>Makefile</filename>, set the <emphasis>useNativeDist</emphasis> property on the <filename>./debian/</filename> directory:
pt: <emphasis>mergeWithUpstream</emphasis> requer que o sistema possa preparar um tarball, usando tipicamente <command>make dist</command> e autotools. Todos os pacotes da origem irão ter alguma forma de suporte a criação de tarball e os pacotes nativos que usam autotools ou têm suporte de tarball interno podem usar <emphasis>mergeWithUpstream</emphasis> para lidar com os ficheiros gerados que são necessários para construir o pacote mas não estão presentes no SVN. Veja o guia HOWTO para exemplos de como isto pode ser feito. Os pacotes nativos que não usam autotools e não têm suporte de tarball interno podem ainda adicionar os ficheiros gerados ao tarball do pacote fonte usando o <emphasis>useNativeDist</emphasis> ao alvo do <filename>Makefile</filename> de nível de topo. Este alvo personalizado tem de ser idempotente e apenas modificar / gerar os ficheiros desejados usando apenas a fonte SVN exportada e as dependências de construção. Para permitir ao <command>svn-buildpackage</command> usar um alvo <command>make native-dist</command> no seu <filename>Makefile</filename> de nível de topo, regule a propriedade <emphasis>useNativeDist</emphasis> no directório <filename>./debian/</filename>:

note: type: Content of: <refentry><refsect1><para>
en: The default behaviour of <command>svn-buildpackage</command> is as follows:
pt: O comportamento predefinido do <command>svn-buildpackage</command> é o seguinte:

note: type: Content of: <refentry><refsect1><para>
en: Check the working directory, complain on uncommited files (also see <option>--svn-ignore-new</option>)
pt: Verifica o directório de trabalho, queixa-se de ficheiros não submetidos (veja também <option>--svn-ignore-new</option>)

note: type: Content of: <refentry><refsect1><para>
en: Copy the orig tarball to the build area if necessary (also see <option>--svn-no-links</option>)
pt: Copia o tarball de origem para a área de construção se necessário (veja também <option>--svn-no-links</option>)

note: type: Content of: <refentry><refsect1><para>
en: Extract the tarball (in merge mode) or export the svn work directory to the build directory (also see below and <option>--svn-no-links</option>)
pt: Extrai o tarball (em modo de fusão) ou exporta o directório de trabalho do svn para o directório de construção (veja também em baixo e <option>--svn-no-links</option>)

note: type: Content of: <refentry><refsect1><para>
en: Build with <command>dpkg-buildpackage</command> (also see <option>--svn-builder</option>, <option>--svn-lintian</option>, etc.)
pt: Constrói com o <command>dpkg-buildpackage</command> (veja também <option>--svn-builder</option>, <option>--svn-lintian</option>, etc.)

note: type: Content of: <refentry><refsect1><para>
en: Create a changelog entry for the future version
pt: Cria um entrada no registo de alterações para a versão futura

note: type: Content of: <refentry><refsect1><title>
en: OPTIONS
pt: OPÇÕES

note: type: Content of: <refentry><refsect1><para>
en: <command>&dhpackage;</command> accepts the following options on the command-line:
pt: <command>&dhpackage;</command> aceita as seguintes opções na linha de comandos:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>--svn-builder=COMMAND</option>
pt: <option>--svn-builder=COMANDO</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Specifies alternative build command instead of <command>dpkg-buildpackage</command>, eg.  <command>debuild</command>, <command>pdebuild</command>, etc. Every parameter that <command>svn-buildpackage</command> doesn't know (<emphasis>--svn-*</emphasis>) is passed to <option>COMMAND</option>. There is no difference between the command line and config file parameters . They are used at the same time.
pt: Especifica um comando de construção alternativo em vez de <command>dpkg-buildpackage</command>, ex. <command>debuild</command>, <command>pdebuild</command>, etc. Cada parâmetro que o <command>svn-buildpackage</command> não conhece (<emphasis>--svn-*</emphasis>) é passado para <option>COMMAND</option>. Não existe diferença entre os parâmetros de linha de comandos e ficheiro de configuração. Eles são usados ao mesmo tempo.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: WARNING: shell quotation rules do not completely apply here, better use wrappers for complex constructs. Using this option may break <emphasis>--svn-lintian</emphasis> and <emphasis>--svn-move</emphasis> functionality. Some functions may be disabled when a custom build command is used because the output file location is not predictable.
pt: AVISO: as regras de cotação da shell não se aplicam completamente aqui, é melhor usar wrappers para construções complexas. Usar esta opção pode quebrar a funcionalidade de <emphasis>--svn-lintian</emphasis> e <emphasis>--svn-move</emphasis>. Algumas funções podem ser desactivadas quando é usado um comando de construção personalizado porque a localização do ficheiro resultante não é previsível.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: use <command>dpkg-buildpackage</command>.
pt: Predefinição: usa <command>dpkg-buildpackage</command>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Don't stop on svn conflicts or new/changed files.  To set this behaviour for single files set the <userinput>deb:ignoreM</userinput> property to 1 on them.  Also see documentation of the svn:ignore property in the SVN book.
pt: Não pára em conflitos do svn ou ficheiros novos/alterados. Para definir este comportamento para ficheiros únicos defina a propriedade <userinput>deb:ignoreM</userinput> para 1 neles. Veja também a documentação da propriedade svn:ignore no livro do SVN.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: Stop on conflicts or new/changed files.
pt: Predefinição: Pára em conflitos ou ficheiros novos/alterados.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Don't run debian/rules clean.
pt: Não corre a limpeza de debian/rules.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: clean first
pt: Predefinição: primeiro limpa.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Don't use file links but try to export or do hard copies of the working directory. This is useful if your package fails to build because some files, empty directories, broken links, ...  cannot be transported with in the default link-copy mode.
pt: Não use links de ficheiro mas tente exportá-los ou fazer cópias físicas do directório de trabalho. Isto é útil se o seu pacote falhar na construção devido a alguns ficheiros, directórios vazios, links quebrados... não poderem ser transportados no modo link-copy predefinido.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: use links where possible.
pt: Predefinição: usa os links onde possível.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Don't remove the build directory when the build is done.
pt: Não remove o directório de construção quando a construção está pronta.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: remove after successful build.
pt: Predefinição: remove após construção com sucesso.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If possible, reuse an existing build directory in subsequent builds. The build directory is not purged after the build, it is not renamed when a build starts and the files are just copied over into it. Useful in <emphasis>mergeWithUpstream</emphasis> mode with large packages.
pt: Se possível, reutilize um directório de construção existente nas construções subsequentes. O directório de construção não é purgado após a construção, não é renomeado quando uma construção começa e os ficheiros são apenas copiados para ele. Útil em modo <emphasis>mergeWithUpstream</emphasis> como pacotes grandes.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: build directory is removed.
pt: Predefinição: o directório de construção é removido.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If a previous build directory is found, remove it before building instead of renaming it. If <emphasis>--svn-reuse</emphasis> is also given in the same line, the reuse behaviour occurs.
pt: Se for encontrado um directório de construção anterior, remove-o antes da construção em vez de o renomear. Se <emphasis>--svn-reuse</emphasis> for também fornecido na mesma linha, o corre o comportamento de reutilização.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: rename old directories with a '<option>obsolete</option>' suffix.
pt: Predefinição: renomeia os directórios antigos com o sufixo '<option>obsolete</option>'.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Just export the working directory and do necessary code merge operations, then exit.
pt: Apenas exporta o directório de trabalho e faz as operações de fusão de código necessárias, e depois termina.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: Off.
pt: Predefinição: Desligado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Final build: Tag, export, build cleanly &amp; make new changelog entry.
pt: Construção final: Etiqueta, exporta, constrói com limpeza &amp; cria nova entrada no registo de alterações.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Don't build the package, do only the tag copy.
pt: Não constrói o pacote, apenas faz a cópia da etiqueta.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If an existing target directory has been found while trying to create the tag copy, remove the target directory first.
pt: Se um directório alvo existente foi encontrado durante a tentativa de criação da cópia de etiqueta, primeiro remove o directório alvo.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: No new Debian changelog entry is added automatically.
pt: Nenhuma entrada no registo de alterações Debian é adicionada automaticamente.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: A new <emphasis>UNRELEASED</emphasis> changelog entry is set via <command>dch</command>.
pt: Predefinição: Uma nova entrada no registo de alterações <emphasis>UNRELEASED</emphasis> é definida via <command>dch</command>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Run lintian on the resulting changes file when done.
pt: Corre o lintian no ficheiro de alterações resultante quando pronto.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: When done, move the created files (as listed in <filename>.changes</filename>) to the parent directory, relative to the one where <command>svn-buildpackage</command> was started.
pt: Quando pronto, move os ficheiros criados (como listado em <filename>.changes</filename>) para o directório pai, relativo àquele onde o <command>svn-buildpackage</command> foi iniciado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Specifies the target directory to which to move the generated files.
pt: Especifica o directório alvo para onde mover os ficheiros gerados.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: Off. (Files are left where the build command puts them.)
pt: Predefinição: Desligado. (Os ficheiros são deixados onde o comando de construção os colocou.)

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>--svn-pkg=packagename</option>
pt: <option>--svn-pkg=nome_de_pacote</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Overrides the detected package name. Use with caution since it could be set too late during the processing (eg.  still have the old value when expanding shell variables).
pt: Sobrepõe o nome de pacote detectado. Use com cuidado porque pode ser definido tarde demais durante o processamento (ex. ainda ter o valor antigo quando expandir variáveis da shell).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>--svn-arch=ARCH</option>
pt: <option>--svn-arch=ARQUITECTURA</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Allows specifying the build architecture (e.g.  i386 build on an amd64 machine).
pt: Permite especificar a arquitectura de construção (ex. construir para i386 numa máquina amd64).

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>--svn-override=var=value,anothervar=value</option>
pt: <option>--svn-override=var=valor,anothervar=valor</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Overrides any config variable that has been autodetected or found in <emphasis>.svn/deb-layout</emphasis>.
pt: Sobrepõe qualquer variável de configuração que tenha sido auto-detectada ou encontrada em <emphasis>.svn/deb-layout</emphasis>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Commands (hooks) to be executed before/after the build/tag command invocations, e.g. to download the orig tarballs from the archive. Shell code can be emdded here though it is not recommended. Various helping variables are available in the environment, see ENVIRONMENT VARIABLES below for detailed explanation.
pt: Comandos (hooks) a serem executados antes/após as invocações dos comandos de construção/etiquetagem, ex. para descarregar os tarballs de origem a partir do arquivo. Aqui pode ser incluído código de shell apesar de não ser recomendado. Várias variáveis de ajuda estão disponíveis no ambiente, veja VARIÁVEIS DE AMBIENTE em baixo para uma explicação detalhada.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Please note that the prebuild and postbuild hooks replace the normal prebuild and postbuild actions of <command>svn-buildpackage</command>. For prebuild, this means that the build dependencies will not be checked. For postbuild, this means that the resulting files won't be moved, and lintian will not be run.
pt: Por favor note que os hooks prebuild e postbuild substituem as acções prebuild e postbuild normais do <command>svn-buildpackage</command>. Para prebuild, isto significa que as dependências de construção não serão verificadas. Para postbuild, isto significa que os ficheiros resultantes não serão movidos, e o lintian não será executado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Defaults: Off.
pt: Predefinição: Desligado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: With this parameter <command>svn-buildpackage</command> will not interact with the user.
pt: Com este parâmetro o <command>svn-buildpackage</command> não irá interagir com o utilizador.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: By default, <command>svn-buildpackage</command> used to create <filename>.svn/deb-layout</filename> on every invocation.  Since version 0.6.22 this behaviour is deprecated.
pt: Por predefinição, o <command>svn-buildpackage</command> costumava criar <filename>.svn/deb-layout</filename> a cada invocação. Desde a versão 0.6.22 que este comportamento está descontinuado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: With this parameter <command>svn-buildpackage</command> will (partly) replicate the old behaviour. In contrast to the deprecated behaviour, the <emphasis>.svn/deb-layout</emphasis> is regarded as a local override; the old behaviour simply ignored any versioned layout information if it found <emphasis>.svn/deb-layout</emphasis>.
pt: Com este parâmetro o <command>svn-buildpackage</command> irá (parcialmente) replicar o comportamento antigo. Em contraste com o comportamento descontinuado, o <emphasis>.svn/deb-layout</emphasis> é reconhecido como uma sobreposição local; o comportamento antigo simplesmente ignorava qualquer informação de disposição com versão se encontrasse <emphasis>.svn/deb-layout</emphasis>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option was provided since it can be useful when creating a local override file.
pt: Esta opção foi disponibilizada porque pode ser útil quando se cria um ficheiro de sobreposição local.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option makes <command>svn-buildpackage</command> try to download the upstream tarball using <command>apt</command> and <command>uscan</command>.
pt: Esta opção faz com que o <command>svn-buildpackage</command> tente descarregar o tarball da origem usando <command>apt</command> e <command>uscan</command>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: More verbose program output.
pt: Saída do programa mais detalhada.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show the help message.
pt: Mostra a mensagem de ajuda.

note: type: Content of: <refentry><refsect1><title>
en: EXAMPLES
pt: EXEMPLOS

note: type: Content of: <refentry><refsect1><para>
en: For more detailed information on how to use <command>svn-buildpackage</command>, see the HOWTO <ulink url="http://svn-bp.alioth.debian.org/"> http://svn-bp.alioth.debian.org/</ulink>.
pt: Para informação mais detalhada de como usar o <command>svn-buildpackage</command>, veja o HOWTO. <ulink url="http://svn-bp.alioth.debian.org/"> http://svn-bp.alioth.debian.org/</ulink>.

note: type: Content of: <refentry><refsect1><para>
en: To start working with existing native Debian package from a <filename>*.dsc</filename> file, import it into the repository with command:
pt: Para começar a trabalhar com um pacote Debian nativo existente a partir de um ficheiro <filename>*.dsc</filename>, importe-o para o repositório com o comando:

note: type: Content of: <refentry><refsect1><para>
en: To start working with existing upstream package in Debian from a <filename>*.dsc</filename> file, import it into the repository with command:
pt: Para começar a trabalhar com um pacote da origem existente em Debian a partir de um ficheiro <filename>*.dsc</filename>, importe-o para o repositório com o comando:

note: type: Content of: <refentry><refsect1><para>
en: Before building an upstream package, ensure the original source is available, e.g. if <command>uscan</command> is working:
pt: Antes de construir um pacote da origem, certifique-se que a fonte original está disponível, ex. se o <command>uscan</command> está a funcionar:

note: type: Content of: <refentry><refsect1><para>
en: To test building the package from Subversion repository, use command below. Refer to <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> manual page for the <option>-us</option> etc. options:
pt: Para uma construção teste do pacote a partir de repositório SVN, use o comando abaixo. Use referências do manual do <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para as opções <option>-us</option> etc.

note: type: Content of: <refentry><refsect1><para>
en: To check that package build in a clean state, test it with <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>:
pt: Para verificar que o pacote constrói num estado limpo, teste-o com <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>:

note: type: Content of: <refentry><refsect1><screen>
en: svn mkdir ../build-area  # To store results
    svn propset svn:ignore "*" ../build-area
    svn-buildpackage --svn-ignore-new --svn-builder=pdebuild
pt: svn mkdir ../build-area  # Para armazenar resultados
    svn propset svn:ignore "*" ../build-area
    svn-buildpackage --svn-ignore-new --svn-builder=pdebuild

note: type: Content of: <refentry><refsect1><para>
en: When a new upstream release becomes available, commit all changes and have the working tree in clean state. Then use <citerefentry> <refentrytitle>svn-upgrade</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to import the new release:
pt: Quando um novo lançamento da origem está disponível, submete todas as alterações e tem a árvore de trabalho num estado limpo. Depois usa o <citerefentry> <refentrytitle>svn-upgrade</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para importar o novo lançamento.

note: type: Content of: <refentry><refsect1><screen>
en: svn status   # Check that there are no uncommited changes
    svn-upgrade --verbose ../package-2.0.tar.gz
pt: svn status   # Verifica que não há alterações não submetidas
    svn-upgrade --verbose ../package-2.0.tar.gz

note: type: Content of: <refentry><refsect1><title>
en: CONFIGURATION FILE
pt: FICHEIRO DE CONFIGURAÇÃO

note: type: Content of: <refentry><refsect1><para>
en: <command>svn-buildpackage</command>'s behaviour can be modified using the file <filename>~/.svn-buildpackage.conf</filename>. Additional parts can be added in each package working directory using the file <filename>.svn/svn-buildpackage.conf</filename>. It is essentially a list of the long command line options (without leading minus signs), one argument per line (without quotes surrounding multi-word arguments). The variables are expanded with the system shell if shell variables are found there. Avoid ~ sign because of unreliable expansion: it is better to use $HOME instead.  Example:
pt: O comportamento do <command>svn-buildpackage</command> pode ser modificado usando o ficheiro <filename>~/.svn-buildpackage.conf</filename>. Podem ser adicionadas partes adicionais em cada directório de trabalho de pacote usando o ficheiro <filename>.svn/svn-buildpackage.conf</filename>. É essencialmente uma lista de opções longas de linha de comandos (sem os sinais menos iniciais), um argumento por linha (sem citações envolvendo os argumentos de múltiplas palavras). As variáveis são expandidas com a shell do sistema se lá existirem variáveis de shell. Evite o sinal ~ porque não é expansão de confiança: É melhor usar antes $HOME. Exemplo:

note: type: Content of: <refentry><refsect1><screen>
en: svn-builder=debuild -EPATH
    svn-no-links
    svn-override=origDir=$HOME/debian/upstream/$PACKAGE
    # svn-ignore-new
    #svn-lintian
pt: svn-builder=debuild -EPATH
    svn-no-links
    svn-override=origDir=$HOME/debian/upstream/$PACOTE
    # svn-ignore-new
    #svn-lintian

note: type: Content of: <refentry><refsect1><title>
en: DIRECTORY LAYOUT HANDLING
pt: MANUSEAMENTO DA DISPOSIÇÃO DO DIRECTÓRIO

note: type: Content of: <refentry><refsect1><para>
en: By default, <command>svn-buildpackage</command> expects a configuration file with path/url declaration, <filename>.svn/deb-layout</filename>. The values there can be overridden with the <option>--svn-override</option> option, see above. If a config file could not be found, the settings are autodetected following the usual assumptions about local directories and repository layout.  In addition, the contents of a custom file <filename>debian/svn-deblayout</filename> will be imported during the initial configuration. Package maintainers can store this file in the repository to pass correct defaults to new <command>svn-buildpackage</command> users. The format is the same as in the file <filename>.svn/deb-layout</filename>. As an alternative to the <filename>debian/svn-deblayout</filename> file, maintainers can set Subversion properties for the <filename>debian/</filename> directory; any properties of <filename>debian/</filename> which have a name of the form <emphasis>svn-bp:<replaceable>PROP</replaceable></emphasis> will be the source of a <replaceable>PROP</replaceable> setting which has the value indicated by the first line of the property value. If a full svn URL is not given, the repository root will be prepended to this value.
pt: Por predefinição, o <command>svn-buildpackage</command> espera um ficheiro de configuração com declaração de caminho/url, <filename>.svn/deb-layout</filename>. Os valores de lá podem ser sobrepostos com a opção <option>--svn-override</option>, veja em cima. Se um ficheiro de configuração não pode ser encontrado, as definições são auto-detectadas seguindo as deduções normais acerca de directórios locais e disposição do repositório. Adicionalmente, o conteúdo de um ficheiro personalizado <filename>debian/svn-deblayout</filename> será importado durante a configuração inicial. Os responsáveis pelo pacote podem armazenar este ficheiro no repositório para passar predefinições correctas aos novos utilizadores do <command>svn-buildpackage</command>. O formato é o mesmo que no ficheiro <filename>.svn/deb-layout</filename>. Como uma alternativa ao ficheiro <filename>debian/svn-deblayout</filename>, os responsáveis podem definir as propriedades do Subversion para o directório <filename>debian/</filename>, quaisquer propriedades de <filename>debian/</filename> que tenham um nome no formato <emphasis>svn-bp:<replaceable>PROP</replaceable></emphasis> serão a fonte da definição <replaceable>PROP</replaceable> a qual tem o valor indicado pela primeira linha do valor da propriedade. Se não for fornecido um URL de svn completo, o repositório raiz irá ser precedido para este valor.

note: type: Content of: <refentry><refsect1><title>
en: ENVIRONMENT VARIABLES
pt: VARIÁVEIS DE AMBIENTE

note: type: Content of: <refentry><refsect1><para>
en: The following environment variables are exported by <command>svn-buildpackage</command> and can be used in hook commands or the package build system.
pt: As seguintes variáveis de ambiente são exportadas pelo <command>svn-buildpackage</command> e podem ser usadas em hook a comandos ou ao sistema de construção de pacotes.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: PACKAGE
pt: PACOTE

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: package
pt: pacote

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The source package name.
pt: O nome do pacote fonte.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Version of <command>svn-buildpackage</command>.
pt: Versão do <command>svn-buildpackage</command>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The complete Debian version string, also used for the tag copy.
pt: A string de versão Debian completa, também usada para a copia de etiqueta.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Same as <option>debian_version</option> but without any epoch strings.
pt: O mesmo que <option>debian_version</option> mas sem strings de época.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Same as debian_version but without Debian extensions
pt: O mesmo que debian_version mas sem extensões Debian

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Guessed upstream source package name in the pool, something like <filename>libm/libmeta-html-perl_3.2.1.0.orig.tar.gz</filename>
pt: Nome do pacote fonte da origem adivinhado na pool, algo como <filename>libm/libmeta-html-perl_3.2.1.0.orig.tar.gz</filename>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: (experimental) shows the location of generated diff file
pt: (experimental) mostra a localização do ficheiro diff gerado

note: type: Content of: <refentry><refsect1><para>
en: All the layout properties are exported to the environment, too.  The following ones have meaning to <command>svn-buildpackage</command>.
pt: Todas as propriedades de disposição são também exportadas para o ambiente. As seguintes têm significado para o <command>svn-buildpackage</command>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: the location of build area directory
pt: a localização do directório de área de construção

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: the URL of the trunk directory for the current package.
pt: o URL do directório trunk para o pacote actual.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: the URL of the tags base directory for the current package.
pt: o URL do directório base de etiquetas para o pacote actual.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: the local directory where the orig tarball should be located.
pt: o directório local onde o tarball original deve estar colocado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: the URL from where the orig tarball for the current package can be pulled from.
pt: o URL de onde pode ser puxado o tarball original do pacote actual.

note: type: Content of: <refentry><refsect1><para>
en: The following variables are understood by <command>svn-buildpackage</command>:
pt: As seguintes variáveis são compreendidas pelo <command>svn-buildpackage</command>:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Ignore the signs of an incomplete changelog and tag the repository anyway.
pt: Ignora os sinais de um registo de alterações incompleto e etiqueta o repositório mesmo assim.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Export upstream source from the repository even if <userinput>mergeWithUpstream</userinput> property is set.
pt: Exporta a fonte da origem a partir do repositório mesmo que a propriedade <userinput>mergeWithUpstream</userinput> esteja definida.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: If <option>DEBIAN_FRONTEND</option> is set to 'noninteractive' <option>--svn-noninteractive</option> is called silently.
pt: Se <option>DEBIAN_FRONTEND</option> estiver definida para 'noninteractive', <option>--svn-noninteractive</option> é chamado em silêncio.

note: type: Content of: <refentry><refsect1><title>
en: RECOMMENDATIONS
pt: RECOMENDAÇÕES

note: type: Content of: <refentry><refsect1><para>
en: Use shell aliases. Here are some examples for Bash:
pt: Usa nomes alternativos de shell. Aqui estão alguns exemplos para Bash:

note: type: Content of: <refentry><refsect1><para>
en: Those commands have respective meanings: build regardless of new or changed files; build regardless of new or changed files and reuse the build directory; build (for upload) and tag.
pt: Esses comandos têm significados respectivos: construir independentemente de ficheiros novos ou alterados; construir independentemente de ficheiros novos ou alterados e reutiliza o directório de construção; construir e etiquetar (para upload).

note: type: Content of: <refentry><refsect1><para>
en: SSH is the easiest way to access remote repositories, although it usually requires entering a password more frequently with <command>svn-buildpackage</command>.  Workarounds include using an ssh key without a passphrase (although this is insecure and still relatively slow), or the SSH connection caching feature present in recent versions of SSH. For details, see the <command>svn-buildpackage</command> manual.
pt: SSH é o modo mais fácil de aceder a repositórios remotos, apesar de geralmente requerer a entrada da palavra passe com mais frequência com o <command>svn-buildpackage</command>. Meios de contornar incluem usar uma chave ssh com uma frase passe (apesar de isto ser inseguro e mesmo assim relativamente lento), ou a funcionalidade de cache da ligação SSH presente nas versões recentes do SSH. Para mais detalhes, veja o manual do <command>svn-buildpackage</command>.

note: type: Content of: <refentry><refsect1><para>
en: Another way to get a remote link is using the Subversion DAV module (with SSL and Apache user authentication), see the <command>svn-buildpackage</command> HOWTO manual for details.
pt: Outro modo de obter uma ligação remota é usar o módulo DAV do Subversion (com SSL e autenticação do utilizador do Apache), veja o manual HOWTO do <command>svn-buildpackage</command> para mais detalhes.

note: type: Content of: <refentry><refsect1><title>
en: SEE ALSO
pt: VEJA TAMBÉM

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The svn-buildpackage HOWTO manual
pt: O manual HOWTO do svn-buildpackage

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: puts a Debian source package into Subversion repository
pt: coloca um pacote fonte Debian num repositório Subversion

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: upgrade source package from a new upstream revision
pt: actualiza o pacote fonte a partir de uma nova revisão da origem

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Subversion command line client tool
pt: ferramenta cliente Subversion de linha de comandos

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Debian source package tools
pt: Ferramentas de pacotes fonte Debian

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Debian package checker
pt: Verificador de pacotes Debian

note: type: Content of: <refentry><refnamediv><refpurpose>
en: export a source and run a command inside the source.
pt: exporta uma fonte e corre um comando dentro da fonte.

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>&dopackage; COMMAND</command>
pt: <command>&dopackage; COMANDO</command>

note: type: Content of: <refentry><refsect1><para>
en: <command>svn-do</command> will use <command>svn-buildpackage</command> to export a source, run a command inside the exported source and, if the command succeeds, copy back the debian/ tree
pt: O <command>svn-do</command> irá usar o <command>svn-buildpackage</command> para exportar uma fonte, correr um comando dentro da fonte exportada e, se o comando tiver sucesso, copiar de volta para a árvore debian/

note: type: Content of: <refentry><refsect1><title>
en: Examples
pt: Exemplos

note: type: Content of: <refentry><refsect1><para>
en: clean the tree (useful if this requires the full source tree)
pt: limpa a árvore (útil se isto requerer a árvore fonte completa)

note: type: Content of: <refentry><refsect1><para>
en: use <command>quilt</command> to refresh a patch
pt: usa o <command>quilt</command> para refrescar uma patch

note: type: Content of: <refentry><refsect1><para>
en: Start a source editing session and decide later not to copy back the debian/ tree
pt: Inicia uma sessão de edição de fonte e mais tarde decide não a copiar de volta para a árvore debian/

note: type: Content of: <refentry><refsect1><para>
en: edit a patch in a CDBS' simple-patchsys based package
pt: edita uma patch num pacote baseado em simple-patchsys de CDBS

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>&injectpackage; [<replaceable>options</replaceable>] <replaceable>package</replaceable>.dsc <replaceable>repository_URL</replaceable></command>
pt: <command>&injectpackage; [<replaceable>opções</replaceable>] <replaceable>pacote</replaceable>.dsc <replaceable>URL_do_repositório</replaceable></command>

note: type: Content of: <refentry><refsect1><para>
en: <command>&injectpackage;</command> accepts the following options on the command-line:
pt: <command>&injectpackage;</command> aceita as seguintes opções na linha de comandos:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: print the help menu
pt: escreve o menu de ajuda

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make the command output verbose
pt: Torna o saída do comando mais detalhada

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Hide less important messages
pt: Esconde as mensagens menos importantes

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Layout type. 1 (default) means package/{trunk,tags,branches,...} scheme, 2 means the {trunk,tags,branches,...}/package scheme.
pt: Tipo de disposição. 1 (predefinido) significa esquema pacote/{trunk,tags,branches,..}, 2 significa o esquema {trunk,tags,branches,...}/pacote.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: 1
pt: Predefinição: 1

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-t directory</option>
pt: <option>-t directório</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Specify the directory where the .orig.tar.gz files are stored on the local machine.
pt: Especifica o directório onde os ficheiros .orig.tar.gz estão armazenados na máquina local.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-d</option> | <option>--do-like=directory</option>
pt: <option>-d</option> | <option>--do-like=directório</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Looks at the working directory of some other package and uses its base URL, tarball storage directory and similar checkout target directory.
pt: Procura o directório de trabalho de um outro pacote e usa o seu URL base, directório de armazenamento de tarball e directório de alvo de verificação semelhante.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-c number</option>
pt: <option>-c numero</option>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Checkout nothing (0), trunk directory (1) or everything (2) when the work is done.
pt: Faz a verificação final (Checkout) a nada (0), directório trunk (1) ou a tudo (2) quando o trabalho está pronto.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only keep modified files under SVN control (including the debian/ directory), track only parts of upstream branch
pt: Apenas mantêm os ficheiros modificados sob controle de SVN (incluindo o directório debian/), segue apenas partes do branch da origem

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Do not create the <filename>branches</filename> subdirectory at all. This works in a similar way to <option>-o</option> but all changes on upstream files (e.g. meta changes like updating the <filename>config.guess</filename> and <filename>config.sub</filename> files) are ignored and the upstream branch is not used.
pt: Não cria o sub-directório <filename>branches</filename>. Isto funciona de modo semelhante a <option>-o</option> mas todas as opções nos ficheiros da origem (ex. meta alterações como actualizar os ficheiros <filename>config.guess</filename> e <filename>config.sub</filename>) são ignoradas e o branch de origem não é usado.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: use <filename>branches/</filename>.
pt: Predefinição: usa <filename>branches/</filename>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: By default, <command>svn-inject</command> used to create <filename>.svn/deb-layout</filename> after an inject operation if a checkout followed the inject.  Since version 0.6.22 this behaviour is deprecated.
pt: Por predefinição, o <command>svn-inject</command> costumava criar <filename>.svn/deb-layout</filename> após uma operação de injecção se uma verificação se seguisse à injecção. Desde a versão 0.6.22 que este comportamento está descontinuado e obsoleto.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: With this parameter <command>svn-inject</command> will replicate the old behaviour.
pt: Com este parâmetro o <command>svn-inject</command> irá replicar o comportamento antigo.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Set svn-bp:* props on the debian directory automatically.
pt: Define os adereços svn-bp:* no directório debian automaticamente.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: upgrade source package from a new upstream revision.
pt: actualiza pacote fonte a partir de uma nova revisão da origem.

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>&upgradepackage; newsource [options]</command>
pt: <command>&upgradepackage; newsource [opções]</command>

note: type: Content of: <refentry><refsect1><para>
en: <command>&upgradepackage;</command> modifies a Debian package source located in a Subversion repository, upgrading it to a new upstream release. The repository filesystem tree must be in the format created by <command>svn-inject</command>.
pt: <command>&upgradepackage;</command> modifica um pacote fonte Debian localizado num repositório Subversion, actualizando-o para um novo lançamento da origem. A árvore do sistema de ficheiros do repositório tem de estar no formato criado pelo <command>svn-inject</command>.

note: type: Content of: <refentry><refsect1><para>
en: <command>&upgradepackage;</command> accepts the following options on the command-line:
pt: <command>&upgradepackage;</command> aceita as seguintes opções na linha de comandos:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Forces a different upstream version string
pt: Força uma string de versão upstream diferente

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Runs <option>make clean</option> and removes the <filename>debian/</filename> directory in the new source.
pt: Executa <option>make clean</option> e remove o directório <filename>debian/</filename> na nova fonte.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Forces a different package name
pt: Força um nome de pacote diferente

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: More verbose program output
pt: Saída do programa mais detalhada

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Extra cleanup run: replaces all conflicting files with upstream versions. Review of <command>svn status</command> output before doing that could make sense.
pt: Execução de limpeza extra: substitui todos os ficheiros em conflito com versões da origem. Uma revisão aos resultados de <command>svn status</command> antes de fazer isto pode fazer sentido.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Upgrade without making a new changelog entry.
pt: Actualiza sem criar uma nova entrada no registo de alterações.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Default: Make the changelog entry.
pt: Predefinição: Cria a entrada no registo de alterações.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Use <command>uscan</command> to download the new version.
pt: Usa o <command>uscan</command> para descarregar a nova versão.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Turn off interactive mode.
pt: Desliga o modo interactivo.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: In noninteractive mode, ignore errors.
pt: No modo não-interactivo, ignora os erros.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Make files that are ignored due to subversion ignore patterns to be 'import'ed or 'skip'ed.
pt: Faz com que os ficheiros que são ignorados devido aos padrões de ignorar do subversion sejam 'importados' ou 'saltados'.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Automatically increase version epoch if the new upstream version is not greater than the current.
pt: Aumenta automaticamente a época da versão se a nova versão da origem não é maior que a actual.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Run <command>debclean</command> before merging the new upstream source.
pt: Corre o <command>debclean</command> antes de fundir a nova fonte da origem.

note: type: Content of: <refentry><refsect1><variablelist><para>
en: Tarballs must be compressed with <command>gzip</command> or <command>bzip2</command>.
pt: Os tarballs têm de estar comprimidos com <command>gzip</command> ou <command>bzip2</command>.

note: type: Content of: <refentry><refnamediv><refpurpose>
en: remove redundant files from upstream source packages
pt: remove ficheiros redundantes dos pacotes fonte da origem (upstream)

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>&ucleanpackage; FILE [ NEWFILE... ]</command>
pt: <command>&ucleanpackage; FICHEIRO [ NOVO_FICHEIRO... ]</command>

note: type: Content of: <refentry><refsect1><para>
en: Uclean is an attempt to automate the &quot;cleanup&quot; procedure that can be needed for some package upstream tarballs. It will try to unpack it, remove cruft like CVS directories, .svn directories and forgotten object files. Then it will recreate the tarball, using the highest compression ratio. The resulting file is either stored under the same name (the old one is renamed) or as a new file if you specify it as the last argument.
pt: Não limpa é uma tentativa de automatizar o processo de &quot;limpeza&quot; que possa ser necessário para alguns tarballs de origem de pacote. Irá tentar desempacotá-lo, remover coisas rudes como directórios CVS, directórios .svn e ficheiros de objectos esquecidos. Depois irá recriar o tarball, usando o rácio de compressão mais alto. O ficheiro resultante é ou armazenado sob o mesmo nome (o antigo é renomeado) ou como um novo ficheiro se você o especificar como o último argumento.
