Re: [RFR] man://debuild

["Felipe Augusto van de Wiel (faw)" <felipe@cathedrallabs.org>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 10/13/2005 08:35 AM, bto wrote:
>  Arquivo em anexo: debuild_pt_BR.1

	Estou mandando um patch e tenho algumas considerações.

- - Está faltando uma seção inteira (EXEMPLO)
- - Você não adicionou a informação sobre quem foi o tradutor
- - Você verificou se o mantenedor do pacote converteu a manpage pra
  po4? Se sim, ao invés de editar um arquivo texto livre você
  deveria estar editando um potfile. Seria uma boa consultar o
  pacote pra obter mais informações.


	Abraço,

- --
Felipe Augusto van de Wiel (faw)
"Debian. Freedom to code. Code to freedom!"
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (GNU/Linux)
Comment: Using GnuPG with Debian - http://enigmail.mozdev.org

iD8DBQFDm0v6CjAO0JDlykYRAs77AJ0eV2pc8DLDKArqOgjIgMLQJOYoxQCgsHPa
B+5RnEdCco6s79OX7Boouiw=
=2Mpy
-----END PGP SIGNATURE-----

--- debuild_pt_BR.1	2005-12-10 19:03:48.183892560 -0200
+++ faw-debuild_pt_BR.1	2005-12-10 19:40:41.731382192 -0200
@@ -14,48 +14,49 @@
 \fBlintian\fR e/ou \fBlinda\fR sobre o arquivo \fI.changes\fR criado
 (assumindo que \fBlintian\fR e/ou \fBlinda\fR esteja instalado), e
 finalmente assina o arquivo \fI.changes\fR e/ou \fI.dsc\fR  como
-apropriado (usando \fBdebsign\fR(1) para fazer no lugar do
-\fBdpkg-buildpackage\fR(1) ele próprio; todas as opções de chaves de 
+apropriado (usando \fBdebsign\fR(1) para fazer isto ao invés do próprio
+\fBdpkg-buildpackage\fR(1); todas as opções de chaves de 
 assinatura relevantes são repassadas).  Parâmetros podem ser repassados 
-para o \fBdpkg-buildpackage\fR,\fBlintian\fR e \fBlinda\fR, aonde 
+para o \fBdpkg-buildpackage\fR, \fBlintian\fR e \fBlinda\fR, onde 
 os parâmetros para esses últimos são assinalados com as opções 
 \fB\-\-lintian-opts\fR e \fB\-\-linda-opts\fR respectivamente.  As opções 
 disponíveis neste caso são \fB\-\-lintian\fR e \fB\-\-no-lintian\fR para 
 forçar ou pular a etapa \fBlintian\fR, respectivamente, e de maneira 
 similar \fB\-\-linda\fR e\fB\-\-no-linda\fR para \fBlinda\fR.  O padrão é 
-rodar \fBlintian\fR e não \fBlinda\fR.  Existem também várias opções 
+executar \fBlintian\fR e não \fBlinda\fR.  Existem também várias opções 
 disponíveis para definir e preservar as variáveis de ambiente, como 
 descrito abaixo na seção Variáveis de Ambiente.  Com esse método de execução 
 do \fBdebuild\fR, também armazenamos os registros do processo de construção 
 do pacote no arquivo \fI../<pacote>_<versão>_<arquitetura>.build\fR.
 .PP
 Um modo alternativo de uso do \fBdebuild\fR é usar um ou mais dos
-parametros \fBbinary\fR, \fBbinary-arch\fR, \fBbinary-indep\fR e
+parâmetros \fBbinary\fR, \fBbinary-arch\fR, \fBbinary-indep\fR e
 \fBclean\fR, que neste caso \fBdebuild\fR irá ter que obter privilégios
 de root e então rodar \fIdebian/rules\fR com os parâmetros fornecidos.
-As opções \fB\-rootcmd=\fIgain-root-command\fR ou \fB\-r\fIgain-root-command\fR podem ser usadas para especificar como obter os privilégios de root.  
+As opções \fB\-rootcmd=\fIgain-root-command\fR ou \fB\-r\fIgain-root-command\fR
+podem ser usadas para especificar como obter os privilégios de root.  
 O valor de \fIgain-root-command\fR é geralmente \fIfakeroot\fR, \fIsudo\fR ou
 \fIsuper\fR.  Veja mais adiante uma abordagem mais detalhada sobre o assunto.
 Novamente, as opções para preservação de ambiente podem ser usadas.  
 Neste caso, \fBdebuild\fR irá também executar \fBdpkg-checkbuilddeps\fR 
-primeiro; isso pode ser explícitamente requisitado ou desligado usando
-as opções \fB\-D\fR e \fB\-d\fR respectivamente.  Note também que mesmo essas
-opções ou a opção \fB\-r\fR sejam especificadas no arquivo de configuração
-pela variável DEBUILD_DPKG_BUILDPACKAGE_OPTS, elas serão reconhecidas por
-este método de execução do \fBdebuild\fR.
+primeiro; isso pode ser explicitamente requisitado ou desligado usando
+as opções \fB\-D\fR e \fB\-d\fR respectivamente.  Note também que mesmo que
+essas opções ou a opção \fB\-r\fR sejam especificadas na opção 
+DEBUILD_DPKG_BUILDPACKAGE_OPTS do arquivo de configuração, então elas serão 
+reconhecidas até mesmo neste método de invocação do \fBdebuild\fR.
 .PP
-\fBdebuild\fR também lê o arquivo de configuração do \fBdevscripts\fR como
-descrito abaixo(below).  Isso permite que as opções padrões serem repassadas.
+\fBdebuild\fR também lê os arquivos de configuração do \fBdevscripts\fR como
+descrito abaixo.  Isso permite que as opções padrão sejam repassadas.
 .SH "Checagem de nome de diretório"
-Dá mesma maneira que vários outros scripts do pacote \fBdevscripts\fR,
-\fBdebuild\fR irá percorer a árvore de diretório até encontrar o arquivo
+Da mesma maneira que vários outros scripts do pacote \fBdevscripts\fR,
+\fBdebuild\fR irá percorrer a árvore de diretórios até encontrar o arquivo
 \fIdebian/changelog\fR antes de tentar construir o pacote.
-Como forma de evitar potenciais problemas com 'stray files', ele irá
-examinar o nome do diretório raiz(parent) uma vez encontrado o arquivo
-\fIdebian/changelog\fR, e checar que o nome do diretório corresponda
+Como forma de evitar potenciais problemas com arquivos perdidos, ele irá
+examinar o nome do diretório pai uma vez encontrado o arquivo
+\fIdebian/changelog\fR, e checar se o nome do diretório corresponde
 com o nome do pacote.  Precisamente, ele faz isso controlado por
 duas variáveis do arquivo de configuração DEVSCRIPTS_CHECK_DIRNAME_LEVEL 
-e DEVSCRIPTS_CHECK_DIRNAME_REGEX, que correspondem as opções de linha
+e DEVSCRIPTS_CHECK_DIRNAME_REGEX, que correspondem às opções de linha
 de comando \fB\-\-check-dirname-level\fR e \fB\-\-check-dirname-regex\fR.
 .PP
 DEVSCRIPTS_CHECK_DIRNAME_LEVEL pode receber os seguintes valores:
@@ -64,26 +65,28 @@
 Nunca checar o nome do diretório.
 .TP
 .B 1
-Apenas checar o nome de diretório se nós tivermos alterado o diretorio
+Apenas checar o nome de diretório se nós tivermos alterado o diretório
 durante a busca pelo \fIdebian/changelog\fR.  Esse é o comportamento padrão.
 .TP
 .B 2
 Sempre checar o nome do diretório.
 .PP
 O nome do diretório é checado testando se o nome do atual diretório de 
-trabalho (como determinado por \fBpwd\fR(1)) 'casa'(matches) com a regex
+trabalho (como determinado por \fBpwd\fR(1)) bate com a regex
 fornecida pela opção do arquivo de configuração DEVSCRIPTS_CHECK_DIRNAME_REGEX
 ou pela opção de linha de comando \fB\-\-check-dirname-regex\fR \fIregex\fR.  
-Aqui \fIregex\fR é uma regex Perl (veja \fBperlre\fR(3perl)), a qual irá
-ser atrelada(anchored) no início e no final.  Caso \fIregex\fR contenha um '/',
-então será necessário 'casar' todo o caminho para o diretório(full directory path).  Senão, todo nome do diretório.  Caso a \fIregex\fR contenha a string
-\'PACKAGE', ela será substituida pelo nome do pacote fonte(source package name), de acordo com o determinado no changelog.  O valor padrão para a regex é:
-\'PACKAGE(-.*)?', assim 'casando'(matching) com nomes de diretórios como
-PACOTEA e PACOTE-versão.
-.SH VARIAVEIS DE AMBIENTE
-Como as variáveis de ambiente podem afetar a consturção de um pacote, 
+Aqui \fIregex\fR é uma regex Perl (veja \fBperlre\fR(3perl)), a qual será
+ancorada no início e no final.  Caso \fIregex\fR contenha um '/',
+então será necessário validar todo o caminho para o diretório.  Senão, todo 
+nome do diretório.  Caso a \fIregex\fR contenha a string
+\'PACKAGE', ela será substituída pelo nome do pacote fonte, de acordo com o 
+determinado no changelog.  O valor padrão para a regex é:
+\'PACKAGE(-.*)?', assim validando nomes de diretórios como
+PACOTE e PACOTE-versão.
+.SH VARIÃ?VEIS DE AMBIENTE
+Como as variáveis de ambiente podem afetar a construção de um pacote, 
 geralmente sem ter intenção, \fBdebuild\fR imuniza o ambiente removendo
-todas as variáveis de ambiente com a excessão de TERM, HOME, LOGNAME, GNUPGHOME,
+todas as variáveis de ambiente com exceção de TERM, HOME, LOGNAME, GNUPGHOME,
 PGPPATH, GPG_AGENT_INFO, FAKEROOTKEY, DEB_* e as variáveis locais
 LANG and LC_*.  TERM é definida como `dumb' caso não tenha um valor, e PATH 
 é definida como "/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11".
@@ -93,24 +96,24 @@
 pelo uso de \fB\-\-preserve-envvar\fR \fIenvvar\fR (o que também pode ser
 feito através da opção \fB\-e\fR \fIenvvar\fR).  O ambiente talvez possa ser
 deixado intocado usando a opção \fB\-\-preserve-env\fR.  Contudo, mesmo nesse
-caso, o PATH será definido para o valor descrito 'above'.  A \fBúnica\fR 
+caso, o PATH será definido para o valor descrito acima.  A \fBúnica\fR 
 maneira de previnir a ausência de valor do PATH é especificar a opção
 \fB\-\-preserve-envvar PATH\fR .  Mas você será alertado que usar
-programas a partir de locais fora do padrão, provavelmente o resultado será
-um pacote quebrado, e não será possível usá-lo em sistemas padrões.
+programas a partir de locais fora do padrão pode facilmente resultar em
+um pacote quebrado, pois não será possível contruí-lo em sistemas padrão.
 .PP
 Também é possível evitar ter que digitar algo como
 \fIFOO\fB=\fIbar \fBdebuild -e \fIFOO\fR escrevendo \fBdebuild -e
 \fIFOO\fB=\fIbar\fR ou a maneira mais longa \fBdebuild --set-envvar
 \fIFOO\fB=\fIbar\fR.
-.SH "OS PODERES DO SUPERUSUÃ?RIO -- SUPERUSER REQUIREMENTS"
+.SH "REQUERIMENTOS DE SUPERUSUÃ?RIO"
 \fBdebuild\fR precisa ser executado como superusuário para funcionar
-corretamente.  Existem três maneiras fudalmentalmente diferentes de se 
+corretamente.  Existem três maneiras fundalmentalmente diferentes de se 
 fazer isso.  O primeiro, e preferível, método é usar algum comando que
 forneça esses poderes.  O melhor a ser usado, provavelmente é o 
 \fBfakeroot\fR(1), já que ele não garante nenhum privilégio genuíno. O 
 uso de \fBsuper\fR(1) e \fBsudo\fR(1) também é possível.  Caso a opção 
-\fB\-r\fR (ou \fB\-\-rootcmd\fR) não for passada (relembrando que 
+\fB\-r\fR (ou \fB\-\-rootcmd\fR) não seja passada (relembrando que 
 \fBdpkg-buildpackage\fR também aceita a opção \fB\-r\fR) e nenhum dos 
 métodos a seguir for usado, então \fB\-rfakeroot\fR será silenciosamente
 assumido.
@@ -124,23 +127,23 @@
 O terceiro método disponível é ter \fBdebuild\fR instalado como setuid
 root.  Esse não é o método padrão, e isso terá que ser feito pelo
 administrador do sistema.  Mas é preciso ter ciência que qualquer um 
-que rodar \fBdebuild\fR como root ou setuid root tem \fBtotal acesso
-a toda máquina\fR.  E assim esse método náo é recomendado, mas funcionará.
+que rodar \fBdebuild\fR como root ou setuid root tem \fBacesso total
+à máquina\fR.  E assim esse método náo é recomendado, mas funcionará.
 \fBdebuild\fR poderia ser instalado com permissão 4754, e então apenas
 membros de determinado grupo poderiam usá-lo.  A desvantagem deste método
 seria que outros usuários não teriam acesso ao programa.  Existem muitas 
-outras variantes dessa opção involvendo multiplas copias do \fBdebuild\fR, 
+outras variantes dessa opção envolvendo múltiplas cópias do \fBdebuild\fR, 
 ou o uso de programas como \fBsudo\fR ou \fBsuper\fR para fornecer privilégios
-de root à usuários de maneira seletiva.  Se o administrador do sistema
+de root a usuários de maneira seletiva.  Se o administrador do sistema
 desejar fazer isso, ele deve usar o programa \fBdpkg-statoverride\fR para
 alterar as permissões de \fI/usr/bin/debuild\fR.  Isso irá garantir que essas
 permissões serão preservadas após upgrades.
 .SH "OPÃ?Ã?ES"
-Para detalhes, veja 'above'.
+Para detalhes, veja acima.
 .TP
 .B \-\-no-conf, \-\-noconf
 Nenhum arquivo de configuração será usado.  Isso só pode ser usado como
-primeira opção passada à linha-de-comando.
+primeira opção passada pela linha-de-comando.
 .TP
 .BI \-\-rootcmd= "cmd-para-privilégios-root, " \-r cmd-para-privilégios-root
 Comando para obter privilégios de root (ou falso root).
@@ -156,22 +159,22 @@
 remova-a do ambiente.
 .TP
 .B \-\-lintian
-Rodar \fBlintian\fR depois de \fBdpkg-buildpackage\fR.  Esse é o 
+Executar \fBlintian\fR depois de \fBdpkg-buildpackage\fR.  Esse é o 
 comportamento padrão, e isso sobrescreve qualquer diretiva de arquivo 
 de configuração contrária.
 .TP
 .B \-\-no\-lintian
-Não rode o \fBlintian\fR depois de \fBdpkg-buildpackage\fR.
+Não execute o \fBlintian\fR depois de \fBdpkg-buildpackage\fR.
 .TP
 .B \-\-linda
-Rodar \fBlinda\fR depois de \fBdpkg-buildpackage\fR.
+Executar \fBlinda\fR depois de \fBdpkg-buildpackage\fR.
 .TP
 .B \-\-no\-linda
-Não rodar \fBlinda\fR após \fBdpkg-buildpackage\fR.  Esse é o comportamento
+Não executar \fBlinda\fR após \fBdpkg-buildpackage\fR.  Esse é o comportamento
 padrão.
 .TP
 \fB\-\-check-dirname-level\fR \fIN\fR
-Veja a seção "Chcagem de Nome de Diretorio" acima para uma explanação
+Veja a seção "Checagem de Nome de Diretório" acima para uma explanação
 sobre essa opção.
 .TP
 \fB\-\-check-dirname-regex\fR \fIregex\fR
@@ -179,10 +182,11 @@
 sobre essa opção.
 .TP
 \fB\-d\fR
-Não rodar \fBdpkg-checkbuilddeps\fR para checar por dependências de construção.
+Não executar \fBdpkg-checkbuilddeps\fR para checar por dependências de 
+construção.
 .TP
 \fB\-D\fR
-Rodar \fBdpkg-checkbuilddeps\fR para checar por dependências de construção.
+Executar \fBdpkg-checkbuilddeps\fR para checar por dependências de construção.
 .SH "VARIÃ?VEIS DE CONFIGURAÃ?Ã?O"
 Os dois arquivos de configuração \fI/etc/devscripts.conf\fR e
 \fI~/.devscripts\fR são alimentados por um shell nesta ordem para definir
@@ -193,13 +197,13 @@
 configuração são lidos.  As variáveis reconhecidas atualmente são:
 .TP
 .B DEBUILD_PRESERVE_ENV
-Se definida como \fIyes\fR, siginifica o mesmo que usar o parâmetro de
+Se definida como \fIyes\fR, significa o mesmo que usar o parâmetro de
 linha de comando fB\-\-preserve\-env\fR.
 .TP
 .B DEBUILD_PRESERVE_ENVVARS
 Quais variáveis de ambiente preservar.  Deve ser uma lista de variáveis
-separadas por vírgula.  Corresponde a usar multiplas opções
-\fB\-\-preserve\-envvar\fR ou \fB\-e\fR .
+separadas por vírgula.  Corresponde a usar múltiplos 
+\fB\-\-preserve\-envvar\fR ou \fB\-e\fR como opção.
 .TP
 .BI DEBUILD_SET_ENVVAR_ var = valor
 Corresponde a \fB\-\-set\-envvar=\fIvar\fB=\fIvalor\fR.
@@ -208,20 +212,22 @@
 Definindo essa variável para \fIprog\fR é o equivalente a \fB\-r\fIprog\fR.
 .TP
 .B DEBUILD_DPKG_BUILDPACKAGE_OPTS
-Essas são opções as quais deveriam ser passadas ao comando
+Essas são opções que deveriam ser passadas ao comando
 \fBdpkg-buildpackage\fR quando invocado.  Elas são fornecidas antes de
-qualquer opção de linha de comando.  Devido a interpretação do shell, se
+qualquer opção de linha de comando.  Devido à interpretação do shell, se
 uma palavra contendo espaços for requerida como uma opção única,
 aspas extras serão necessárias.  Por exemplo, o arquivo de configuração
 pode ter essa linha:
 .IP
+.nf
 DEBUILD_DPKG_BUILDPACKAGE_OPTS="-k'Julian Gilbey <jdg@debian.org>' -sa"
+.fi
 .IP
-que define precisamente duas opções.  Sem as aspas simples extra,
+que define precisamente duas opções.  Sem as aspas simples,
 \fBdpkg-buildpackage\fR iria reclamar que \fIGilbey\fR é uma opção
 desconhecida (ela não começa com um sinal `\-' ).
-.PP
-E também, se essa opção tiver qualquer uma dessas opções: \fB\-r\fR, 
+.IP
+E também, se essa opção tiver qualquer um desses parâmetros: \fB\-r\fR, 
 \fB\-d\fR ou \fB\-D\fR, elas sempre serão examinadas pelo \fBdebuild\fR.  
 Note que a opção \fB\-r\fR nessa variável irá sobrescrever as definições
 de DEBUILD_ROOTCMD.
@@ -231,9 +237,9 @@
 \fBlintian\fR não será executado.
 .TP
 .B DEBUILD_LINTIAN_OPTS
-Essas são as opções qeu devem ser passadas para a invocação do \fBlintian\fR.  
+Essas são as opções que devem ser passadas para a invocação do \fBlintian\fR.  
 Elas são informadas antes que qualquer opção de linha de comando, e o uso
-dessa variável é o mesmo que o decrito para a variável
+dessa variável é o mesmo que o descrito para a variável
 \fBDEBUILD_DPKG_BUILDPACKAGE_OPTS\fR.
 .TP
 .B DEBUILD_LINDA
@@ -248,9 +254,9 @@
 .TP
 .BR DEVSCRIPTS_CHECK_DIRNAME_LEVEL ", " DEVSCRIPTS_CHECK_DIRNAME_REGEX
 Veja as seções acima "Checagem de nome de diretório" para uma explanação
-dessas variáveis.  Note que elas são variáveis de configurações 'package-wide',
-e assim, irão afetar todos os scripts \fBdevscripts\fR que checarem
-seus valores, como descrito em suas respectivas  páginas de manuais e
+dessas variáveis.  Note que elas são variáveis de configuração para o pacote
+como um todo, e assim, irão afetar todos os scripts \fBdevscripts\fR que 
+checarem seus valores, como descrito em suas respectivas páginas de manuais e
 em \fBdevscripts.conf\fR(5).
 .SH "Veja também"
 .BR dpkg-buildpackage (1),