*****************************************************
        *           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-name - renomeia pacotes Debian para o nome de pacote completo

=head1 RESUMO

B<dpkg-name> [I<option>...] [B<-->] I<file>...

=head1 DESCRIÇÃO

This manual page documents the B<dpkg-name> program which provides an easy way to rename B<Debian> packages into their full package names.  A full package name consists of I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified in the control file of the package.  The I<version> part of the filename consists of the upstream version information optionally followed by a hyphen and the revision information.  The I<package-type> part comes from that field if present or will fall back to B<deb>.

=head1 OPÇÕES

=over 

=item B<-a>, B<--no-architecture>

O nome de ficheiro de destino não terá a informação de arquitectura.

=item B<-k>, B<--symlink>

Cria um link simbólico, em vez de mover.

=item B<-o>, B<--overwrite>

Os ficheiros existentes serão sobrescritos se tiverem o mesmo nome que o nome de ficheiro de destino.

=item B<-s>, B<--subdir> [I<dir>]

Os ficheiros serão movidos para um sub-directório. Se o directório dado como argumento existir, os ficheiros serão movidos para esse directório, caso contrário, o nome do directório alvo é extraído do campo section na parte de controlo do pacote. O directório alvo irá ser «unstable/binary-I<architecture>/I<section>».  Se a section não for encontrada no controlo, então é assumido B<no-section>, e neste caso, assim como para secções B<non-free> e B<contrib> o directório alvo é «I<section>/binary-I<architecture>».  O campo section não é necessário, assim muitos pacotes irão encontrar o seu caminho até à área B<no-section>.

B<Aviso>: Use esta opção com cuidado, ela faz porcaria.

=item B<-c>, B<--create-dir>

Esta opção pode ser usada em conjunto com a opção B<-s>. Se um directório meta não for encontrado será criado automaticamente.

B<Aviso>: Use esta opção com cuidado.

=item B<-?>, B<--help>

Mostra a mensagem de utilização e termina.

=item B<-v>, B<--version>

Mostra a versão e termina.

=back

=head1 AMBIENTE

=over 

=item B<DEB_HOST_ARCH>

Sets the host architecture.  This affects the architecture name used in the package filename.

=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 BUGS

Alguns pacotes não seguem a estrutura de nome I<pacote>B<_>I<versão>B<_>I<arquitectura>B<.deb>. Os pacotes renomeados pelo B<dpkg-name> irá seguir estas estrutura. Geralmente isto não terá impacto sobre como os pacotes serão instalados pelos L<dselect(1)>/L<dpkg(1)>, mas outras ferramentas de instalação podem depender desta estrutura de nomes.

=head1 EXEMPLOS

=over 

=item B<dpkg-name bar-foo.deb>

O ficheiro B<bar-foo.deb> ir+a ser renomeado para bar-foo_1.0-2_i386.deb ou algo semelhante (dependendo de que informação estiver na parte de controle de B<bar-foo.deb>).

=item B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>

Todos os ficheiros com a extensão B<deb> no directório /root/debian e nos seus sub-directórios serão renomeados pelo B<dpkg-name> se tal for requerido para nomes sem nenhuma informação de arquitectura.

=item B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>

B<Não faça isto.> O seu arquivo será baralhado completamente porque muitos pacotes não vêm com informação de secção. B<Não faça isto.>

=item B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>

Isto pode ser usado quando se compila novos pacotes.

=back

=head1 VEJA TAMBÉM

L<deb(5)>, L<deb-control(5)>, L<dpkg(1)>, L<dpkg-deb(1)>, L<find(1)>, L<xargs(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>.