Adding upstream version 1.20.13.upstream/1.20.13upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 552 insertions, 0 deletions

diff --git a/man/pt/dpkg-architecture.pod b/man/pt/dpkg-architecture.pod
new file mode 100644
index 0000000..90977a6
--- /dev/null
+++ b/man/pt/dpkg-architecture.pod
@@ -0,0 +1,552 @@
+
+        *****************************************************
+        *           GENERATED FILE, DO NOT EDIT             *
+        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
+        *****************************************************
+
+This file was generated by po4a(7). Do not store it (in VCS, for example),
+but store the PO file used as source file by po4a-translate.
+
+In fact, consider this as a binary, and the PO file as a regular .c file:
+If the PO get lost, keeping this translation up-to-date will be harder.
+
+=encoding UTF-8
+
+=head1 NOME
+
+dpkg-architecture - define e determina a arquitectura para compilação de
+pacotes
+
+=head1 SINOPSE
+
+B<dpkg-architecture> [I<option>...] [I<command>]
+
+=head1 DESCRIÇÃO
+
+B<dpkg-architecture> disponibiliza uma habilidade para determinar e definir
+a arquitectura de compilação e da máquina para compilação de pacotes.
+
+A arquitectura de compilação é sempre determinada seja ou pela variável
+B<DEB_BUILD_ARCH> se definida (e se B<--force> não for especificada) ou por
+uma chamada externa ao B<dpkg>(1), e não pode ser definida na linha de
+comandos.
+
+Você pode especificar a arquitectura da máquina ao fornecer uma ou ambas as
+opções B<--host-arch> e B<--host-type>, caso contrário é usada a variável
+B<DEB_HOST_ARCH> se definida (e não sendo especificado B<--force>). A
+predefinição é determinada por uma chamada externa ao B<gcc>(1), ou o mesmo
+como a arquitectura de compilação se B<CC> ou gcc estiverem ambos não
+disponíveis. Um de B<--host-arch> e B<--host-type> é suficiente, o valor do
+outro será definido para uma predefinição utilizável. De facto, é muitas
+vezes melhor apenas especificar um, porque B<dpkg-architecture> vai avisa-lo
+se a sua escolha não corresponder ao predefinido.
+
+=head1 COMANDOS
+
+=over 
+
+=item B<-l>, B<--list>
+
+Escreve as variáveis de ambiente, uma em cada linha, no formato
+I<VARIÁVEL=valor>. Esta é a acção predefinida.
+
+=item B<-e>, B<--equal> I<architecture>
+
+Verifica a igualdade da arquitectura (desde dpkg 1.13.13). Compara a actual
+ou a arquitectura de maquina Debian especificada com I<architecture>, para
+verificar se são iguais. Esta acção não irá expandir as wildcards de
+arquitectura. O comando termina com um estado de saída 0 de corresponderem,
+1 se não corresponderem.
+
+=item B<-i>, B<--is> I<architecture-wildcard>
+
+Verifica a identidade da arquitectura (desde dpkg 1.13.13). Compara a actual
+ou a arquitectura de máquina Debian especificada com
+I<architecture-wildcard> após a ter expandido como uma wildcard de
+arquitectura, para verificar se correspondem. O comando termina com estado
+de saída 0 se corresponderem, 1 se não corresponderem.
+
+=item B<-q>, B<--query> I<variable-name>
+
+Escreve o valor de uma variável única.
+
+=item B<-s>, B<--print-set>
+
+Escreve um comando de exportação. Isto pode ser usado para definir as
+variáveis de ambiente usando a shell POSIX ou make B<eval>, dependendo do
+formato dos resultados.
+
+=item B<-u>, B<--print-unset>
+
+Escreve um comando semelhante ao B<--print-set> mas para limpar o valor de
+todas as variáveis.
+
+=item B<-c>, B<--command> I<command-string>
+
+Executa uma I<command-string> num ambiente que tem todas as variáveis
+definidas para o determinado valor.
+
+=item B<-L>, B<--list-known>
+
+Escreve uma lista de nomes de arquitecturas válidos. Possivelmente
+restringidos por uma ou mais das opções de correspondência
+B<--match-wildcard>, B<--match-bits> ou B<--match-endian> (desde dpkg
+1.17.14).
+
+=item B<-?>, B<--help>
+
+Mostra a mensagem de utilização e termina.
+
+=item B<--version>
+
+Mostra a versão e termina.
+
+=back
+
+=head1 OPÇÕES
+
+=over 
+
+=item B<-a>, B<--host-arch> I<architecture>
+
+Define a arquitectura da máquina Debian
+
+=item B<-t>, B<--host-type> I<gnu-system-type>
+
+Define o tipo de sistema GNU da máquina.
+
+=item B<-A>, B<--target-arch> I<architecture>
+
+Define a arquitectura Debian de destino (desde dpkg 1.17.14).
+
+=item B<-T>, B<--target-type> I<gnu-system-type>
+
+Define o tipo de sistema GNU do destino (desde dpkg 1.17.14).
+
+=item B<-W>, B<--match-wildcard> I<architecture-wildcard>
+
+Restringe as arquitectura listadas por B<--list-known> a aquelas que
+correspondem à wildcard de arquitectura especificada (desde dpkg 1.17.14).
+
+=item B<-B>, B<--match-bits> I<architecture-bits>
+
+Restringe as arquitectura listadas por B<--list-known> a aquelas com os bits
+de CPU especificados (desde dpkg 1.17.14). Seja B<32> ou B<64>.
+
+=item B<-E>, B<--match-endian> I<architecture-endianness>
+
+Restringe as arquitectura listadas por B<--list-known> a aquelas com a
+categoria endian especificada (desde dpkg 1.17.14). Seja B<little> ou
+B<big>.
+
+=item B<--print-format> I<format>
+
+Define o formato de resultados para B<--print-set> e B<--print-unset> (desde
+dpkg 1.20.6), para ou B<shell> (predefinição) ou B<make>.
+
+=item B<-f>, B<--force>
+
+Os valores definidos pelas variáveis de ambiente existentes com os mesmos
+nomes usados como usados pelos scripts são respeitados (isto é, usados por
+B<dpkg-architecture>), excepto se esta bandeira de forçar estiver
+presente. Isto permite ao utilizador sobrepor um valor mesmo quando a
+chamada a B<dpkg-architecture> está enterrada em algum outro script (por
+exemplo B<dpkg-buildpackage>(1)).
+
+=back
+
+=head1 TERMOS
+
+=over 
+
+=item máquina de compilação
+
+A máquina onde o pacote é compilado.
+
+=item máquina anfitriã
+
+A máquina para onde o pacote é compilado.
+
+=item máquina destino (alvo)
+
+A maquina para a qual o compilador foi construído. Isto é apenas necessário
+quando se compila -ferramenta-corrente-cruzada, uma que será compilada sobre
+a na arquitectura de compilação, para ser corrida na arquitectura anfitriã,
+e para compilar código para a arquitectura alvo.
+
+=item Arquitectura Debian
+
+A string de arquitectura Debian, a qual especifica a árvore binária no
+arquivo FTP. Exemplos: i386, sparc, hurd-i386.
+
+=item Tuple de arquitectura Debian
+
+Um tuple de arquitectura Debian é a arquitectura totalmente qualificada com
+todos os seus componentes soletrados. Isto difere das arquitecturas Debian
+em que pelo menos o componente I<cpu> não trás embutido o I<abi>. O tuple
+actual tem o formato I<abi>-I<libc>-I<os>-I<cpu>. Exemplos:
+base-gnu-linux-amd64, eabihf-musl-linux-arm.
+
+=item Wildcard de arquitectura Debian
+
+Um wildcard de arquitectura Debian é uma string especial de arquitectura que
+irá corresponder a qualquer arquitectura real que faça parte dela. O formato
+geral é um tuple de arquitectura Debian com quatro ou menos elementos, e com
+pelo menos um deles a ser B<any>. Elementos em falta no tuple são prefixados
+implicitamente como B<any>, e assim os seguintes pares são equivalentes:
+
+=over 
+
+=item B<any>-B<any>-B<any>-B<any> = B<any>
+
+=item B<any>-B<any>-I<os>-B<any> = I<os>-B<any>
+
+=item B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>
+
+=back
+
+Exemplos: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any.
+
+=item Tipo de sistema GNU
+
+Uma string de especificação de arquitectura consiste de duas partes
+separadas por um hífen: cpu e sistema. Exemplos: i586-linux-gnu,
+sparc-linux-gnu, i686-gnu, x86_64-netbsd.
+
+=item multiarch triplet
+
+O tipo de sistema GNU clarificado, usado para caminhos do sistema de
+ficheiros. Este triplet não altera mesmo quando a linha base ISA entra em
+colisão, para que os caminhos resultantes fiquem estáveis com o tempo. A
+única diferença actual com o tipo de sistema GNU é que a parte de CPU para
+os sistemas baseados em i386 é sempre i386. Exemplos:  i386-linux-gnu,
+x86_64-linux-gnu.  Exemplos de caminhos: /lib/powerpc64le-linux-gnu/,
+/usr/lib/i386-kfreebsd-gnu/.
+
+=back
+
+=head1 VARIÁVEIS
+
+As seguintes variáveis são lidas a partir do ambiente (a menos que
+B<--force> seja especificado) e definidas por B<dpkg-architecture> (veja a
+secção B<TERMS> para uma descrição do esquema de nomeação):
+
+=over 
+
+=item B<DEB_BUILD_ARCH>
+
+A arquitectura Debian da máquina de compilação.
+
+=item B<DEB_BUILD_ARCH_ABI>
+
+O nome ABI Debian da máquina de compilação (desde dpkg 1.18.11).
+
+=item B<DEB_BUILD_ARCH_LIBC>
+
+O nome libc Debian da máquina de compilação (desde dpkg 1.18.11).
+
+=item B<DEB_BUILD_ARCH_OS>
+
+O nome de sistema Debian da máquina de compilação (desde dpkg 1.13.2).
+
+=item B<DEB_BUILD_ARCH_CPU>
+
+O nome de CPU de Debian da máquina de compilação (desde dpkg 1.13.2).
+
+=item B<DEB_BUILD_ARCH_BITS>
+
+O tamanho do ponteiro da máquina de compilação (em bits, desde dpkg 1.15.4).
+
+=item B<DEB_BUILD_ARCH_ENDIAN>
+
+A classe endian da máquina de compilação (ittle / big; desde dpkg 1.15.4).
+
+=item B<DEB_BUILD_GNU_CPU>
+
+A parte CPU GNU de B<DEB_BUILD_GNU_TYPE>.
+
+=item B<DEB_BUILD_GNU_SYSTEM>
+
+A parte de system GNU de B<DEB_BUILD_GNU_TYPE>.
+
+=item B<DEB_BUILD_GNU_TYPE>
+
+O tipo de sistema GNU da máquina de compilação.
+
+=item B<DEB_BUILD_MULTIARCH>
+
+O tipo de sistema GNU clarificado da máquina de compilação, usado para
+caminhos do sistema de ficheiros (desde dpkg 1.16.0).
+
+=item B<DEB_HOST_ARCH>
+
+A arquitectura Debian da máquina anfitriã.
+
+=item B<DEB_HOST_ARCH_ABI>
+
+O nome ABI Debian da máquina anfitriã (desde dpkg 1.18.11).
+
+=item B<DEB_HOST_ARCH_LIBC>
+
+O nome libc Debian da máquina anfitriã (desde dpkg 1.18.11).
+
+=item B<DEB_HOST_ARCH_OS>
+
+O nome de sistema Debian da máquina anfitriã (desde dpkg 1.13.2).
+
+=item B<DEB_HOST_ARCH_CPU>
+
+O nome de CPU de Debian da máquina anfitriã (desde dpkg 1.13.2).
+
+=item B<DEB_HOST_ARCH_BITS>
+
+O tamanho do ponteiro da máquina anfitriã (em bits, desde dpkg 1.15.4).
+
+=item B<DEB_HOST_ARCH_ENDIAN>
+
+A classe endian da máquina anfitriã (ittle / big; desde dpkg 1.15.4).
+
+=item B<DEB_HOST_GNU_CPU>
+
+A parte CPU GNU de B<DEB_HOST_GNU_TYPE>.
+
+=item B<DEB_HOST_GNU_SYSTEM>
+
+A parte de system GNU de B<DEB_HOST_GNU_TYPE>.
+
+=item B<DEB_HOST_GNU_TYPE>
+
+O tipo de sistema GNU da máquina anfitriã.
+
+=item B<DEB_HOST_MULTIARCH>
+
+O tipo de sistema GNU clarificado da máquina anfitriã, usado para caminhos
+do sistema de ficheiros (desde dpkg 1.16.0).
+
+=item B<DEB_TARGET_ARCH>
+
+A arquitectura Debian da máquina de destino (desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_ARCH_ABI>
+
+O nome ABI Debian da máquina alvo (desde dpkg 1.18.11).
+
+=item B<DEB_TARGET_ARCH_LIBC>
+
+O nome libc Debian da máquina alvo (desde dpkg 1.18.11).
+
+=item B<DEB_TARGET_ARCH_OS>
+
+O nome de sistema Debian da máquina de destino (desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_ARCH_CPU>
+
+O nome de CPU de Debian da máquina de destino (desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_ARCH_BITS>
+
+O tamanho do ponteiro da máquina de destino (em bits, desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_ARCH_ENDIAN>
+
+A classe endian da máquina de destino (ittle / big; desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_GNU_CPU>
+
+A parte CPU GNU de B<DEB_TARGET_GNU_TYPE> (desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_GNU_SYSTEM>
+
+A parte de system GNU de B<DEB_TARGET_GNU_TYPE> (desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_GNU_TYPE>
+
+O tipo de sistema GNU da máquina de destino (desde dpkg 1.17.14).
+
+=item B<DEB_TARGET_MULTIARCH>
+
+O tipo de sistema GNU clarificado da máquina de destino, usado para caminhos
+do sistema de ficheiros (desde dpkg 1.17.14).
+
+=back
+
+=head1 FICHEIROS
+
+=head2 Tabelas de arquitecturas
+
+Todos estes ficheiros têm de estar presentes para o B<dpkg-architecture>
+funcionar. A sua localização pode ser sobreposta durante o funcionamento com
+a variável de ambiente B<DPKG_DATADIR>. Estas tabelas contêm um pseudo-campo
+B<Version> de formato na sua primeira linha para marcar o seu formato, para
+que os analisadores possam verificar se o compreendem, tal como "#
+Version=1.0".
+
+=over 
+
+=item I<%PKGDATADIR%/cputable>
+
+Tabela de nomes de CPU conhecidas e o mapear delas para o seu nome
+GNU. Formato versão 1.0 (desde dpkg 1.13.2).
+
+=item I<%PKGDATADIR%/ostable>
+
+Tabela de nomes de sistemas operativos conhecidos e o mapear deles para o
+seu nome GNU. Formato versão 2.0 (desde dpkg 1.18.11).
+
+=item I<%PKGDATADIR%/tupletable>
+
+Mapeamento entre tuples de arquitectura Debian e nomes de arquitectura
+Debian. Versão de formato 1.0 (desde dpkg 1.18.11).
+
+=item I<%PKGDATADIR%/abitable>
+
+Tabela de sobreposições de atributos ABI de arquitectura Debian. Versão de
+formato 2.0 (desde dpkg 1.18.11).
+
+=back
+
+=head2 Suporte a empacotamento
+
+=over 
+
+=item I<%PKGDATADIR%/architecture.mk>
+
+Fragmento do Makefile cuja propriedade define e exporta todas as variáveis
+que o B<dpkg-architecture> gera como resultado (desde dpkg 1.16.1).
+
+=back
+
+=head1 EXEMPLOS
+
+B<dpkg-buildpackage> aceita a opção B<-a> e passa-a para
+B<dpkg-architecture>. Outros exemplos:
+
+=over 
+
+ CC=i386-gnu-gcc dpkg-architecture -c debian/rules build
+
+ eval $(dpkg-architecture -u)
+
+=back
+
+Verifica se a arquitectura actual ou da máquina especificada é igual a uma
+arquitectura:
+
+=over 
+
+ dpkg-architecture -elinux-alpha
+
+ dpkg-architecture -amips -elinux-mips
+
+=back
+
+Verifica se a arquitectura actual ou da máquina especificada é um sistema
+Linux.
+
+=over 
+
+ dpkg-architecture -ilinux-any
+
+ dpkg-architecture -ai386 -ilinux-any
+
+=back
+
+=head2 Utilização em debian/rules
+
+As variáveis de ambiente definidas pelo B<dpkg-architecture> são passadas
+para I<debian/rules> como variáveis do make (veja a documentação do
+make). No entanto, você não deve confiar nelas, porque prejudicam a
+invocação manual do script. Em vez disso, você deve sempre inicializá-las
+usando B<dpkg-architecture> com a opção B<-q>. Aqui estão alguns exemplos,
+que também mostram como você pode melhorar o suporte a compilação cruzada no
+seu pacote:
+
+Obter o tipo de sistema GNU e reencaminhá-lo para ./configure:
+
+=over 
+
+ DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
+ DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
+ [...]
+ ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))
+  confflags += --build=$(DEB_HOST_GNU_TYPE)
+  else
+   confflags += --build=$(DEB_BUILD_GNU_TYPE) \
+                --host=$(DEB_HOST_GNU_TYPE)
+ endif
+ [...]
+ ./configure $(confflags)
+
+=back
+
+Fazer algo apenas para uma arquitectura específica:
+
+=over 
+
+ DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)
+
+ ifeq ($(DEB_HOST_ARCH),alpha)
+   [...]
+ endif
+
+=back
+
+ou se você apenas precisar de verificar o tipo de CPU ou SO, use as
+variáveis B<DEB_HOST_ARCH_CPU> ou B<DEB_HOST_ARCH_OS>
+
+Note que você também pode confiar num retalho externo do Makefile para
+definir apropriadamente todas as variáveis que o B<dpkg-architecture> pode
+fornecer.
+
+=over 
+
+ include %PKGDATADIR%/architecture.mk
+
+ ifeq ($(DEB_HOST_ARCH),alpha)
+   [...]
+ endif
+
+=back
+
+Em qualquer dos casos, você nunca deverá usar o B<dpkg --print-architecture>
+para obter informação de arquitectura durante uma compilação de pacote.
+
+=head1 AMBIENTE
+
+=over 
+
+=item B<DPKG_DATADIR>
+
+Se definida, será usada como o directório de dados do B<dpkg>, onde as
+tabelas de arquitectura estão localizadas (desde 1.14.17). A predefinição é
+«%PKGDATADIR%».
+
+=item B<DPKG_COLORS>
+
+Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites
+são: B<auto> (predefinido), B<always> e B<never>.
+
+=item B<DPKG_NLS>
+
+Se definida, será usada para decidir se deve activar o Suporte a Linguagem
+Nativa. Também como conhecido como suporte de internacionalização (ou i18n)
+(desde dpkg 1.19.0). Os valores aceites são B<0> e B<1> (predefinição).
+
+=back
+
+=head1 NOTAS
+
+Todos comandos e nomes de opções longos disponíveis apenas desde dpkg
+1.17.17.
+
+=head1 VEJA TAMBÉM
+
+B<dpkg-buildpackage>(1).
+
+
+=head1 TRADUÇÃO
+
+Américo Monteiro
+
+Se encontrar algum erro na tradução deste documento, por favor comunique para
+Américo Monteiro <a_monteiro@gmx.com>.