Provided by: svn-buildpackage_0.8.5+nmu1_all 
NOME
svn-buildpackage - constrói pacotes Debian a partir de repositório SVN
SINOPSE
svn-buildpackage [[ OPÇÕES... ] [ OPÇÕES para o dpkg-buildpackage ]]
DESCRIÇÃO
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 svn-inject, e este script tem de ser executado
no directório de trabalho (trunk/pacote).
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 debian (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 mergeWithUpstream do svn no
directório debian.
$ svn propset mergeWithUpstream 1 debian
mergeWithUpstream requer que o sistema possa preparar um tarball, usando tipicamente make
dist 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 mergeWithUpstream 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 useNativeDist ao alvo do Makefile 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 svn-buildpackage usar um
alvo make native-dist no seu Makefile de nível de topo, regule a propriedade useNativeDist
no directório ./debian/:
$ svn propset useNativeDist 1 debian
O comportamento predefinido do svn-buildpackage é o seguinte:
Verifica o directório de trabalho, queixa-se de ficheiros não submetidos (veja também
--svn-ignore-new)
Copia o tarball de origem para a área de construção se necessário (veja também
--svn-no-links)
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 --svn-no-links)
Constrói com o dpkg-buildpackage (veja também --svn-builder, --svn-lintian, etc.)
Cria um entrada no registo de alterações para a versão futura
OPÇÕES
svn-buildpackage aceita as seguintes opções na linha de comandos:
--svn-builder=COMANDO
Especifica um comando de construção alternativo em vez de dpkg-buildpackage, ex.
debuild, pdebuild, etc. Cada parâmetro que o svn-buildpackage não conhece (--svn-*) é
passado para COMMAND. 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.
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
--svn-lintian e --svn-move. 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.
Predefinição: usa dpkg-buildpackage.
--svn-ignore-new | --svn-ignore
Não pára em conflitos do svn ou ficheiros novos/alterados. Para definir este
comportamento para ficheiros únicos defina a propriedade deb:ignoreM para 1 neles.
Veja também a documentação da propriedade svn:ignore no livro do SVN.
Predefinição: Pára em conflitos ou ficheiros novos/alterados.
--svn-dont-clean
Não corre a limpeza de debian/rules.
Predefinição: primeiro limpa.
--svn-no-links
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.
Predefinição: usa os links onde possível.
--svn-dont-purge
Não remove o directório de construção quando a construção está pronta.
Predefinição: remove após construção com sucesso.
--svn-reuse
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 mergeWithUpstream como pacotes grandes.
Predefinição: o directório de construção é removido.
--svn-rm-prev-dir
Se for encontrado um directório de construção anterior, remove-o antes da construção
em vez de o renomear. Se --svn-reuse for também fornecido na mesma linha, o corre o
comportamento de reutilização.
Predefinição: renomeia os directórios antigos com o sufixo 'obsolete'.
--svn-export
Apenas exporta o directório de trabalho e faz as operações de fusão de código
necessárias, e depois termina.
Predefinição: Desligado.
--svn-tag
Construção final: Etiqueta, exporta, constrói com limpeza & cria nova entrada no
registo de alterações.
Predefinição: Desligado.
--svn-tag-only | --svn-only-tag
Não constrói o pacote, apenas faz a cópia da etiqueta.
Predefinição: Desligado.
--svn-retag
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.
Predefinição: Desligado.
--svn-noautodch
Nenhuma entrada no registo de alterações Debian é adicionada automaticamente.
Predefinição: Uma nova entrada no registo de alterações UNRELEASED é definida via dch.
--svn-lintian
Corre o lintian no ficheiro de alterações resultante quando pronto.
Predefinição: Desligado.
--svn-move
Quando pronto, move os ficheiros criados (como listado em .changes) para o directório
pai, relativo àquele onde o svn-buildpackage foi iniciado.
Predefinição: Desligado.
--svn-move-to=...
Especifica o directório alvo para onde mover os ficheiros gerados.
Predefinição: Desligado. (Os ficheiros são deixados onde o comando de construção os
colocou.)
--svn-pkg=nome_de_pacote
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).
Predefinição: Desligado.
--svn-arch=ARQUITECTURA
Permite especificar a arquitectura de construção (ex. construir para i386 numa máquina
amd64).
Predefinição: Desligado.
--svn-override=var=valor,anothervar=valor
Sobrepõe qualquer variável de configuração que tenha sido auto-detectada ou encontrada
em .svn/deb-layout.
Predefinição: Desligado.
--svn-prebuild | --svn-postbuild | --svn-pretag | --svn-posttag
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.
Por favor note que os hooks prebuild e postbuild substituem as acções prebuild e
postbuild normais do svn-buildpackage. 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.
Predefinição: Desligado.
--svn-noninteractive
Com este parâmetro o svn-buildpackage não irá interagir com o utilizador.
Predefinição: Desligado.
--svn-savecfg
Por predefinição, o svn-buildpackage costumava criar .svn/deb-layout a cada invocação.
Desde a versão 0.6.22 que este comportamento está descontinuado.
Com este parâmetro o svn-buildpackage irá (parcialmente) replicar o comportamento
antigo. Em contraste com o comportamento descontinuado, o .svn/deb-layout é
reconhecido como uma sobreposição local; o comportamento antigo simplesmente ignorava
qualquer informação de disposição com versão se encontrasse .svn/deb-layout.
Esta opção foi disponibilizada porque pode ser útil quando se cria um ficheiro de
sobreposição local.
Predefinição: Desligado.
--svn-download-orig
Esta opção faz com que o svn-buildpackage tente descarregar o tarball da origem usando
apt e uscan.
Predefinição: Desligado.
--svn-verbose
Saída do programa mais detalhada.
Predefinição: Desligado.
-h | --help
Mostra a mensagem de ajuda.
EXEMPLOS
Para informação mais detalhada de como usar o svn-buildpackage, veja o HOWTO.
http://svn-bp.alioth.debian.org/[1].
Para começar a trabalhar com um pacote Debian nativo existente a partir de um ficheiro
*.dsc, importe-o para o repositório com o comando:
svn-inject package_0.1.dsc svn://host/debian/devel/packages
Para começar a trabalhar com um pacote da origem existente em Debian a partir de um
ficheiro *.dsc, importe-o para o repositório com o comando:
svn-inject -o package_0.1-2.dsc svn://host/debian/devel/packages
Antes de construir um pacote da origem, certifique-se que a fonte original está
disponível, ex. se o uscan está a funcionar:
svn mkdir ../tarballs
svn propset svn:ignore "*" ../tarballs
uscan --force-download --destdir ../tarballs
Para uma construção teste do pacote a partir de repositório SVN, use o comando abaixo. Use
referências do manual do dpkg-buildpackage(1) para as opções -us etc.
svn-buildpackage --svn-lintian -us -uc -rfakeroot
Para verificar que o pacote constrói num estado limpo, teste-o com pbuilder(1):
svn mkdir ../build-area # Para armazenar resultados
svn propset svn:ignore "*" ../build-area
svn-buildpackage --svn-ignore-new --svn-builder=pdebuild
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 svn-upgrade(1) para importar o novo
lançamento.
svn status # Verifica que não há alterações não submetidas
svn-upgrade --verbose ../package-2.0.tar.gz
FICHEIRO DE CONFIGURAÇÃO
O comportamento do svn-buildpackage pode ser modificado usando o ficheiro
~/.svn-buildpackage.conf. Podem ser adicionadas partes adicionais em cada directório de
trabalho de pacote usando o ficheiro .svn/svn-buildpackage.conf. É 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:
svn-builder=debuild -EPATH
svn-no-links
svn-override=origDir=$HOME/debian/upstream/$PACOTE
# svn-ignore-new
#svn-lintian
MANUSEAMENTO DA DISPOSIÇÃO DO DIRECTÓRIO
Por predefinição, o svn-buildpackage espera um ficheiro de configuração com declaração de
caminho/url, .svn/deb-layout. Os valores de lá podem ser sobrepostos com a opção
--svn-override, 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
debian/svn-deblayout 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 svn-buildpackage. O formato é o mesmo que no ficheiro
.svn/deb-layout. Como uma alternativa ao ficheiro debian/svn-deblayout, os responsáveis
podem definir as propriedades do Subversion para o directório debian/, quaisquer
propriedades de debian/ que tenham um nome no formato svn-bp:PROP serão a fonte da
definição PROP 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.
VARIÁVEIS DE AMBIENTE
As seguintes variáveis de ambiente são exportadas pelo svn-buildpackage e podem ser usadas
em hook a comandos ou ao sistema de construção de pacotes.
PACOTE, pacote
O nome do pacote fonte.
SVN_BUILDPACKAGE
Versão do svn-buildpackage.
TAG_VERSION, debian_version
A string de versão Debian completa, também usada para a copia de etiqueta.
non_epoch_version
O mesmo que debian_version mas sem strings de época.
upstream_version
O mesmo que debian_version mas sem extensões Debian
guess_loc
Nome do pacote fonte da origem adivinhado na pool, algo como
libm/libmeta-html-perl_3.2.1.0.orig.tar.gz
DIFFSRC
(experimental) mostra a localização do ficheiro diff gerado
Todas as propriedades de disposição são também exportadas para o ambiente. As seguintes
têm significado para o svn-buildpackage.
buildArea
a localização do directório de área de construção
trunkUrl
o URL do directório trunk para o pacote actual.
tagsUrl
o URL do directório base de etiquetas para o pacote actual.
origDir
o directório local onde o tarball original deve estar colocado.
origUrl
o URL de onde pode ser puxado o tarball original do pacote actual.
As seguintes variáveis são compreendidas pelo svn-buildpackage:
FORCETAG
Ignora os sinais de um registo de alterações incompleto e etiqueta o repositório mesmo
assim.
FORCEEXPORT
Exporta a fonte da origem a partir do repositório mesmo que a propriedade
mergeWithUpstream esteja definida.
DEBIAN_FRONTEND
Se DEBIAN_FRONTEND estiver definida para 'noninteractive', --svn-noninteractive é
chamado em silêncio.
RECOMENDAÇÕES
Usa nomes alternativos de shell. Aqui estão alguns exemplos para Bash:
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
alias svn-br="svn-b --svn-dont-purge --svn-reuse"
alias svn-bt="svn-buildpackage --svn-tag -rfakeroot"
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).
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 svn-buildpackage. 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 svn-buildpackage.
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 svn-buildpackage para mais
detalhes.
VEJA TAMBÉM
/usr/share/doc/svn-buildpackage/()
O manual HOWTO do svn-buildpackage
svn-inject(1)
coloca um pacote fonte Debian num repositório Subversion
svn-upgrade(1)
actualiza o pacote fonte a partir de uma nova revisão da origem
svn(1)
ferramenta cliente Subversion de linha de comandos
dpkg-buildpackage(1)
Ferramentas de pacotes fonte Debian
lintian(1)
Verificador de pacotes Debian
AUTORES
Eduard Bloch
Este manual foi escrito por Eduard Bloch em roff.
Goneri Le Bouder
Converteu o manual para SGML.
Neil Williams
Converteu o manual para DocBook XML e é o responsável Debian actual
COPYRIGHT
Copyright © 2009 Eduard Bloch
NOTAS
1. http://svn-bp.alioth.debian.org/
http://svn-bp.alioth.debian.org/