Adding upstream version 1.22.4.upstream/1.22.4

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

1 files changed, 461 insertions, 0 deletions

diff --git a/man/pt/dpkg-architecture.pod b/man/pt/dpkg-architecture.pod
new file mode 100644
index 0000000..7403121
--- /dev/null
+++ b/man/pt/dpkg-architecture.pod
@@ -0,0 +1,461 @@
+
+        *****************************************************
+        *           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 RESUMO
+
+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.
+
+The build architecture is always determined by either the B<DEB_BUILD_ARCH> variable if set (and B<--force> not being specified) or by an external call to L<dpkg(1)>, and cannot be set at the command line.
+
+You can specify the host architecture by providing one or both of the options B<--host-arch> and B<--host-type>, otherwise the B<DEB_HOST_ARCH> variable is used if set (and B<--force> not being specified).  The default is determined by an external call to L<gcc(1)>, or the same as the build architecture if B<CC> or gcc are both not available.  One out of B<--host-arch> and B<--host-type> is sufficient, the value of the other will be set to a usable default.  Indeed, it is often better to only specify one, because B<dpkg-architecture> will warn you if your choice does not match the default.
+
+=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.
+
+Se a I<string-de-comando> conter meta-caracteres de shell, então será invocada através da shell limite do sistema.
+
+=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>
+
+Values set by existing environment variables with the same name as used by the scripts are honored (i.e. used by B<dpkg-architecture>), except if this force flag is present.  This allows the user to override a value even when the call to B<dpkg-architecture> is buried in some other script (for example L<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, ou o que emulador que irá correr código para. Isto é apenas necessário quando se compila ferramenta-corrente-cruzada (ou emulador), uma que será compilada sobre a arquitectura de compilação, para ser corrida na arquitectura anfitriã, e para compilar código (ou correr emulado) 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 inicializa-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 reencaminha-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
+
+L<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>.