dpkg-man 1.22.5 - en to pt translation catalogue (2245 entries)

note: type: =head1
en: NAME
pt: NOME

note: type: textblock
en: deb-buildinfo - Debian build information file format
pt: deb-buildinfo - formato Debian de ficheiro de informação de compilação

note: type: =head1
en: SYNOPSIS
pt: RESUMO

note: type: =head1
en: DESCRIPTION
pt: DESCRIÇÃO

note: type: textblock
en: Each Debian source package build can record the build information in a B<.buildinfo> control file, which contains a number of fields in L<deb822(5)> format.
pt: Cada compilação de pacote fonte Debian pode gravar a informação de compilação num ficheiro de controle B<.buildinfo>, o qual contem um número de campos em formato L<deb822(5)>.

note: type: textblock
en: Each field begins with a tag, such as B<Source> or B<Binary> (case insensitive), followed by a colon, and the body of the field (case sensitive unless stated otherwise).  Fields are delimited only by field tags.  In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in case of the multiline fields B<Binary-Only-Changes>, B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>, B<Checksums-Sha1> and B<Checksums-Sha256>, see below).
pt: Cada campo começa com uma etiqueta, tal como B<Source> ou B<Binary> (insensível a maiúsculas/minúsculas), seguida de dois pontos, e do corpo do campo (sensível a maiúsculas/minúsculas a menos que declarado o contrário). Os campos são delimitados apenas pelas etiquetas (tags) dos campos. Por outras palavras, o campo de texto pode ter várias linhas de comprimento, mas as ferramentas de instalação irão geralmente juntar as linhas quando processam o corpo do campo (excepto no caso de campos multi-linha B<Binary-Only-Changes>, B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>, B<Checksums-Sha1> e B<Checksums-Sha256>, ver abaixo).

note: type: textblock
en: The control data might be enclosed in an OpenPGP ASCII Armored signature, as specified in RFC4880.
pt: Os dados de controle podem estar inclusos numa assinatura OpenPGP ASCII Armored, como especificado em RFC4880.

note: type: textblock
en: The name of the B<.buildinfo> file will depend on the type of build and will be as specific as necessary but not more; the name will be:
pt: O nome do ficheiro B<.buildinfo> irá depender do tipo de compilação e será tão específico quanto necessário mas não mais; o nome irá ser:

note: type: textblock
en: for a build that includes B<any>
pt: para uma compilação que inclua B<any>

note: type: textblock
en: otherwise for a build that includes B<all>
pt: caso contrário para uma compilação que inclua B<all>

note: type: textblock
en: otherwise for a build that includes B<source>
pt: caso contrário para uma compilação que inclua B<source>

note: type: =head1
en: FIELDS
pt: CAMPOS

note: type: =item
en: B<Format:> I<format-version> (required)
pt: B<Format:> I<format-version> (necessário)

note: type: textblock
en: The value of this field declares the format version of the file.  The syntax of the field value is a version number with a major and minor component.  Backward incompatible changes to the format will bump the major version, and backward compatible changes (such as field additions) will bump the minor version.  The current format version is B<1.0>.
pt: O valor deste campo declara a versão de formato do ficheiro. A sintaxe do valor do campo é um número de versão com um componente maior ou menor. Alterações incompatíveis com versões anteriores ao formato irão colidir com a versão maior, e alterações compatíveis com versões anteriores (tais como adições de campos) irão colidir com a versão menor. A versão de formato actual é B<1.0>.

note: type: =item
en: B<Source:> I<source-name> [B<(>I<source-version>B<)>] (required)
pt: B<Source:> I<source-name> [B<(>I<source-version>B<)>] (necessário)

note: type: textblock
en: The name of the source package.  If the source version differs from the binary version, then the I<source-name> will be followed by a I<source-version> in parenthesis.  This can happen when the build is for a binary-only non-maintainer upload.
pt: O nome do pacote fonte. Se a versão fonte diferir da versão binário, então o I<source-name> será seguido por um I<source-version> em parênteses. Isto pode acontecer quando a compilação é para envio de não-maintainer apenas-binário.

note: type: =item
en: B<Binary:> I<binary-package-list> (required in context)
pt: B<Binary:> I<binary-package-list> (necessário em contexto)

note: type: textblock
en: This folded field is a space-separated list of binary packages built.  If the build is source-only, then the field is omitted (since dpkg 1.20.0).
pt: Este campo dobrado é uma lista de pacotes binários compilados separados por espaços. Se a compilação for de "apenas-fonte", então o campo é omitido (desde dpkg 1.20.0).

note: type: =item
en: B<Architecture:> I<arch-list> (required)
pt: B<Architecture:> I<arch-list> (necessário)

note: type: textblock
en: This space-separated field lists the architectures of the files currently being built.  Common architectures are B<amd64>, B<armel>, B<i386>, etc.  Note that the B<all> value is meant for packages that are architecture independent.  If the source for the package is also being built, the special entry B<source> is also present.  Architecture wildcards must never be present in the list.
pt: Este campo separado por espaços lista as arquitecturas de todos os ficheiros actualmente a serem compilados. Arquitecturas comuns são B<amd64>, B<armel>, B<i386>, etc. Note que o valor B<all> destina-se a pacotes que são independentes da arquitectura. Se o pacote fonte for também compilado, está também presente a entrada especial B<source>. Wildcards de arquitectura nunca devem estar presentes na lista.

note: type: =item
en: B<Version:> I<version-string> (required)
pt: B<Version:>I< string-de-versão> (obrigatório)

note: type: textblock
en: Typically, this is the original package's version number in whatever form the program's author uses.  It may also include a Debian revision number (for non-native packages).  The exact format and sorting algorithm are described in L<deb-version(7)>.
pt: Tipicamente, isto é o número de versão do pacote original seja em que formato o autor do programa usa. Pode também incluir um número de revisão Debian (para pacotes não-nativos). O formato exacto e algoritmo de ordenação estão descritos em L<deb-version(7)>.

note: type: textblock
en: This multiline field contains the concatenated text of the changelog entry for a binary-only non-maintainer upload (binNMU) if that is the case.  To make this a valid multiline field empty lines are replaced with a single full stop (‘.’) and all lines are indented by one space character.  The exact content depends on the changelog format.
pt: Este campo multi-linha contem o texto concatenado da entrada changelog para um envio de não-maintainer apenas binário (binNMU) se esse for o caso. Para tornar isto numa entrada multi-linha válida as linhas vazias são substituídas com um único ponto final (‘.’) e todas as linhas são indentadas por um caractere de espaço. O conteúdo exacto depende do formato do changelog.

note: type: =item
en: B<Checksums-Md5:> (required)
pt: B<Checksums-Md5:> (necessário)

note: type: =item
en: B<Checksums-Sha1:> (required)
pt: B<Checksums-Sha1:> (necessário)

note: type: =item
en: B<Checksums-Sha256:> (required)
pt: B<Checksums-Sha256:> (necessário)

note: type: textblock
en: These multiline fields contain a list of files with a checksum and size for each one.  These fields have the same syntax and differ only in the checksum algorithm used: MD5 for B<Checksums-Md5>, SHA-1 for B<Checksums-Sha1> and SHA-256 for B<Checksums-Sha256>.
pt: Estes campos multi-linha contêm uma lista de ficheiros com um sumário de verificação e tamanho para cada um deles. Estes campos têm a mesma sintaxe e diferem apenas no algoritmo de checksum usado: MD5 para B<Checksums-Md5>, SHA-1 para B<Checksums-Sha1> e SHA-256 para B<Checksums-Sha256>.

note: type: textblock
en: The first line of the field value (the part on the same line as the field name followed by a colon) is always empty.  The content of the field is expressed as continuation lines, one line per file.  Each line consists of space-separated entries describing the file: the checksum, the file size, and the file name.
pt: A primeira linha do campo valor (a parte na mesma linha que tem o campo nome seguido de dois pontos) é sempre vazia. O conteúdo do campo é expressado como linhas de continuação, uma linha por ficheiro. Cada linha consiste de entradas separadas por espaços que descrevem o ficheiro: o sumário de verificação (checksum), o tamanho do ficheiro, e o nome do ficheiro.

note: type: textblock
en: These fields list all files that make up the build.
pt: Estes campos listam todos os ficheiros que fazem a compilação.

note: type: textblock
en: The name of the distribution this package is originating from.
pt: O nome da distribuição de onde este pacote originou.

note: type: =item
en: B<Build-Architecture:> I<arch> (required)
pt: B<Build-Architecture:> I<arch> (necessário)

note: type: textblock
en: The Debian architecture for the installation the packages is being built in.  Common architectures are B<amd64>, B<armel>, B<i386>, etc.
pt: A arquitectura Debian para a instalação dos pacotes que estão a ser compilados. Arquitecturas comuns são B<amd64>, B<armel>, B<i386>, etc.

note: type: textblock
en: The date the package was built.  It must be in the same format as the date in a L<deb-changelog(5)> entry.
pt: A data em que o pacote foi compilado. Tem de estar no mesmo formato que a data duma entrada L<deb-changelog(5)>.

note: type: textblock
en: The release and version (in an unspecified format) of the kernel running on the build system.  This field is only going to be present if the builder has explicitly requested it, to avoid leaking possibly sensitive information.
pt: O lançamento e versão (num formato não especificado) do kernel que corre no sistema de compilação. Este campo só vai estar presente se o compilador o tiver explicitamente requerido, para evitar fugir informação possivelmente sensível.

note: type: textblock
en: The absolute build path, which correspond to the unpacked source tree.  This field is only going to be present if the vendor has allowed it via some pattern match to avoid leaking possibly sensitive information.
pt: O caminho de compilação absoluto, que corresponde à árvore fonte desempacotada. Este campo apenas vai estar presente se o fornecedor o permitiu via algum padrão de correspondência para evitar denunciar informação possivelmente sensível.

note: type: textblock
en: On Debian and derivatives only build paths starting with I</build/> will emit this field.
pt: Em Debian e derivados apenas os caminhos de compilação começados com I</build/> irão emitir este campo.

note: type: textblock
en: This folded field contains a space-separated list of non-exhaustive reason tags (formed by alphanumeric and dash characters) which identify why the current build has been tainted (since dpkg 1.19.5).
pt: Este campo dobrado contem uma lista separada por espaços de etiquetas de razão não-exaustiva (formadas por caracteres alfanuméricos e traços) as quais identificam porque a compilação actual foi contaminada (desde dpkg 1.19.5).

note: type: textblock
en: On Debian and derivatives the following reason tags can be emitted:
pt: Em Debian e derivados as seguintes etiquetas de razão podem ser emitidas:

note: type: textblock
en: The system has a merged I</usr> via aliased directories (previously known as B<merged-usr-via-symlinks>).  This will confuse B<dpkg-query>, B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> and any other tool using pathnames as keys into their databases, as it creates filesystem aliasing problems, and messes with the understanding of the filesystem that B<dpkg> has recorded in its database.  For build systems that hardcode pathnames to specific binaries or libraries on the resulting artifacts, it can also produce packages that will be incompatible with non-/usr-merged filesystems.
pt: Este sistema tem um I</usr> fundido via directórios com nomes alternativos (anteriormente conhecido como B<merged-usr-via-symlinks>). Isto irá confundir B<dpkg-query>, B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> e qualquer outra ferramenta que use nomes-de-caminho como chaves para as suas base de dados, pois isto cria problemas de nomes alternativos no sistema de ficheiros, e complica o conhecimento do sistema de ficheiros que o B<dpkg> gravou na sua base de dados. Para sistema de compilação, isso .  For build systems that dificulta a codificação dos nomes de caminhos para binários ou bibliotecas específicas nos artefactos resultantes, também pode produzir pacotes que sejam incompatíveis com sistemas de ficheiros não-usr fundidos.

note: type: textblock
en: The system has configuration files under I</usr/local/etc>.
pt: O sistema tem ficheiros de configuração sob I</usr/local/etc>.

note: type: textblock
en: The system has header files under I</usr/local/include>.
pt: O sistema tem ficheiros cabeçalho sob I</usr/local/include>.

note: type: textblock
en: The system has programs under I</usr/local/bin> or I</usr/local/sbin>.
pt: O sistema tem programas sob I</usr/local/bin> ou I</usr/local/sbin>.

note: type: textblock
en: The system has libraries, either static or shared under I</usr/local/lib>.
pt: O sistema tem bibliotecas, sejam estáticas ou partilhadas sob I</usr/local/lib>.

note: type: textblock
en: The system can execute cross built programs, either directly or via some emulation layer.
pt: O sistema pode executar programas de compilação cruzada, seja diretamente ou via algum tipo de emulação.

note: type: textblock
en: Since dpkg 1.21.10.
pt: Desde dpkg 1.21.10.

note: type: =item
en: B<Installed-Build-Depends:> (required)
pt: B<Installed-Build-Depends:> (necessário)

note: type: textblock
en: The list of installed and configured packages that might affect the package build process.
pt: A lista de pacotes instalados e configurados que podem afectar o processo de compilação do pacote.

note: type: textblock
en: The list consists of each package name, optionally arch-qualified for foreign architectures, with an exact version restriction, separated by commas.
pt: A lista consiste do nome de cada pacote, opcionalmente tem a qualificação da arquitectura para outras arquitecturas, com uma restrição de versão exacta, separados por vírgulas.

note: type: textblock
en: The list includes all essential packages, packages listed in B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> source control fields, any vendor specific builtin dependencies, and all their recursive dependencies.  On Debian and derivatives the dependency builtin is B<build-essential>.
pt: A lista inclui todos os pacotes essenciais, os pacotes listados em B<Build-Depends>, B<Build-Depends-Arch>, campos de controle de fonte B<Build-Depends-Indep>, quaisquer dependências de compilação específicas do fornecedor, e todas as suas dependências recursivas. Em Debian e derivados a dependência embutida é B<build-essential>.

note: type: textblock
en: For dependencies coming from the source control fields, all dependency alternatives and all providers of virtual packages depended on will be included.
pt: Para as dependências que venham de campos de controle da fonte, todas as alternativas a dependências e todos os fornecedores de pacotes virtuais de quais se depende serão incluídos.

note: type: textblock
en: The list of environment variables that are known to affect the package build process, with each environment variable followed by an equal sign (‘=’)  and the variable's quoted value, using double quotes (‘"’), and backslashes escaped (‘\\’).
pt: A lista de variáveis de ambiente que se sabe afectarem o processo de compilação do pacote, com cada variável de ambiente seguida por um sinal igual (‘=’)  e o valor da variável citando entre aspas (‘"’), e barras  escapadas (‘\\’).

note: type: =head1
en: SEE ALSO
pt: VEJA TAMBÉM

note: type: textblock
en: deb-changelog - dpkg source packages' changelog file format
pt: deb-changelog - formato do ficheiro changelog de pacotes fonte dpkg

note: type: textblock
en: Changes in the packaged version of a project are explained in the changelog file I<debian/changelog>.  This includes modifications made in the source package compared to the upstream one as well as other changes and updates to the package.
pt: Alterações na versão empacotada de um projecto estão explicadas no ficheiro de registo de alterações I<debian/changelog>.  Isto inclui modificações feitas no pacote fonte comparadas com as do autor assim como outras alterações e actualizações feitas ao pacote.

note: type: textblock
en: The format of the I<debian/changelog> allows the package building tools to discover which version of the package is being built and find out other release-specific information.
pt: O formato do I<debian/changelog> permite às ferramentas de compilação do pacote descobrir qual a versão do pacote está a ser compilada e descobrir outras informações específicas do lançamento.

note: type: textblock
en: That format is a series of entries like this:
pt: Esse formato é uma série de entradas como esta:

note: type: textblock
en: I<package> and I<version> are the source package name and version number.  I<version> is delimited by parenthesis U+00028 ‘B<(>’ and U+0029 ‘B<)>’.
pt: I<package> e I<version> são o nome do pacote fonte e o número da versão. I<version> é delimitado por parêntesis U+00028 ‘B<(>’ e U+0029 ‘B<)>’.

note: type: textblock
en: I<distributions> lists one or more space-separated distributions where this version should be installed when it is uploaded; it is copied to the B<Distribution> field in the I<.changes> file.  I<distributions> must be terminated by a semicolon (U+003B ‘B<;>’).
pt: I<distributions> lista uma ou mais distribuições separadas por espaços onde esta versão deve ser instalada quando é enviada; é copiado para o campo B<Distribution> no ficheiro I<.changes>. I<distributions> tem de ser terminada com um caractere ponto e vírgula (U+003B ‘B<;>’).

note: type: textblock
en: I<metadata> lists zero or more comma-separated I<keyword>=I<value> items.  Each keyword can contain only minus and case insensitive alphanumeric characters, as they need to be mapped to L<deb822(5)> field names.  The only I<keyword>s currently supported by B<dpkg> are:
pt: I<metadata> lista zero ou mais itens I<keyword>=I<value> separados por espaços. Cada palavra-chave pode conter apenas os caracteres menos e alfanuméricos insensíveis a maiúsculas/minúsculas, pois precisam de ser mapeadas para nomes de campos L<deb822(5)>. As únicas I<keyword>s presentemente suportadas pelo B<dpkg> são:

note: type: textblock
en: Its value is used for the B<Urgency> field in the I<.changes> file for the upload.
pt: O seu valor é usado para o campo B<Urgency> no ficheiro I<.changes> para o envio.

note: type: textblock
en: With a B<yes> value, it is used to denote that this changelog entry is for a binary-only non-maintainer upload (an automatic binary rebuild with the only change being the changelog entry).
pt: Com um valor B<yes>, é usado para denotar que esta entrada no changelog é para um envio binary-only non-maintainer (uma recompilação binária automática com a única alteração a ser a entrada changelog).

note: type: textblock
en: The change details may in fact be any series of lines starting with at least two spaces (U+0020 B<SPACE>), but conventionally each change starts with an asterisk and a separating space and continuation lines are indented so as to bring them in line with the start of the text above.  Blank lines may be used here to separate groups of changes, if desired.
pt: Os detalhes da alteração podem de facto serem qualquer série de linhas começando com pelo menos dois espaços (U+0020 B<SPACE>), mas convencionalmente cada alteração começa com um asterisco e um espaço de separação e as linhas de continuação são recuadas para as alinhar com o inicio de texto em cima. Linhas vazias podem ser usadas aqui para separar grupos de alterações, se desejado.

note: type: textblock
en: If this upload resolves bugs recorded in the distribution bug tracking system, they may be automatically closed on the inclusion of this package into the distribution archive by including the string:
pt: Se este envio resolver bugs guardados no sistema de acompanhamento de bugs da distribuição, estes podem ser fechados automaticamente na inclusão deste pacote no arquivo da distribuição ao incluir a string:

note: type: textblock
en: in the change details, where B<#>I<nnnnn> is the bug number.  The exact Perl regular expression is:
pt: nos detalhes de alteração, onde B<#>I<nnnnn> é o número do bug. A expressão regular Perl exacta é:

note: type: textblock
en: That is, the string should consist of the word B<closes:> followed by a comma-separated list of bug numbers.  Bug numbers may be preceded by the word B<bug> and/or a B<#> sign, as in C<Closes: 42, bug#43, #44, bug 45>.  The words B<closes:> and B<bug> are not case sensitive.  The list of bug numbers may span multiple lines.
pt: Isto é, a string deve consistir da palavra B<closes:> seguida por uma lista separada por vírgulas de números de bug.  Os números de bug podem ser precedidos pela palavra B<bug> e/ou sinal B<#>, como em C<Closes: 42, bug#43, #44, bug 45>.  As palavras B<closes:> e B<bug> não são sensíveis a maiúsculas/minúsculas. A lista de números de bug pode ocupar várias linhas.

note: type: textblock
en: This information is conveyed via the B<Closes> field in the I<.changes> file.  Where, depending on the archive maintenance software, all the bug numbers listed might get automatically closed.
pt: Esta informação é transmitida via campo B<Closes> no ficheiro I<.changes>. Onde, dependendo do software de manutenção do arquivo, todos os números de bug listados podem ser fechados automaticamente.

note: type: textblock
en: The maintainer name and email address used in the changelog should be the details of the person who prepared this release of the package.  They are B<not> necessarily those of the uploader or usual package maintainer.  The information here will be copied to the B<Changed-By> field in the I<.changes> file, and then later might be used to send an acknowledgment when the upload has been installed in the distribution archive.
pt: O nome de maintainer e endereço email usado no changelog deverão ser os detalhes da pessoa que preparou este lançamento do pacote. B<Não> são necessários os da pessoa que faz o envio ou do maintainer habitual do pacote. A informação daqui será copiada para o campo B<Changed-By> no ficheiro I<.changes>, e depois mais tarde pode ser usada para enviar uma confirmação quando o pacote enviado for instalado no arquivo da distribuição.

note: type: textblock
en: The I<date> has the following format (compatible and with the same semantics of RFC2822 and RFC5322, or what «date -R» generates):
pt: O I<date> tem o seguinte formato (compatível com as mesmas semânticas de RFC2822 e RFC5322, ou o que «date -R» gerar):

note: type: textblock
en: where:
pt: onde:

note: type: textblock
en: Is one of: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>.
pt: É um de: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>.

note: type: textblock
en: Is a one- or two-digit day of the month (B<01>-B<31>), where the leading zero is optional, but conventionally does not get omitted.
pt: E um dia do mês de um ou dois dígitos (B<01>-B<31>), onde o zero inicial é opcional, mas convencionalmente não é omitido.

note: type: textblock
en: Is one of: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, B<Sep>, B<Oct>, B<Nov>, B<Dec>.
pt: É um de of: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, B<Sep>, B<Oct>, B<Nov>, B<Dec>.

note: type: textblock
en: Is the four-digit year (e.g. 2010).
pt: É o ano em quatro dígitos (ex. 2020).

note: type: textblock
en: Is the two-digit hour (B<00>-B<23>).
pt: É a hora em dois dígitos (B<00>-B<23>).

note: type: textblock
en: Is the two-digit minutes (B<00>-B<59>).
pt: É os minutos em dois dígitos (B<00>-B<59>).

note: type: textblock
en: Is the two-digit seconds (B<00>-B<60>).
pt: É os segundos em dois dígitos (B<00>-B<60>).

note: type: textblock
en: Is the time zone offset from Coordinated Universal Time (UTC).  ‘B<+>’ indicates that the time is ahead of (i.e., east of) UTC and ‘B<->’ indicates that the time is behind (i.e., west of) UTC.  The first two digits indicate the hour difference from UTC and the last two digits indicate the number of additional minutes difference from UTC.  The last two digits must be in the range B<00>-B<59>.
pt: é o deslocamento de fuso horário de Coordinated Universal Time (UTC).  ‘B<+>’ indica que a hora é adiantada de (isto é, a este de) UTC e ‘B<->’ indica que a hora é atrasada de (isto é, a oeste) UTC. Os  primeiros dois dígitos indicam a diferença horária de UTC e os dois últimos dígitos indicam o número de minutos adicionais em diferença a UTC. OS últimos dois dígitos têm de estar dentro do alcance  B<00>-B<59>.

note: type: textblock
en: The first “title” line with the package name must start at the left hand margin.  The “trailer” line with the maintainer and date details must be preceded by exactly one space (U+0020 B<SPACE>).  The maintainer details and the date must be separated by exactly two spaces (U+0020 B<SPACE>).  Each part of the I<date> can be separated by one or more spaces (U+0020 B<SPACE>), except after the comma where it can be separated by zero or more spaces (U+0020 B<SPACE>).
pt: A primeira linha "título" com no nome do pacote tem de começar na margem esquerda. margin.  A linha final “trailer” com os detalhes do maintainer e data deve ser precedida de exactamente um espaço (U+0020 B<SPACE>). Os detalhes do maintainer e a data devem estar separados por exactamente dois espaços (U+0020 B<SPACE>).  Cada parte de I<date> pode ser separada  por um ou mais espaços (U+0020 B<SPACE>), excepto após a vírgula onde pode ser separada por zero ou mais espaços (U+0020 B<SPACE>).

note: type: textblock
en: Any line that consists entirely (i.e., no leading whitespace) of B<#> or B</* */> style comments or RCS keywords.
pt: Quaisquer linhas que consistam inteiramente (isto é, sem espaço em branco à esquerda) de B<#> ou B</* */> são comentários de estilo ou palavras chave RCS.

note: type: textblock
en: Vim modelines or Emacs local variables, and ancient changelog entries with other formats at the end of the file should be accepted and preserved on output, but their contents might be otherwise ignored and parsing stopped at that point.
pt: Linhas modelo do Vim ou variáveis locais do Emacs, e entradas changelog antigas com outros formatos até ao fim do ficheiro devem ser aceites e preservados no resultado, mas os seus conteúdos podem ser por outro lado ignorados e a análise parada nesse ponto.

note: type: textblock
en: The entire changelog must be encoded in UTF-8.
pt: Todo o changelog tem de estar codificado em UTF-8.

note: type: =head1
en: FILES
pt: FICHEIROS

note: type: =head1
en: EXAMPLES
pt: EXEMPLOS

note: type: textblock
en: deb-changes - Debian upload changes control file format
pt: deb-changes - Formato Debian de ficheiro de controle de envio de alterações

note: type: textblock
en: Each Debian upload is composed of a .changes control file, which contains a number of fields in L<deb822(5)> format.
pt: Cada envio Debian é composto de um ficheiro de controle .changes, o qual contém um número de campos em formato L<deb822(5)>.

note: type: textblock
en: Each field begins with a tag, such as B<Source> or B<Binary> (case insensitive), followed by a colon, and the body of the field (case sensitive unless stated otherwise).  Fields are delimited only by field tags.  In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in case of the multiline fields B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> and B<Checksums-Sha256>, see below).
pt: Cada campo começa com uma etiqueta, tal como B<Source> ou B<Binary> (insensível a maiúsculas/minúsculas), seguida do símbolo dois pontos, e o corpo do campo (sensível a maiúsculas/minúsculas a menos que declarado o contrário). Os campos são delimitados apenas por etiquetas de campos. Por outras palavras, o texto do campo pode ter várias linhas de comprimento, mas as ferramentas de instalação irão geralmente juntar as linhas quando processam o corpo do campo (excepto no caso de B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> e B<Checksums-Sha256> de múltiplos campos, ver abaixo).

note: type: textblock
en: The value of this field declares the format version of the file.  The syntax of the field value is a version number with a major and minor component.  Backward incompatible changes to the format will bump the major version, and backward compatible changes (such as field additions) will bump the minor version.  The current format version is B<1.8>.
pt: O valor deste campo declara a versão de formato do ficheiro. A sintaxe do valor do campo é um número de versão com um componente maior ou menor. Alterações incompatíveis com versões anteriores ao formato irão colidir com a versão maior, e alterações compatíveis com versões anteriores (tais como adições de campos) irão colidir com a versão menor. A versão de formato actual é B<1.8>.

note: type: =item
en: B<Date:> I<release-date> (required)
pt: B<Date:> I<release-date> (necessário)

note: type: textblock
en: The date the package was built or last edited.  It must be in the same format as the date in a L<deb-changelog(5)> entry.
pt: A data em que o pacote foi compilado ou editado pela última vez. Tem de estar no mesmo formato que a data duma entrada em L<deb-changelog(5)>.

note: type: textblock
en: The value of this field is usually extracted from the I<debian/changelog> file.
pt: O valor deste campo é geralmente extraído do ficheiro I<debian/changelog>.

note: type: textblock
en: The name of the source package.  If the source version differs from the binary version, then the I<source-name> will be followed by a I<source-version> in parenthesis.  This can happen when the upload is a binary-only non-maintainer upload.
pt: O nome do pacote fonte. Se a versão de fonte diferir da versão binária, então o I<source-name> será seguido por um I<source-version> em parêntesis. Isto pode acontecer quando o envio ao arquivo é um envio de não-maintainer apenas-binário.

note: type: textblock
en: This folded field is a space-separated list of binary packages to upload.  If the upload is source-only, then the field is omitted (since dpkg 1.19.3).
pt: Este campo dobrado é uma lista de pacotes binários separados por espaços para enviar. Se o envio for de "apenas-fonte", então o campo é omitido (desde dpkg 1.19.3).

note: type: textblock
en: Lists the architectures of the files currently being uploaded.  Common architectures are B<amd64>, B<armel>, B<i386>, etc.  Note that the B<all> value is meant for packages that are architecture independent.  If the source for the package is also being uploaded, the special entry B<source> is also present.  Architecture wildcards must never be present in the list.
pt: Lista as arquitecturas dos ficheiros actualmente a serem enviados ao arquivo. Arquitecturas comuns são B<amd64>, B<armel>, B<i386>, etc.  Note que o valor B<all> destina-se a pacotes que são independentes da arquitectura. Se a fonte do pacote estiver também a ser enviada, a entrada especial B<source> está também presente. Wildcards de arquitectura nunca devem estar presentes na lista.

note: type: =item
en: B<Distribution:> I<distribution>s (required)
pt: B<Distribution:> I<distribution>s (necessário)

note: type: textblock
en: Lists one or more space-separated distributions where this version should be installed when it is uploaded to the archive.
pt: Lista uma ou mais distribuições separadas por espaços onde esta versão deve ser instalada quando é enviada para o arquivo.

note: type: =item
en: B<Urgency:> I<urgency> (recommended)
pt: B<Urgency:> I<urgency> (recomendado)

note: type: textblock
en: The urgency of the upload.  The currently known values, in increasing order of urgency, are: B<low>, B<medium>, B<high>, B<critical> and B<emergency>.
pt: A urgência do envio. Os valores presentemente conhecidos, em ordem ascendente de prioridade, são:  B<low>, B<medium>, B<high>, B<critical> e B<emergency>.

note: type: =item
en: B<Maintainer:> I<fullname-email> (required)
pt: B<Maintainer:> I<fullname-email> (necessário)

note: type: textblock
en: Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is typically the person who created the package, as opposed to the author of the software that was packaged.
pt: Deverá estar no formato “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, e é tipicamente a pessoa que criou o pacote, e não o autor do software que foi empacotado.

note: type: textblock
en: Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is typically the person who prepared the package changes for this release.
pt: Deverá estar no formato “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, e é tipicamente a pessoa que preparou as alterações no pacote para este lançamento.

note: type: =item
en: B<Description:> (recommended)
pt: B<Description:> (recomendado)

note: type: textblock
en: This multiline field contains a list of binary package names followed by a space, a dash (‘B<->’) and their possibly truncated short descriptions.  If the upload is source-only, then the field is omitted (since dpkg 1.19.3).
pt: Este campo multi-linha contem uma lista de nomes de pacotes binários seguida por um espaço, um traço (‘B<->’) a as suas descrições curtas possivelmente truncadas. Se o envio for apenas-fonte, então o campo é omitido (desde dpkg 1.19.3).

note: type: textblock
en: A space-separated list of bug report numbers for bug reports that have been resolved with this upload.  The distribution archive software might use this field to automatically close the referred bug numbers in the distribution bug tracking system.
pt: Uma lista separada por espaços de números de relatórios de bugs para relatórios de bugs que foram resolvidos com este envio. Os software do arquivo da distribuição pode usar este campo para fechar automaticamente os bugs com os números referenciados no sistema de acompanhamento de bugs da distribuição.

note: type: textblock
en: This field denotes that the upload is a binary-only non-maintainer build.  It originates from the B<binary-only=yes> key/value from the changelog metadata entry.
pt: Este campo indica que o envio é uma compilação de não-maintainer apenas-binário. É originado a partir da chave/valor B<binary-only=yes> da entrada de meta-dados do changelog.

note: type: textblock
en: This field specifies a whitespace separated list of build profiles that this upload was built with.
pt: Este campo especifica uma lista de perfis de compilação separados por espaços em branco, do que com que este envio foi compilado.

note: type: =item
en: B<Changes:> (required)
pt: B<Changes:> (necessário)

note: type: textblock
en: This multiline field contains the concatenated text of all changelog entries that are part of the upload.  To make this a valid multiline field empty lines are replaced with a single full stop (‘.’) and all lines are indented by one space character.  The exact content depends on the changelog format.
pt: Este campo multi-linha contem o texto concatenado de todas as entradas changelog que fazem parte do envio. Para tornar isto numa entrada multi-linha válida as linhas vazias são substituídas com um único ponto final (‘.’) e todas as linhas são indentadas por um caractere de espaço. O conteúdo exacto depende do formato do changelog.

note: type: =item
en: B<Files:> (required)
pt: B<Files:> (necessário)

note: type: textblock
en: This multiline field contains a list of files with an md5sum, size, section and priority for each one.
pt: Este campo multi-linha contem uma lista de ficheiros com um md5sum, tamanho, secção e prioridade para cada um.

note: type: textblock
en: The first line of the field value (the part on the same line as the field name followed by a colon) is always empty.  The content of the field is expressed as continuation lines, one line per file.  Each line consists of space-separated entries describing the file: the md5sum, the file size, the file section, the file priority, and the file name.
pt: A primeira linha do campo valor (a parte na mesma linha que tem o campo nome seguido de dois pontos) é sempre vazia. O conteúdo do campo é expressado como linhas de continuação, uma linha por ficheiro. Cada linha consiste de entradas separadas por espaços que descrevem o ficheiro: o md5sum, o tamanho do ficheiro, a secção do ficheiro, a prioridade do ficheiro, e o nome do ficheiro.

note: type: textblock
en: This field lists all files that make up the upload.  The list of files in this field must match the list of files in the other related B<Checksums> fields.
pt: Este campo lista todos os ficheiros que fizeram o envio. A lista de ficheiros neste campo tem de corresponder à lista de ficheiros nos outros campos B<Checksums> relacionados.

note: type: textblock
en: These multiline fields contain a list of files with a checksum and size for each one.  These fields have the same syntax and differ only in the checksum algorithm used: SHA-1 for B<Checksums-Sha1> and SHA-256 for B<Checksums-Sha256>.
pt: Estes campos multi-linha contêm uma lista de ficheiros com um sumário de verificação e tamanho para cada um deles. Estes campos têm a mesma sintaxe e diferem apenas no algoritmo de checksum usado: SHA-1 para B<Checksums-Sha1> e SHA-256 parar B<Checksums-Sha256>.

note: type: textblock
en: These fields list all files that make up the upload.  The list of files in these fields must match the list of files in the B<Files> field and the other related B<Checksums> fields.
pt: Estes campos listam todos os ficheiros que fizeram o envio. A lista de ficheiros nestes campos tem de corresponder à lista de ficheiros no campo B<Files> e aos outros campos B<Checksums> relacionados.

note: type: textblock
en: The B<Files> field is inconsistent with the other B<Checksums> fields.  The B<Changed-By> and B<Maintainer> fields have confusing names.  The B<Distribution> field contains information about what is commonly referred to as a suite.
pt: O campo B<Files> é inconsistente com os outros campos B<Checksums>. Os campos B<Changed-By> e B<Maintainer> têm nomes confusos. O campo B<Distribution> contem informação acerca do que é comum referir-se como uma suite.

note: type: textblock
en: deb-conffiles - package conffiles
pt: deb-conffiles - conffiles de pacote

note: type: textblock
en: A package declares its list of conffiles by including a I<conffiles> file in its control archive (i.e. I<DEBIAN/conffiles> during package creation).
pt: Um pacote declara a lista de conffiles ao incluir um ficheiro I<conffiles> no seu arquivo de controlo (isto é,  I<DEBIAN/conffiles>) durante a criação do pacote.

note: type: textblock
en: This file contains a list of files, one per line, with an optional leading flag separated by whitespace.  The conffiles must be listed as absolute pathnames.  Trailing whitespace will be trimmed, but empty or whitespace-only lines are not accepted.
pt: Este ficheiro contém uma lista de ficheiros, um por linha, com uma bandeira inicial opcional separada por espaço em branco. Os conffiles têm de estar listados com nomes de caminho absolutos. Os espaços em branco finais serão cortados, mas linhas vazias ou só com espaços em branco não são aceites.

note: type: textblock
en: Files without a flag should exist in the binary package, otherwise L<dpkg(1)> will ignore them.
pt: Ficheiros sem uma bandeira devem existir no pacote binário, caso contrário o L<dpkg(1)> os irá ignorar.

note: type: textblock
en: There is currently only one flag supported, B<remove-on-upgrade>, to mark that a conffile needs to be removed on the next upgrade (since dpkg 1.20.6).  These files must not exist in the binary package, as both L<dpkg(1)> and L<dpkg-deb(1)> will not accept building nor processing such binary packages.
pt: Presentemente só há uma bandeira suportada, B<remove-on-upgrade>, para marcar que um conffile precisa de ser removido na próxima actualização (desde dpkg 1.20.6).  Estes ficheiros não podem existir no pacote binário, pois ambos L<dpkg(1)> e L<dpkg-deb(1)> não irão aceitar compilar nem processar tais pacotes binários.

note: type: =head1
en: EXAMPLE
pt: EXEMPLO

note: type: textblock
en: deb-control - Debian binary package control file format
pt: deb-control - formato Debian de ficheiro de controle de pacote binário

note: type: textblock
en: Each Debian binary package contains a B<control> file in its B<control> member, and its L<deb822(5)> format is a subset of the B<debian/control> template source control file in Debian source packages, see L<deb-src-control(5)>.
pt: Cada pacote binário Debian contem um ficheiro B<control> no seu membro B<control>, e o seu formato L<deb822(5)> é um subconjunto do ficheiro modelo de controle de fonte B<debian/control> em pacotes fonte Debian, veja L<deb-src-control(5)>.

note: type: textblock
en: This file contains a number of fields.  Each field begins with a tag, such as B<Package> or B<Version> (case insensitive), followed by a colon, and the body of the field (case sensitive unless stated otherwise).  Fields are delimited only by field tags.  In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in the case of the B<Description> field, see below).
pt: Este ficheiro contém um número de campos. Cada campo começa com uma etiqueta, tal como B<Package> ou B<Version> (insensitivo a maiúsculas/minúsculas) seguido por dois pontos (:), e o corpo do campo (sensível a maiúsculas/minúsculas a menos que declarado o contrário). Os campos são delimitados apenas pelas etiquetas de campo, por outras palavras, o texto do campo pode ter múltiplas linhas de comprimento, mas as ferramentas de instalação irão geralmente juntar as linhas quando processam o corpo do campo (excepto no caso do campo B<Description>, veja em baixo).

note: type: =item
en: B<Package:> I<package-name> (required)
pt: B<Package:> I<package-name> (necessário)

note: type: textblock
en: The value of this field determines the package name, and is used to generate file names by most installation tools.
pt: O valor deste campo determina o nome do pacote, e é usado para gerar nomes de ficheiros pela maioria das ferramentas de instalação.

note: type: textblock
en: This field defines the type of the package.  B<udeb> is for size-constrained packages used by the debian installer.  B<deb> is the default value, it is assumed if the field is absent.  More types might be added in the future.
pt: Este campo define o tipo de pacote. B<udeb> é para pacotes de tamanho reduzido usados pelo instalador de debian. B<deb> é o valor predefinido, é assumido se o campo estiver ausente. Mais tipos podem ser adicionados no futuro.

note: type: =item
en: B<Maintainer:> I<fullname-email> (recommended)
pt: B<Maintainer:> I<fullname-email> (recomendado)

note: type: textblock
en: Should be in the format “Joe Bloggs E<lt>jbloggs@foo.comE<gt>”, and is typically the person who created the package, as opposed to the author of the software that was packaged.
pt: Deverá estar no formato "Joe Bloggs E<lt>jbloggs@foo.comE<gt>", e é tipicamente a pessoa que criou o pacote, e não o autor do software que foi empacotado.

note: type: =item
en: B<Description:> I<short-description> (recommended)
pt: B<Description:> I<short-description> (recomendado)

note: type: textblock
en: The format for the package description is a short brief summary on the first line (after the B<Description> field).  The following lines should be used as a longer, more detailed description.  Each line of the long description must be preceded by a space, and blank lines in the long description must contain a single ‘B<.>’ following the preceding space.
pt: O formato da descrição do pacote é um sumário breve e curto an primeira linha (após o campo B<Description>). As linhas seguintes devem ser usadas para uma descrição longa e mais detalhada. Cada linha da descrição longa tem de ser precedida com um espaço, e as linhas em branco na descrição longa têm de conter um único ‘B<.>’ a seguir ao espaço que precede.

note: type: textblock
en: This is a general field that gives the package a category based on the software that it installs.  Some common sections are B<utils>, B<net>, B<mail>, B<text>, B<x11>, etc.
pt: Este é um campo geral que dá ao pacote uma categoria baseada no software que ele instala. Algumas secções comuns são B<utils>, B<net>, B<mail>, B<text>, B<x11>, etc.

note: type: textblock
en: Sets the importance of this package in relation to the system as a whole.  Common priorities are B<required>, B<standard>, B<optional>, B<extra>, etc.
pt: Define a importância deste pacote relativamente ao sistema como um todo. Prioridades comuns são B<required>, B<standard>, B<optional>, B<extra>, etc.

note: type: textblock
en: The B<Section> and B<Priority> fields usually have a defined set of accepted values based on the specific distribution policy.
pt: Os campos B<Section> e B<Priority> têm geralmente um conjunto definido de valores aceites baseados na política específica da distribuição.

note: type: textblock
en: The approximate total size of the package's installed files, in KiB units.  The algorithm to compute the size is described in L<deb-substvars(5)>.
pt: O tamanho total aproximado dos ficheiros instalados pelo pacote, em unidades KiB. O algoritmo para computar o tamanho está descrito em L<deb-substvars(5)>.

note: type: textblock
en: This field is usually only needed when the answer is B<yes>.  It denotes a package that is required mostly for proper booting of the system or used for custom system-local meta-packages.  L<dpkg(1)> or any other installation tool will not allow a B<Protected> package to be removed (at least not without using one of the force options).
pt: Este campo normalmente não é necessário quando a resposta é B<yes>. Ele indica um pacote que é necessário principalmente para o arranque correcto do sistema ou usado para meta-pacotes personalizados locais-do-sistema. O L<dpkg(1)> ou qualquer outra ferramenta de instalação não irá permitir que um pacote B<Protected> seja removido (pelo menos não sem usar uma das opções de forçar).

note: type: textblock
en: Supported since dpkg 1.20.1.
pt: Suportado desde dpkg 1.20.1.

note: type: textblock
en: This field is usually only needed when the answer is B<yes>.  It denotes a package that is required for the packaging system, for proper operation of the system in general or during boot (although the latter should be converted to B<Protected> field instead).  L<dpkg(1)> or any other installation tool will not allow an B<Essential> package to be removed (at least not without using one of the force options).
pt: Este campo normalmente não é necessário quando a resposta é B<sim>. Ele indica um pacote que é necessário para o sistema de empacotamento, para a operação correcta do sistema no geral ou durante o arranque (apesar do último dever ser convertido para o campo B<Protected> em vez deste). O L<dpkg(1)> ou qualquer outra ferramenta de instalação não irá permitir que um pacote <Essential> seja removido (pelo menos não sem usar uma das opções de forçar).

note: type: textblock
en: This field is usually only needed when the answer is B<yes>, and is commonly injected by the archive software.  It denotes a package that is required when building other packages.
pt: Este campo geralmente não é necessário quando a resposta é B<sim>, e é injetado de modo comum pelo software do arquivo. Denota um pacote que é requerido quando se compila outros pacotes.

note: type: =item
en: B<Architecture:> I<arch>|B<all> (required)
pt: B<Architecture:> I<arch>|B<all> (necessário)

note: type: textblock
en: The architecture specifies which type of hardware this package was compiled for.  Common architectures are B<amd64>, B<armel>, B<i386>, B<powerpc>, etc.  Note that the B<all> value is meant for packages that are architecture independent.  Some examples of this are shell and Perl scripts, and documentation.
pt: A arquitectura especifica para que tipo de hardware este pacote foi compilado. Arquitecturas comuns são B<amd64>, B<armel>, B<i386>, B<powerpc>, etc. Note que o valor B<all> é destinada a pacotes que são independentes da arquitectura. Alguns exemplos disto são scripts de shell e Perl, e documentação.

note: type: textblock
en: The I<url> of the bug tracking system for this package.  The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>.
pt: O I<url> do sistema de acompanhamento de bugs deste pacote. O formato actualmente usado é I<tipo-bts>B<://>I<endereço-bts>, como B<debbugs://bugs.debian.org>.

note: type: textblock
en: The upstream project home page I<url>.
pt: O I<url> da página inicial do projecto do autor.

note: type: textblock
en: List of tags describing the qualities of the package.  The description and list of supported tags can be found in the B<debtags> package.
pt: Lista de etiquetas que descrevem as qualidades do pacote. A descrição e a lista de etiquetas suportadas pode ser encontrada no pacote B<debtags>.

note: type: textblock
en: This field is used to indicate how this package should behave on a multi-arch installations.
pt: Este campo é usado para indicar como este pacote deve comportar-se em instalações de multi-arquitectura.

note: type: textblock
en: This value is the default when the field is omitted, in which case adding the field with an explicit B<no> value is generally not needed.
pt: Este valor é a predefinição quando o campo é omitido, e neste caso adicionar o campo com um valor B<no> explícito geralmente não é necessário.

note: type: textblock
en: This package is co-installable with itself, but it must not be used to satisfy the dependency of any package of a different architecture from itself.
pt: Este pacote é co-instalável com ele próprio, mas não pode ser usado para satisfazer a dependência de qualquer pacote de uma arquitectura diferente de ele próprio.

note: type: textblock
en: This package is not co-installable with itself, but should be allowed to satisfy a non-arch-qualified dependency of a package of a different arch from itself (if a dependency has an explicit arch-qualifier then the value B<foreign> is ignored).
pt: Este pacote não é co-instalável com ele próprio, mas deve ser permitido satisfazer uma dependência non-arch-qualified de um pacote de uma arquitectura diferente dele próprio (se uma dependência tiver um arch-qualifier explícito então o valor B<foreign> é ignorado).

note: type: textblock
en: This allows reverse-dependencies to indicate in their B<Depends> field that they accept this package from a foreign architecture by qualifying the package name with B<:any>, but has no effect otherwise.
pt: Isto permite a dependências-reversas indicarem no seu campo B<Depends> que elas aceitam este pacote de outra arquitectura ao qualificar o nome do pacote com B<:any>, mas de outro modo não tem efeito.

note: type: textblock
en: The name of the source package that this binary package came from, if it is different than the name of the package itself.  If the source version differs from the binary version, then the I<source-name> will be followed by a I<source-version> in parenthesis.  This can happen for example on a binary-only non-maintainer upload, or when setting a different binary version via «B<dpkg-gencontrol -v>».
pt: O nome do pacote fonte de onde este pacote binário veio, se for diferente do nome do próprio pacote. Se a versão fonte diferir da versão binária, então o I<source-name> será seguido por um I<source-version> em parênteses. Isto pode acontecer por exemplo, num envio de não-maintainer apenas-binário, ou quando se define uma versão binária diferente via «B<dpkg-gencontrol -v>».

note: type: textblock
en: These fields are used by the debian-installer and are usually not needed.  For more details about them, see L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>.
pt: Estes campos são usados pelo instalador de debian e geralmente não são necessários. Para mais detalhes acerca deles, veja L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>.

note: type: textblock
en: List of packages that are required for this package to provide a non-trivial amount of functionality.  The package maintenance software will not allow a package to be installed if the packages listed in its B<Depends> field aren't installed (at least not without using the force options).  In an installation, the postinst scripts of packages listed in B<Depends> fields are run before those of the packages which depend on them.  On the opposite, in a removal, the prerm script of a package is run before those of the packages listed in its B<Depends> field.
pt: Lista de pacotes que ao requeridos para este pacotes poder disponibilizar uma não-trivial quantidade de funcionalidades. O software de manutenção de pacotes não irá permitir que o pacote seja instalado se os pacotes listados no seu campo B<Depends> não estiverem instalados (pelo menos não sem sem serem usadas opções de forçar). Numa instalação, os scripts postinst dos pacotes listados nos campos B<Depends> são corridos antes daqueles do pacote que depende deles. Em oposto, numa remoção, o script prerm de um pacote é corrido antes daqueles dos pacotes listados no seu campo B<Depends>.

note: type: textblock
en: List of packages that must be installed B<and> configured before this one can be installed.  This is usually used in the case where this package requires another package for running its preinst script.
pt: Lista de pacotes que têm de ser instalados B<e> configurados antes de este poder ser instalado. Isto é usado geralmente quando este pacote requer outro programa para correr o seu script preinst.

note: type: textblock
en: Lists packages that would be found together with this one in all but unusual installations.  The package maintenance software will warn the user if they install a package without those listed in its B<Recommends> field.
pt: Lista pacotes que seriam encontrados juntamente com este em todas as instalações menos nas forma do normal. O software de manutenção de pacotes irá avisar o utilizador se ele instalar um pacote sem aqueles listados no campo B<Recommends>.

note: type: textblock
en: Lists packages that are related to this one and can perhaps enhance its usefulness, but without which installing this package is perfectly reasonable.
pt: Lista pacotes que estão relacionados com este e podem talvez aumentar a sua utilidade, mas é perfeitamente razoável instalar este pacote sem eles.

note: type: textblock
en: The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> fields is a list of groups of alternative packages.  Each group is a list of packages separated by vertical bar (or “pipe”) symbols, ‘B<|>’.  The groups are separated by commas.  Commas are to be read as “AND”, and pipes as “OR”, with pipes binding more tightly.  Each package name is optionally followed by an architecture qualifier appended after a colon ‘B<:>’, optionally followed by a version number specification in parentheses.
pt: A sintaxe dos campos B<Depends>, B<Pre-Depends>, B<Recommends> e B<Suggests> é uma lista de grupos de pacotes alternativos. Cada grupo é uma lista de pacotes separados por símbolos de barras verticais (ou “pipe”) ‘B<|>’. Os grupos são separados por vírgulas, As vírgulas devem ser lidas como "E", e os pipes como "OU", com os pipes a vincular com mais firmeza. Cada nome de pacote é opcionalmente seguido por um qualificador de arquitectura anexado após dois pontos ‘B<:>’, opcionalmente seguido por uma especificação de número de versão em parêntesis.

note: type: textblock
en: An architecture qualifier name can be a real Debian architecture name (since dpkg 1.16.5) or B<any> (since dpkg 1.16.2).  If omitted, the default is the current binary package architecture.  A real Debian architecture name will match exactly that architecture for that package name, B<any> will match any architecture for that package name if the package has been marked as B<Multi-Arch: allowed>.
pt: Um nome qualificador de arquitectura pode ser um nome de arquitectura Debian real (desde dpkg 1.16.5) ou B<any> (desde dpkg 1.16.2). Se omitido, a predefinição é a arquitectura do pacote binário actual. Um nome de arquitectura Debian real irá corresponder exactamente à arquitectura para o nome do pacote. B<any> irá corresponder a qualquer arquitectura para esse nome de pacote. se o pacote foi marcado como B<Multi-Arch: allowed>.

note: type: textblock
en: A version number may start with a ‘B<E<gt>E<gt>>’, in which case any later version will match, and may specify or omit the Debian packaging revision (separated by a hyphen).  Accepted version relationships are ‘B<E<gt>E<gt>>’ for greater than, ‘B<E<lt>E<lt>>’ for less than, ‘B<E<gt>=>’ for greater than or equal to, ‘B<E<lt>=>’ for less than or equal to, and ‘B<=>’ for equal to.
pt: Um número de versão pode começar com um ‘B<E<gt>E<gt>>’, nesse caso qualquer versão posterior irá corresponder, e pode especificar ou omitir a revisão de empacotamento Debian (separada por um hífen). Relacionamentos de versão aceites são ‘B<E<gt>E<gt>>’ para maior que, ‘B<E<lt>E<lt>>’ para menor que, ‘B<E<gt>=>’ para maior ou igual a, ‘B<E<lt>=>’ para menor ou igual a, e ‘B<=>’ para igual a.

note: type: textblock
en: Lists packages that this one breaks, for example by exposing bugs when the named packages rely on this one.  The package maintenance software will not allow broken packages to be configured; generally the resolution is to upgrade the packages named in a B<Breaks> field.
pt: Lista os pacotes que este quebra, por exemplo ao expor bugs quando os pacotes nomeados precisam deste. O software de manutenção de pacotes não irá permitir que pacotes quebrados sejam configurados; geralmente a resolução é actualizar os pacotes nomeados no campo B<Breaks>.

note: type: textblock
en: Lists packages that conflict with this one, for example by containing files with the same names.  The package maintenance software will not allow conflicting packages to be installed at the same time.  Two conflicting packages should each include a B<Conflicts> line mentioning the other.
pt: Lista os pacotes que entram em conflito com este, por exemplo por conter ficheiros com os mesmos nomes. O software de manutenção de pacotes não irá permitir que pacotes em conflito sejam instalados ao mesmo tempo. Dois pacotes em conflito deverão ambos incluir uma linha B<Conflicts> mencionando o outro.

note: type: textblock
en: List of packages files from which this one replaces.  This is used for allowing this package to overwrite the files of another package and is usually used with the B<Conflicts> field to force removal of the other package, if this one also has the same files as the conflicted package.
pt: Lista os pacotes que este substitui. Isto é usado para permitir que este pacote sobrescreva os ficheiros de outro pacote e é geralmente usado com o campo B<Conflicts> para forçar a remoção do outro pacote. caso este tenha os mesmos ficheiros que o pacote em conflito.

note: type: textblock
en: The syntax of B<Breaks>, B<Conflicts> and B<Replaces> is a list of package names, separated by commas (and optional whitespace).  In the B<Breaks> and B<Conflicts> fields, the comma should be read as “OR”.  An optional architecture qualifier can also be appended to the package name with the same syntax as above, but the default is B<any> instead of the binary package architecture.  An optional version can also be given with the same syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields.
pt: A sintaxe de B<Breaks>, B<Conflicts> e B<Replaces> é uma lista de nomes de pacotes, separados por vírgulas (e opcionalmente por espaços em branco). Nos campos B<Breaks> e B<Conflicts>, a vírgula deve ler-se como "OU". Um qualificador opcional de arquitectura pode também ser anexado ao nome do pacote com a mesma sintaxe de em cima, mas a predefinição é B<any> em vez da arquitectura de pacote binário. Pode também ser fornecida uma versão opcional com a mesma sintaxe como em cima para os campos B<Breaks>, B<Conflicts> e B<Replaces>.

note: type: textblock
en: This is a list of packages that this one enhances.  It is similar to B<Suggests> but in the opposite direction.
pt: Isto é uma lista de pacotes que este melhora. É semelhante a B<Suggests> mas na direcção oposta.

note: type: textblock
en: This is a list of virtual packages that this one provides.  Usually this is used in the case of several packages all providing the same service.  For example, sendmail and exim can serve as a mail server, so they provide a common package (“mail-transport-agent”) on which other packages can depend.  This will allow sendmail or exim to serve as a valid option to satisfy the dependency.  This prevents the packages that depend on a mail server from having to know the package names for all of them, and using ‘B<|>’ to separate the list.
pt: Isto é uma lista de pacotes virtuais que este fornece. Geralmente sito é usado no caso de vários pacotes todos fornecerem o mesmo serviço. Por exemplo, sendmail e exim podem servir como servidor de mail, assim eles fornecem um pacote comum (“mail-transport-agent”) sobre o qual outros pacotes podem depender. Isto vai permitir ao sendmail ou ao exim servir como opção válida para satisfazer a dependência. Isto previne que os pacotes que dependem de um servidor de mail tenham que saber os nomes de pacotes de todos eles, e usar ‘B<|>’ para separar a lista.

note: type: textblock
en: The syntax of B<Provides> is a list of package names, separated by commas (and optional whitespace).  An optional architecture qualifier can also be appended to the package name with the same syntax as above.  If omitted, the default is the current binary package architecture.  An optional exact (equal to) version can also be given with the same syntax as above (honored since dpkg 1.17.11).
pt: A sintaxe de B<Provides> é uma lista de nomes de pacotes, separados por vírgulas (e opcionalmente por espaços em branco). Um qualificador opcional de arquitectura pode também ser anexado ao nome do pacote com a mesma sintaxe de em cima. Se omitido, a predefinição é a arquitectura do pacote binário actual. Uma versão exacta (igual a) opcional pode também ser dada com a mesma sintaxe de em cima (honrado desde dpkg 1.17.11).

note: type: textblock
en: This dependency field lists extra source packages that were used during the build of this binary package, for license compliance purposes.  This is an indication to the archive maintenance software that these extra source packages must be kept whilst this binary package is maintained.  This field must be a comma-separated list of source package names with strict ‘B<=>’ version relationships enclosed within parenthesis.  Note that the archive maintenance software is likely to refuse to accept an upload which declares a B<Built-Using> relationship which cannot be satisfied within the archive.
pt: Este campo de dependência lista pacotes fonte extra que foram usados durante a compilação deste pacote binário, com o objectivo de respeitar licenças. Isto é uma indicação para o software de manutenção do arquivo que estes pacotes fonte extra têm de ser mantidos enquanto este pacote biblioteca for mantido. Este campo tem de ser uma lista de nomes de pacotes fonte separados por vírgulas com relacionamentos de versão estritos ‘B<=>’ fechados dentro de parênteses. Note que é provável que o software de manutenção do arquivo se recuse a aceitar um envio que declare uma relação B<Built-Using> que não possa ser satisfeita dentro do arquivo.

note: type: textblock
en: This dependency field lists extra source packages that were used during the build of this binary package, for static building purposes (for example linking against static libraries, builds for source-centered languages such as Go or Rust, usage of header-only C/C++ libraries, injecting data blobs into code, etc.).  This is useful to track whether this package might need to be rebuilt when source packages listed here have been updated, for example due to security updates.  This field must be a comma-separated list of source package names with strict ‘B<=>’ version relationships enclosed within parenthesis.
pt: Este campo de dependência lista pacotes fonte extra que foram usados durante a compilação deste pacote binário, para objectivos de compilação estática (por exemplo vincular contra bibliotecas estáticas. compilações para linguagens centradas-na-fonte tais como Go ou Rust, utilização de bibliotecas C/C++ apenas-cabeçalho, injectar bolhas de dados em código, etc.).  Isto é útil para seguir se este pacote pode precisar de ser recompilado quando os pacotes fonte listados aqui forem actualizados, por exemplo devido a actualizações de segurança. Este campo tem de ser uma lista separada por vírgulas de nomes de pacotes fonte com relacionamentos estritos de versão ‘B<=>’ fechados dentro de parênteses.

note: type: textblock
en: Supported since dpkg 1.21.3.
pt: Suportado desde dpkg 1.21.3.

note: type: =item
en: B<Built-For-Profiles:> I<profile-list> (obsolete)
pt: B<Built-For-Profiles:> I<profile-list> (obsoleto)

note: type: textblock
en: This field used to specify a whitespace separated list of build profiles that this binary packages was built with (since dpkg 1.17.2 until 1.18.18).  The information previously found in this field can now be found in the B<.buildinfo> file, which supersedes it.
pt: Este campo era usado para especificar uma lista de perfis de compilação separados por espaços com que este pacote binário foi compilado com (desde dpkg 1.17.2 até 1.18.18). A informação antes encontrada neste campo pode agora ser encontrada no ficheiro B<.buildinfo>, que o suplanta.

note: type: textblock
en: This field specifies a whitespace separated list of reasons why this package was auto-generated.  Binary packages marked with this field will not appear in the I<debian/control> template source control file.  The only currently used reason is B<debug-symbols>.
pt: Esta campo especifica uma lista de razões separadas por espaços de porquê este pacote foi auto-gerado. OS pacotes binários marcados com este campo não irão aparecer no ficheiro de controle fonte modelo I<debian/control>. A única razão usada actualmente é B<debug-symbols>.

note: type: textblock
en: This field specifies a whitespace separated list of ELF build-ids.  These are unique identifiers for semantically identical ELF objects, for each of these within the package.
pt: Este campo especifica uma lista de ids de compilação de ELF separados por espaços. Estes são identificadores únicos para objetos ELF semanticamente idênticos, para cada um destes dentro do pacote.

note: type: textblock
en: The format or the way to compute each build-id is not defined by design.
pt: O formato ou o modo de computar cada build-id não é definido pelo desenho.

note: type: textblock
en: The B<Build-Ids> field uses a rather generic name out of its original context within an ELF object, which serves a very specific purpose and executable format.
pt: O campo B<Build-Ids> usa um nome um pouco genérico fora do seu contexto original dentro de um objeto ELF, o que serve um objectivo muito específico e formato executável.

note: type: textblock
en: deb-extra-override - Debian archive extra override file
pt: deb-extra-override - ficheiro de sobreposição extra de arquivo Debian

note: type: textblock
en: While most information about a binary/source package can be found in the control/.dsc file, all of it can be overridden when it's exported to Packages/Sources files.  The extra override file contains those overrides.
pt: Enquanto a maioria da informação acerca de um pacote binário/fonte pode ser encontrada no ficheiro control/.dsc, toda ela pode ser sobreposta quando ele é exportado para ficheiros Packages/Sources. O ficheiro override extra contém essas sobreposições.

note: type: textblock
en: The extra override file has a simple whitespace-delimited format.  Comments are allowed (denoted with a B<#>).
pt: O ficheiro override extra tem um formato simples de delimitação por espaços em branco. São permitidos comentários (denotados com um B<#>).

note: type: textblock
en: I<package> is the name of the binary/source package.
pt: I<package> é o nome do pacote binário/fonte.

note: type: textblock
en: I<field-name> is the name of the field that is overridden.
pt: I<field-name> é o nome do campo que é sobreposto.

note: type: textblock
en: I<value> is the value to put in the field.  It can contain spaces as the line is split in no more than 3 columns when it's parsed.
pt: I<value> é o valor a colocar no campo. Pode conter espaços pois pois a linha é dividida em não mais do que 3 colunas quando é analisada.

note: type: textblock
en: The extra override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
pt: Os ficheiros de extra sobreposição usados para criar as listas Packages oficiais pode ser encontrados no directório I<indices> em qualquer mirror de Debian.

note: type: textblock
en: deb-md5sums - package MD5 file digests
pt: deb-md5sums - resumos de ficheiros MD5 de pacote

note: type: textblock
en: A package declares the MD5 digests for the package file contents by including an I<md5sums> file in its control archive (i.e. I<DEBIAN/md5sums> during package creation).  This file is used for integrity verification and deduplication purposes, and not for any kind of security purpose.
pt: Um pacote declara os resumos MD5 para o conteúdo do ficheiro pacote ao incluir um ficheiro I<md5sums> no seu arquivo de controlo (isto é, I<DEBIAN/md5sums> durante a criação do pacote). Este ficheiro é usado para verificação de integridade e objectivos de de-duplicação, e não para nenhum tipo de objectivo de segurança.

note: type: textblock
en: This file contains a list of MD5 digests (as 32 case-insensitive hexadecimal characters) followed by two spaces (U+0020 B<SPACE>) and the absolute pathname of a plain file, one per line.
pt: Este ficheiro contém uma lista de resumos MD5 (como 32 caracteres hexadecimais sensíveis a minúsculas/maiúsculas) seguido de dois espaços (U+0020 B<SPACE>) e o caminho absoluto dum ficheiro simples, um por cada linha.

note: type: textblock
en: Trailing slashes (U+002F B</>) in the pathname will be trimmed.  Neither trailing whitespace nor empty or whitespace-only lines are accepted.
pt: As barras finais (U+002F B</>) no nome de caminho são cortadas. Não são aceites linhas nem que acabem em espaço em branco, nem vazias, nem com apenas espaços em branco.

note: type: textblock
en: If the control file does not exist in the binary package, L<dpkg(1)> will generate the matching information at unpack time (since B<dpkg> 1.16.3).
pt: Se o ficheiro de controle não existir no pacote binário, o L<dpkg(1)> irá gerar a informação correspondente durante o desempacotar (desde B<dpkg> 1.16.3).

note: type: textblock
en: deb-old - old style Debian binary package format
pt: deb-old - formato Debian de pacote binário do estilo antigo

note: type: textblock
en: The B<.deb> format is the Debian binary package file format.  This manual page describes the B<old> format, used before Debian 0.93.  Please see L<deb(5)> for details of the new format.
pt: O formato B<.deb> é o formato de ficheiro de pacote binário Debian. Este manual descreve o formato B<antigo>, usando antes de Debian 0.93. Por favor veja L<deb(5)> para detalhes sobre o novo formato.

note: type: =head1
en: FORMAT
pt: FORMATO

note: type: textblock
en: The file is two lines of format information as ASCII text, followed by two concatenated gzipped ustar files.
pt: O ficheiro é duas linhas de informação de formato em texto ASCII, seguido de dois ficheiros ustar gzipados concatenados.

note: type: textblock
en: The first line is the format version number padded to 8 digits, and is B<0.939000> for all old-format archives.
pt: A primeira linha é o número de versão de formato acolchoado para 8 dígitos, e é B<0.939000> para todos os arquivos de formato antigo.

note: type: textblock
en: The second line is a decimal string (without leading zeroes) giving the length of the first gzipped tarfile.
pt: A segunda linha é uma string decimal (sem zeros à esquerda) fornecendo o comprimento do primeiro ficheiro tar gzipado.

note: type: textblock
en: Each of these lines is terminated with a single newline character.
pt: Cada uma destas linhas é terminada com um único caractere de nova-linha.

note: type: textblock
en: The first tarfile contains the control information, as a series of ordinary files.  The file B<control> must be present, as it contains the core control information.
pt: O primeiro ficheiro tar contem a informação de controlo, numa série de ficheiros normais. O ficheiro B<control> tem de estar presente, pois ele contem o núcleo da informação de controle.

note: type: textblock
en: In some very old archives, the files in the control tarfile may optionally be in a B<DEBIAN> subdirectory.  In that case, the B<DEBIAN> subdirectory will be in the control tarfile too, and the control tarfile will have only files in that directory.  Optionally the control tarfile may contain an entry for ‘B<.>’, that is, the current directory.
pt: Em alguns arquivos muito antigos, os ficheiros no ficheiro tar de controlo podem opcionalmente estar num sub-directório B<DEBIAN>. Nesse caso o sub-directório B<DEBIAN> irá estar também no ficheiro tar de controlo, e o ficheiro tar de controlo terá apenas ficheiros nesse directório. Opcionalmente o ficheiro tar de controlo pode conter uma entrada para ‘B<.>’, que é, o directório actual.

note: type: textblock
en: The second gzipped tarfile is the filesystem archive, containing pathnames relative to the root directory of the system to be installed on.  The pathnames do not have leading slashes.
pt: O segundo ficheiro tar gzipado é o arquivo do sistema de ficheiros, contendo nomes de caminhos relativos ao directório raiz do sistema onde vão ser instalados. OS nomes de caminhos não têm barras iniciais.

note: type: textblock
en: deb-origin - Vendor-specific information files
pt: deb-origin - Ficheiros de informação específicos do fornecedor

note: type: textblock
en: The files in B<%PKGCONFDIR%/origins> can provide information about various vendors who are providing Debian packages.
pt: Os ficheiros em B<%PKGCONFDIR%/origins> podem fornecer informação acerca de vários fornecedores que estão a disponibilizar pacotes Debian.

note: type: textblock
en: They contain a number of fields, or comments when the line starts with ‘B<#>’.  Each field begins with a tag, such as B<Vendor> or B<Parent>, followed by a colon and the body of the field.  Fields are delimited only by field tags.  In other words, field text may be multiple lines in length, but the tools will join lines when processing the body of the field.
pt: Eles contêm um número de campos, ou comentários quando a linha começa com ‘B<#>’. Cada campo começa com uma etiqueta, tal como B<Vendor> ou B<Parent>, seguida de dois pontos e o corpo do campo. Os campos são delimitados apenas por etiquetas de campos. Por outras palavras, o texto de um campo pode ter várias linhas de comprimento. mas as ferramentas irão juntar as linhas quando processarem o corpo do campo.

note: type: textblock
en: The file should be named according to the vendor name.  The usual convention is to name the vendor file using the vendor name in all lowercase, but some variation is permitted.
pt: O ficheiro deve ser nomeado de acordo com o nome do fornecedor. A convenção usual é nomear o ficheiro vendor usando o nome do fornecedor todo em minúsculas, mas é permitida alguma variação.

note: type: textblock
en: Namely (since dpkg 1.21.10), first, non-alphanumeric characters (‘B<[^A-Za-z0-9]>’) are mapped to dashes (‘B<->’), then the resulting name will be tried in sequence by lower-casing it, keeping it as is, lower-casing then capitalizing it (that is upper-casing the first character), and only capitalizing it.
pt: Nomeadamente (desde dpkg 1.21.10), primeiro, os caracteres não-alfanuméricos (‘B<[^A-Za-z0-9]>’) são mapeados para traços (‘B<->’), depois o nome resultante irá ser testado em sequência ao pôr-lo em minúsculas, mantendo-o como está, minúsculas depois capitalizando-o (isto é maiúscula no primeiro caractere), e apenas capitalizando-o.

note: type: textblock
en: In addition, for historical and backwards compatibility, the name will be tried keeping it as is without non-alphanumeric characters remapping, then the resulting name will be tried in sequence by lower-casing it, keeping it as is, lower-casing then capitalizing it, and only capitalizing it.  And finally the name will be tried by remapping spaces to dashes (‘B<->’), then the resulting name will be tried in sequence by lower-casing it, keeping it as is, lower-casing then capitalizing it, and only capitalizing it.
pt: Adicionalmente, para histórico e compatibilidade com versões anteriores, O nome irá ser testado mantendo-o como está sem o re-mapeamento dos caracteres não-alfanuméricos, depois o nome resultante será testado em sequência ao converte-lo para minúsculas, mantendo-o com está, minúsculas e depois capitalizando-o.  E finalmente o nome será testado ao re-mapear espaços para traços (‘B<->’), depois o nome resultante será testado em sequência ao converte-lo para minúsculas, mantendo-o com está, minúsculas e depois capitalizando-o, e apenas capitalizando-o.

note: type: textblock
en: But these backwards compatible module lookups will be removed during the dpkg 1.22.x release cycle.
pt: Mas estas buscas de módulo de compatibilidade com versões anteriores serão removidas durante o ciclo de lançamento 1.22.x do dpkg.

note: type: =item
en: B<Vendor:> I<vendor-name> (required)
pt: B<Vendor:> I<vendor-name> (necessário)

note: type: textblock
en: The value of this field determines the vendor name.
pt: O valor deste campo determina o nome do fornecedor.

note: type: textblock
en: The value of this field determines the vendor URL.
pt: O valor deste campo determina o URL do fornecedor.

note: type: textblock
en: The value of this field determines the type and address of the bug tracking system used by this vendor.  It can be a mailto URL or a debbugs URL (e.g., debbugs://bugs.debian.org/).
pt: O valor deste campo determina o tipo e o endereço do sistema de acompanhamento de bugs usando pelo fornecedor. Pode ser um URL de mail ou um URL debbugs (ex. debbugs://bugs.debian.org/).

note: type: textblock
en: The value of this field determines the vendor name of the vendor that this vendor derives from.
pt: O valor deste campo determina o nome de fornecedor do fornecedor de onde este fornecedor deriva.

note: type: textblock
en: deb-override - Debian archive override file
pt: deb-override - ficheiro de sobreposição de arquivo Debian

note: type: textblock
en: While most information about a package can be found in the control file, some is managed centrally by the distribution czars rather than by the maintainer in order to offer some global consistency.  This information is found in the override file.
pt: Enquanto a maioria da informação acerca de uma pacote pode ser encontrada no ficheiro de controle, alguma é gerida centralmente pelos czars da distribuição em vez de pelo maintainer de modo a oferecer alguma consistência global. Esta informação encontra-se no ficheiro de sobreposição (override).

note: type: textblock
en: The override file has a simple whitespace-delimited format.  Comments are allowed (denoted with a B<#>).
pt: O ficheiro override tem um formato simples de delimitação por espaços em branco. São permitidos comentários (denotados com um B<#>).

note: type: textblock
en: I<package> is the name of the package.  Entries in the override file for packages not found in the tree of binary packages are ignored.
pt: I<package> é o nome do pacote. As entradas no ficheiro de sobreposição para pacotes não encontrados na árvore de pacotes binários são ignoradas.

note: type: textblock
en: I<priority> and I<section> correspond to the respective control fields available in the .deb.  The allowed values are specific to each distribution archive.
pt: I<priority> e I<section> correspondem a campos de controle respectivos disponíveis no .deb. Os valores permitidos são específicos para cada arquivo de distribuição.

note: type: textblock
en: I<maintainer-info>, if present, can be either the name of a maintainer for an unconditional override, or else I<old-maintainer> B<=E<gt>> I<new-maintainer> to perform a substitution.
pt: I<maintainer-info>, se presente, pode ser o nome de um responsável por uma sobreposição incondicional, ou então I<old-maintainer> B<=E<gt>> I<new-maintainer> para executar a substituição.

note: type: textblock
en: The override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
pt: Os ficheiros de sobreposição usados para criar as listas de Pacotes oficiais podem ser encontradas no directório I<indices> em qualquer mirror Debian.

note: type: textblock
en: deb-postinst - package post-installation maintainer script
pt: deb-postinst - script de maintainer pós-instalação do pacote

note: type: textblock
en: A package can perform several post-installation actions via maintainer scripts, by including an executable I<postinst> file in its control archive (i.e. I<DEBIAN/postinst> during package creation).
pt: Um pacote pode executar várias acções de pós-instalação via scripts do maintainer, ao incluir um ficheiro executável I<postinst> no seu arquivo de controle (isto é, I<DEBIAN/postinst>( durante a criação do pacote.

note: type: textblock
en: The script can be called in the following ways:
pt: O script pode ser chamado nos seguintes modos:

note: type: textblock
en: After the package was installed.
pt: Após o pacote ter sido instalado.

note: type: textblock
en: After the package was triggered.  The list of space-separated I<trigger-name>s is passed as the second argument.
pt: Após o pacote ser despoletado. A lista de I<trigger-name>s separados por espaços é passada como segundo argumento.

note: type: textblock
en: If I<prerm> fails during B<upgrade> or fails on B<failed-upgrade>.
pt: Se I<prerm> falhar durante B<upgrade> ou falhar num B<failed-upgrade>.

note: type: textblock
en: If I<prerm> fails during B<remove>.
pt: Se I<prerm> falhar durante B<remove>.

note: type: textblock
en: If I<prerm> fails during B<deconfigure in-favour> of a package.
pt: Se I<prerm> falhar durante B<deconfigure in-favour> de um pacote

note: type: textblock
en: If I<prerm> fails during B<remove in-favour> for replacement due to conflict.
pt: Se I<prerm> falhar durante B<remove in-favour> para substituição devido a conflito.

note: type: textblock
en: deb-postrm - package post-removal maintainer script
pt: deb-postrm - script de maintainer de pós-remoção do pacote

note: type: textblock
en: A package can perform several post-removal actions via maintainer scripts, by including an executable I<postrm> file in its control archive (i.e. I<DEBIAN/postrm> during package creation).
pt: Um pacote pode executar várias acções de pós-remoção via scripts de maintainer ao incluir um ficheiro executável I<postrm> no seu arquivo de controle (isto é, I<DEBIAN/postrm>) durante a criação do pacote.

note: type: textblock
en: After the package was removed.
pt: Após o pacote ter sido removido.

note: type: textblock
en: After the package was purged.
pt: Após o pacote ser purgado.

note: type: textblock
en: After the package was upgraded.
pt: Após o pacote ser actualizado.

note: type: textblock
en: If the above B<upgrade> call fails.
pt: Se a chamada B<upgrade> em cima falhar.

note: type: textblock
en: The I<new-version> is passed only since dpkg 1.18.5.
pt: A I<new-version> é passada apenas desde o dpkg 1.18.5.

note: type: textblock
en: After all of the packages files have been replaced.
pt: Após todos os ficheiros pacotes terem sido substituídos.

note: type: textblock
en: If I<preinst> fails during B<install>.
pt: Se I<preinst> falhar durante B<install>.

note: type: textblock
en: If I<preinst> fails during B<install> for an upgrade of a removed package.
pt: Se I<preinst> falhar durante B<install> para a actualização de um pacote removido.

note: type: textblock
en: If I<preinst> fails during B<upgrade>.
pt: Se I<preinst> falhar durante B<upgrade>.

note: type: textblock
en: deb-preinst - package pre-installation maintainer script
pt: deb-preinst - script de maintainer de pré-instalação do pacote

note: type: textblock
en: A package can perform several pre-installation actions via maintainer scripts, by including an executable I<preinst> file in its control archive (i.e. I<DEBIAN/preinst> during package creation).
pt: Um pacote pode executar várias acções de pré-instalação via scripts do maintainer, ao incluir um ficheiro executável I<preinst> no seu arquivo de controle (isto é, I<DEBIAN/preinst>( durante a criação do pacote.

note: type: textblock
en: Before the package is installed.
pt: Antes do pacote ser instalado.

note: type: textblock
en: Before a removed package is upgraded.
pt: Antes de um pacote removido ser actualizado.

note: type: textblock
en: Before the package is upgraded.
pt: Antes do pacote ser actualizado.

note: type: textblock
en: If I<postrm> fails during upgrade or fails on failed upgrade.
pt: Se I<postrm> falhar durante actualização ou falhar numa actualização falhada.

note: type: textblock
en: deb-prerm - package pre-removal maintainer script
pt: deb-prerm - script de maintainer de pré-remoção do pacote

note: type: textblock
en: A package can perform several pre-removal actions via maintainer scripts, by including an executable I<prerm> file in its control archive (i.e. I<DEBIAN/prerm> during package creation).
pt: Um pacote pode executar várias acções de pré-remoção via scripts de maintainer ao incluir um ficheiro executável I<prerm> no seu arquivo de controle (isto é, I<DEBIAN/prerm>) durante a criação do pacote.

note: type: textblock
en: Before the package is removed.
pt: Antes do pacote ser removido.

note: type: textblock
en: Before an upgrade.
pt: Antes de uma actualização.

note: type: textblock
en: If the above B<upgrade> fails.
pt: Se o B<upgrade> em cima falhar.

note: type: textblock
en: Before package is deconfigured while dependency is replaced due to conflict.
pt: Antes do pacote ser desconfigurado enquanto a dependência é substituída devido a conflito.

note: type: textblock
en: Before the package is replaced due to conflict.
pt: Antes do pacote ser substituído devido a conflito.

note: type: textblock
en: deb-shlibs - Debian shared library information file
pt: deb-shlibs - ficheiro de informação de biblioteca partilhada de Debian

note: type: textblock
en: B<shlibs> files map shared library names and versions (I<SONAMEs>)  to dependencies suitable for a package control file.  There is one entry per line.  Blank lines are B<not> allowed.  Lines beginning with a B<#> character are considered commentary, and are ignored.  All other lines must have the format:
pt: Ficheiros B<shlibs> mapeiam nomes de bibliotecas partilhadas e versões (I<SONAMEs>) para dependências apropriados para um ficheiro de controle de pacote. Existe uma entrada por linha. Linhas vazias B<não> são permitidas. Linha começadas com um caractere B<#> são consideradas comentários, e são ignoradas. Todas as outras linhas têm de ter o formato

note: type: textblock
en: The I<library> and I<version> fields are whitespace-delimited, but the I<dependencies> field extends to the end of the line.  The I<type> field is optional and normally not needed.
pt: Os campos I<library> e I<version> são delimitados por espaços em branco, mas o campo I<dependencies> estende-se até ao fim da linha. O campo I<type> é opcional e normalmente não necessário.

note: type: textblock
en: The I<dependencies> field has the same syntax as the B<Depends> field in a binary control file, see L<deb-control(5)>.
pt: O campo I<dependencies> tem a mesma sintaxe que o campo B<Depends> num ficheiro de control binário, veja L<deb-control(5)>.

note: type: =head1
en: SONAME FORMATS
pt: FORMATOS DE SONAME

note: type: textblock
en: The SONAME formats supported are:
pt: Os formatos SONAME suportados são:

note: type: textblock
en: and
pt: e

note: type: textblock
en: where I<name> is usually prefixed by B<lib>.
pt: onde I<name> é geralmente prefixado por B<lib>.

note: type: textblock
en: The former tends to be used by shared libraries with stable interfaces.  The latter by shared libraries with unstable interfaces, where the whole version becomes part of the SONAME and needs to be specified in full when linking against those libraries.
pt: O anterior tem tendência a ser usado por bibliotecas partilhadas com interfaces estáveis. O posterior por bibliotecas partilhadas com interfaces instáveis, onde a versão completa torna-se parte do SONAME e precisa de ser especificada na totalidade quando se vincula contra essas bibliotecas.

note: type: textblock
en: The B<shlibs> file for a typical library package, named I<libcrunch1>, that provides one library whose SONAME is I<libcrunch.so.1>, might read
pt: O ficheiro B<shlibs> para um pacote biblioteca típico, chamado I<libcrunch1>, que disponibiliza uma biblioteca cujo SONAME é I<libcrunch.so.1>, poderá ler-se

note: type: textblock
en: The I<dependencies> must mention the most recent version of the package that added new symbols to the library: in the above example, new symbols were added to version 1.2 of I<libcrunch>.  This is not the only reason the dependencies might need to be tightened.
pt: O I<dependencies> tem de mencionar a versão mais recente do pacote que adicionou novos símbolos à biblioteca: no exemplo em cima, foram adicionados novos símbolos à versão 1.2 de I<libcrunch>. Esta não é a única razão para que as dependências possam precisar de ser apertadas.

note: type: textblock
en: deb-split - Debian multi-part binary package format
pt: deb-split - formato Debian de pacotes binários de múltiplas partes

note: type: textblock
en: The multi-part B<.deb> format is used to split big packages into smaller pieces to ease transport in small media.
pt: É usado o formato B<.deb> multi-parte para dividir pacotes grandes em peças menores para facilitam o transporte em meios pequenos.

note: type: textblock
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  The file names might contain a trailing slash (since dpkg 1.15.6).
pt: O ficheiro é um arquivo B<ar> com um valor mágico de B<!E<lt>archE<gt>>. Os nomes dos ficheiros podem conter uma barra à direita (desde o dpkg 1.15.6).

note: type: textblock
en: The first member is named B<debian-split> and contains a series of lines, separated by newlines.  Currently eight lines are present:
pt: O primeiro membro é chamado  B<debian-split> e contém uma série de linhas, separadas por caracteres de nova-linha. Actualmente estão presentes oito linhas:

note: type: textblock
en: The format version number, B<2.1> at the time this manual page was written.
pt: O número de versão de formato, B<2.1> na altura em que este manual foi escrito.

note: type: textblock
en: The package name.
pt: O nome do pacote.

note: type: textblock
en: The package version.
pt: A versão do pacote.

note: type: textblock
en: The md5sum of the package.
pt: O md5sum do pacote.

note: type: textblock
en: The total size of the package.
pt: O tamanho total do pacote.

note: type: textblock
en: The maximum part size.
pt: O tamanho máximo de parte.

note: type: textblock
en: The current part number, followed by a slash and the total amount of parts (as in ‘1/10’).
pt: O numero de parte actual, seguido de uma barra e a quantidade total de partes (como em‘1/10’).

note: type: textblock
en: The package architecture (since dpkg 1.16.1).
pt: A arquitectura do pacote (desde dpkg 1.16.1).

note: type: textblock
en: Programs which read multi-part archives should be prepared for the minor format version number to be increased and additional lines to be present, and should ignore these if this is the case.
pt: Os programas que leem arquivos de múltiplas-partes devem estar preparados para que o menor número de versão de formato seja aumentado e que estejam presentes linhas adicionais, e devem ignorar estes se tal for o caso.

note: type: textblock
en: If the major format version number has changed, an incompatible change has been made and the program should stop.  If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
pt: Se o maior número de versão de formato tiver alterado, foi criada uma mudança incompatível e o programa deverá parar, se não o fizer, então o programa deverá ser capaz de continuar em segurança, a menos que encontre um membro inesperado no arquivo (excepto no final), como descrito abaixo.

note: type: textblock
en: The second, last required member is named B<data.>I<N>, where I<N> denotes the part number.  It contains the raw part data.
pt: O segundo, último membro requerido é chamado B<data.>I<N>, onde I<N> denota o número de parte. Contém a parte crua dos dados.

note: type: textblock
en: These members must occur in this exact order.  Current implementations should ignore any additional members after B<data.>I<N>.  Further members may be defined in the future, and (if possible) will be placed after these two.
pt: Estes membros têm de ocorrer nesta ordem exacta. As implementações actuais deverão ignorar quaisquer membros adicionais após B<data.>I<N>. Podem ser definidos mais membros no futuro, e (se possível) serão colocados após estes dois.

note: type: textblock
en: deb-src-control - Debian source package template control file format
pt: deb-src-control - formato Debian de ficheiro de controle modelo de pacote fonte

note: type: textblock
en: Each Debian source package contains the «B<debian/control>» template source control file, and its L<deb822(5)> format is a superset of the B<control> file shipped in Debian binary packages, see L<deb-control(5)>.
pt: Cada pacote fonte Debian contem o ficheiro modelo de controle de fonte «B<debian/control>», e o seu formato L<deb822(5)> é um superconjunto do ficheiro B<control> enviado em pacotes binários Debian, veja L<deb-control(5)>.

note: type: textblock
en: This file contains at least 2 stanzas, separated by a blank line.  The first stanza is called the source package stanza and lists all information about the source package in general, while each following stanzas are called the binary package stanzas and describe exactly one binary package per stanza.  Each stanza consists of at least one field.  A field starts with a field name, such as B<Package> or B<Section> (case insensitive), followed by a colon, the body of the field (case sensitive unless stated otherwise) and a newline.  Multi-line fields are also allowed, but each supplementary line, without a field name, should start with at least one space.  The content of the multi-line fields is generally joined to a single line by the tools (except in the case of the B<Description> field, see below).  To insert empty lines into a multi-line field, insert a dot after the space.  Lines starting with a ‘B<#>’ are treated as comments.
pt: Este ficheiro contem pelo menos 2 estrofes, separadas por uma linha vazia. A primeira estrofe é chamada a estrofe do pacote fonte e lista toda a informação acerca do pacote fonte em geral, enquanto cada uma das estrofe seguintes são chamadas estrofes de pacote binário e descrevem exactamente um pacote binário por cada estrofe. Cada estrofe consiste de pelo menos um campo. Um campo começa com um nome de campo, tal como B<Package> ou B<Section> (insensível a maiúsculas/minúsculas), seguido de dois pontos, o corpo do campo (sensível a maiúsculas/minúsculas a menos que declarado o contrário) e uma mudança de linha. São também permitirmos campos multi-linha, mas cada linha suplementar, sem um nome de campo, deve começar com pelo menos um espaço em branco. O conteúdo dos campos multi-linha é geralmente juntado numa única pelas ferramentas (excepto no caso do campo B<Description>, ver abaixo). Para inserir linhas vazias num campo de multi-linha, insira um ponto após o espaço. As linhas começadas com ‘B<#>’ são tratadas como comentários.

note: type: =head1
en: SOURCE FIELDS
pt: CAMPOS DE FONTE

note: type: =item
en: B<Source:> I<source-package-name> (required)
pt: B<Source:> I<source-package-name> (necessário)

note: type: textblock
en: The value of this field is the name of the source package, and should match the name of the source package in the debian/changelog file.  A package name must consist only of lowercase letters (a-z), digits (0-9), plus (+) and minus (-) signs, and periods (.).  Package names must be at least two characters long and must start with a lowercase alphanumeric character (a-z0-9).
pt: O valor deste campo é o nome do pacote fonte, e deve corresponder ao nome do pacote fonte no ficheiro debian/changelog. O nome de um pacote deve consistir apenas de letras minúsculas (a-z), dígitos (0-9), e dos sinais mais (+) e menos (-) e de pontos (.). Os nomes dos pacotes devem ter pelo menos dois caracteres de comprimento e têm de começar com um caractere alfanumérico minúsculo (a-z0-9).

note: type: textblock
en: Should be in the format «Joe Bloggs E<lt>jbloggs@foo.comE<gt>», and references the person who currently maintains the package, as opposed to the author of the software or the original packager.
pt: Deverá estar no formato «Joe Bloggs E<lt>jbloggs@foo.comE<gt>», e refere-se à pessoa que mantém actualmente o pacote, e não o autor do software nem ao empacotador original.

note: type: textblock
en: Lists all the names and email addresses of co-maintainers of the package, in the same format as the B<Maintainer> field.  Multiple co-maintainers should be separated by a comma.
pt: Lista todos os nomes e endereços de email de co-maintainers do pacote, no mesmo formato que o campo Maintainer. Vários co-maintainers devem ser separados por uma vírgula.

note: type: textblock
en: This documents the most recent version of the distribution policy standards this package complies with.
pt: Isto documenta a versão mais recente dos standards de política da distribuição com que este pacote está em conformidade.

note: type: textblock
en: The format for the source package description is a short brief summary on the first line (after the B<Description> field).  The following lines should be used as a longer, more detailed description.  Each line of the long description must be preceded by a space, and blank lines in the long description must contain a single ‘B<.>’ following the preceding space.
pt: O formato da descrição do pacote fonte é um sumário breve e curto na primeira linha (após o campo B<Description>). As linhas seguintes devem ser usadas para uma descrição longa e mais detalhada. Cada linha da descrição longa tem de ser precedida com um espaço, e as linhas em branco na descrição longa têm de conter um único ‘B<.>’  a seguir ao espaço que precede.

note: type: textblock
en: The upstream project home page URL.
pt: O URL da página inicial do projecto do autor original

note: type: textblock
en: The I<url> of the bug tracking system for this package.  The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>.  This field is usually not needed.
pt: O I<url> do sistema de acompanhamento de bugs deste pacote. O formato usado actualmente é I<bts-type>B<://>I<bts-address>, como B<debbugs://bugs.debian.org>. Este campo geralmente não é necessário.

note: type: textblock
en: This field is used to indicate whether the B<debian/rules> file requires (fake)root privileges to run some of its targets, and if so when.
pt: Este campo é usado para indicar se o campo B<debian/rules> requer privilégios de (fake)root para correr alguns dos seus alvos, e se sim quando.

note: type: textblock
en: The binary targets will not require (fake)root at all.  This is the default in B<dpkg-build-api> level >= 1.
pt: Os alvos binários não irão requerer (fake)root de todo. Esta é a predefinição em B<dpkg-build-api> nível >= 1.

note: type: textblock
en: The binary targets must always be run under (fake)root.  This value is the default in B<dpkg-build-api> level 0, when the field is omitted; adding the field with an explicit B<binary-targets>, while not strictly needed, marks it as having been analyzed for this requirement.
pt: Os alvos binários devem ser sempre corridos sob (fake)root. Este é a predefinição em B<dpkg-build-api> nível 0, quando o campo é omitido, adicionar o campo com um B<binary-targets> explícito quando não estritamente necessário, marca-o como tendo sido analisada para este requerimento.

note: type: textblock
en: This is a space-separated list of keywords which define when (fake)root is required.
pt: Isto é uma lista de palavras-chave separadas por espaços que define quando (fake)root é requerido.

note: type: textblock
en: Keywords consist of I<namespace>/I<cases>.  The I<namespace> part cannot contain "/" or whitespace.  The I<cases> part cannot contain whitespace.  Furthermore, both parts must consist entirely of printable ASCII characters.
pt: Palavras chave consistem de I<namespace>/I<cases>.  A parte I<namespace> não pode conter "/" ou espaços em branco. A parte I<cases> não pode conter espaços em branco. Mais ainda, ambas partes têm de consistir inteiramente de caracteres ASCII de escrita.

note: type: textblock
en: Each tool/package will define a namespace named after itself and provide a number of cases where (fake)root is required.  (See "Implementation provided keywords" in I<rootless-builds.txt>).
pt: Cada ferramenta/pacote irá definir um espaço-nome com o nome dela própria e disponibilizar um número de casos onde (fake)root é necessário. (Veja "Implementação de palavras-chave fornecidas" em I<rootless-builds.txt>).

note: type: textblock
en: When the field is set to one of the I<impl-keywords>, the builder will expose an interface that is used to run a command under (fake)root.  (See "Gain Root API" in I<rootless-builds.txt>.)
pt: Quando o campo está definido para uma das I<impl-keywords>, o compilador irá expor uma interface que é usada para correr um comando sob (fake)root. (Veja "Gain Root API" em I<rootless-builds.txt>.)

note: type: textblock
en: These fields are described in the L<dsc(5)> manual page, as they are generated from information inferred from B<debian/tests/control> or copied literally to the source control file.
pt: Estes campos estão descritos no manual do L<dsc(5)>, pois eles são gerados a partir de informação inferida de B<debian/tests/control> ou copiada literalmente para o ficheiro de controle da fonte.

note: type: textblock
en: The I<url> of the Version Control System repository used to maintain this package.  Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> (Subversion).  Usually this field points to the latest version of the package, such as the main branch or the trunk.
pt: O I<url> do repositório do Sistema de Controlo de Versão usando para manter este pacote. Actualmente suportados são B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) e B<Svn> (Subversion). Geralmente esta campo aponta par aa versão mais recente do pacote, tal como o ramal principal ou o "trunk".

note: type: textblock
en: The I<url> of a web interface to browse the Version Control System repository.
pt: O I<url> da uma interface web para explorar o repositório do Sistema de Controlo de Versão.

note: type: textblock
en: The name of the distribution this package is originating from.  This field is usually not needed.
pt: O nome da distribuição de onde este pacote é originário. Normalmente este campo não é necessário.

note: type: textblock
en: A list of packages that need to be installed and configured to be able to build from source package.  These dependencies need to be satisfied when building binary architecture dependent or independent packages and source packages.  Including a dependency in this field does not have the exact same effect as including it in both B<Build-Depends-Arch> and B<Build-Depends-Indep>, because the dependency also needs to be satisfied when building the source package.
pt: Uma lista de pacotes que precisam de estar instalados e configurados para ser possível compilar a partir do pacote fonte. Estas dependências precisam de estar satisfeitas quando se compila pacotes binários dependentes ou independentes da arquitectura e pacotes fonte. Incluir uma dependência neste campo não tem o mesmo efeito exacto que a incluir em ambos B<Build-Depends-Arch> e B<Build-Depends-Indep>, porque a dependência também precisa de satisfeita quando se compila o pacote fonte.

note: type: textblock
en: Same as B<Build-Depends>, but they are only needed when building the architecture dependent packages.  The B<Build-Depends> are also installed in this case.  This field is supported since dpkg 1.16.4; in order to build with older dpkg versions, B<Build-Depends> should be used instead.
pt: O mesmo que B<Build-Depends>, mas são apenas necessárias quando se compila os pacotes dependentes da arquitectura. Os B<Build-Depends> são também instalados neste caso. Este campo é suportado desde dpkg 1.16.4; de modo a compilar com versões antigas do dpkg, deve ser usado B<Build-Depends> em vez disto.

note: type: textblock
en: Same as B<Build-Depends>, but they are only needed when building the architecture independent packages.  The B<Build-Depends> are also installed in this case.
pt: O mesmo que B<Build-Depends>, mas são apenas necessárias quando se compila os pacotes independentes da arquitectura. Os B<Build-Depends> são também instalados neste caso.

note: type: textblock
en: A list of packages that should not be installed when the package is built, for example because they interfere with the build system used.  Including a dependency in this list has the same effect as including it in both B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional effect of being used for source-only builds.
pt: Uma lista de pacotes que não devem estar instalados quando o pacote é compilado, por exemplo porque interferem com o sistema de compilação usado. Incluir uma dependência nesta lista tem o mesmo efeito que a incluir em ambos B<Build-Conflicts-Arch> e B<Build-Conflicts-Indep>, com o efeito adicional de ser usada para compilações de apenas-fonte.

note: type: textblock
en: Same as B<Build-Conflicts>, but only when building the architecture dependent packages.  This field is supported since dpkg 1.16.4; in order to build with older dpkg versions, B<Build-Conflicts> should be used instead.
pt: O mesmo que B<Build-Conflicts>, mas apenas quando se compila os pacotes dependentes da arquitectura. Este campo é suportado desde dpkg 1.16.4; de modo a compilar com versões antigas do dpkg, deve ser usado B<Build-Conflicts> em vez disto.

note: type: textblock
en: Same as B<Build-Conflicts>, but only when building the architecture independent packages.
pt: O mesmo que B<Build-Conflicts>. mas apenas quando se compila os pacotes independentes da arquitectura.

note: type: textblock
en: The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and B<Build-Depends-Indep> fields is a list of groups of alternative packages.  Each group is a list of packages separated by vertical bar (or “pipe”)  symbols, ‘B<|>’.  The groups are separated by commas ‘B<,>’, and can end with a trailing comma that will be eliminated when generating the fields for L<deb-control(5)> (since dpkg 1.10.14).  Commas are to be read as “AND”, and pipes as “OR”, with pipes binding more tightly.  Each package name is optionally followed by an architecture qualifier appended after a colon ‘B<:>’, optionally followed by a version number specification in parentheses ‘B<(>’ and ‘B<)>’, an architecture specification in square brackets ‘B<[>’ and ‘B<]>’, and a restriction formula consisting of one or more lists of profile names in angle brackets ‘B<E<lt>>’ and ‘B<E<gt>>’.
pt: A sintaxe dos campos B<Build-Depends>, B<Build-Depends-Arch> e B<Build-Depends-Indep> é uma lista de grupos de pacotes alternativos. Cada grupo é uma lista de pacotes separados por símbolos de barra vertica (ou “pipe”), ‘B<|>’. OS grupos estão separados por vírgulas ‘B<,>’, e podem terminar com uma vírgula final que será eliminada ao gerar os campos para L<deb-control(5)> (desde dpkg 1.10.14). As virgulas devem ler-se como “E”, e os pipes como “OU”, com os pipes a vincular com mais firmeza, Cada nome de pacote é seguido opcionalmente por um qualificador de arquitectura anexado após dois pontos ‘B<:>’, opcionalmente seguido por uma especificação de número de versão em parêntesis ‘B<(>’ e ‘B<)>’, uma especificação de  arquitectura em parêntesis rectos ‘B<[>’ e ‘B<]>’, e uma fórmula de restrição consistindo de uma ou mais listas de nomes de perfis em colchetes angulares ‘B<E<lt>>’ e ‘B<E<gt>>’.

note: type: textblock
en: The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep> fields is a list of comma-separated package names, where the comma is read as an “AND”, and where the list can end with a trailing comma that will be eliminated when generating the fields for L<deb-control(5)> (since dpkg 1.10.14).  Specifying alternative packages using a “pipe” is not supported.  Each package name is optionally followed by a version number specification in parentheses, an architecture specification in square brackets, and a restriction formula consisting of one or more lists of profile names in angle brackets.
pt: A sintaxe dos campos B<Build-Conflicts>, B<Build-Conflicts-Arch> e B<Build-Conflicts-Indep> é uma lista de nomes de pacotes separados por vírgulas, onde a vírgula é lida com um "E", e onde a lista por terminar com uma vírgula final que será eliminada ao se gerar os campos para L<deb-control(5)> (desde dpkg 1.10.14). Especificar pacotes alternativos usando um “pipe” não é suportado. Cada nome de pacote é opcionalmente seguido de uma especificação de número de versão em parêntesis, uma especificação de arquitectura em parêntesis rectos, e uma fórmula de restrição consistindo de um ou mais listas de nomes de perfis em colchetes angulares.

note: type: textblock
en: An architecture qualifier name can be a real Debian architecture name (since dpkg 1.16.5), B<any> (since dpkg 1.16.2) or B<native> (since dpkg 1.16.5).  If omitted, the default for B<Build-Depends> fields is the current host architecture, the default for B<Build-Conflicts> fields is B<any>.  A real Debian architecture name will match exactly that architecture for that package name, B<any> will match any architecture for that package name if the package is marked with B<Multi-Arch: allowed>, and B<native> will match the current build architecture if the package is not marked with B<Multi-Arch: foreign>.
pt: Um nome qualificador de arquitectura pode ser um nome de arquitectura real Debian (desde dpkg 1.16.5), B<any> (desde dpkg 1.16.2) ou B<native> (desde dpkg 1.16.5). Se omitido, a predefinição para campos B<Build-Depends> é a arquitectura da máquina actual, a predefinição para campos B<Build-Conflicts> é B<any>.  Um nome de arquitectura real Debian irá corresponder exactamente essa arquitectura para esse nome de pacote,  B<any> irá corresponder a qualquer arquitectura para esse nome de pacote se o pacote estiver marcado com B<Multi-Arch: allowed>, e B<native> irá corresponder à arquitectura de compilação actual se o pacote não estiver marcado com B<Multi-Arch: foreign>.

note: type: textblock
en: An architecture specification consists of one or more architecture names, separated by whitespace.  Exclamation marks may be prepended to each of the names, meaning “NOT”.
pt: Uma especificação de arquitectura consiste em um ou mais nomes de arquitectura, separados por espaços em branco. Pode ser adicionado no inicio de cada nome um ponto de exclamação, o que significa "NÃO".

note: type: textblock
en: A restriction formula consists of one or more restriction lists, separated by whitespace.  Each restriction list is enclosed in angle brackets.  Items in the restriction list are build profile names, separated by whitespace and can be prefixed with an exclamation mark, meaning “NOT”.  A restriction formula represents a disjunctive normal form expression.
pt: Uma fórmula de restrição consiste em uma ou mais listas de restrições, separadas por espaços em branco. Cada lista de restrição fica dentro de colchetes angulares, os itens na lista de restrição são nomes de perfis de compilação, separados por espaços em branco e pode ser prefixados com um ponto de exclamação, que significa “NÃO”. Uma fórmula de restrição representa uma expressão de forma normal disjuntiva.

note: type: textblock
en: Note that dependencies on packages in the B<build-essential> set can be omitted and that declaring build conflicts against them is impossible.  A list of these packages is in the build-essential package.
pt: Note que as dependências de pacotes no conjunto B<build-essential> podem ser omitidas e que declarar conflitos de compilação contra elas é impossível. Uma lista desses pacotes está no pacote build-essential.

note: type: =head1
en: BINARY FIELDS
pt: CAMPOS DE BINÁRIOS

note: type: textblock
en: Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in a binary stanza to override the global value from the source package.
pt: Note que os campos B<Priority>, B<Section> e B<Homepage> podem também ficar numa estrofe binário para sobrepor o valor global do pacote fonte.

note: type: =item
en: B<Package:> I<binary-package-name> (required)
pt: B<Package:> I<binary-package-name> (necessário)

note: type: textblock
en: This field is used to name the binary package name.  The same restrictions as to a source package name apply.
pt: Este campo é usado para dar nome ao nome do pacote binário. Aplicam-se as mesmas restrições como para um nome de pacote fonte.

note: type: =item
en: B<Architecture:> I<arch>|B<all>|B<any> (required)
pt: B<Architecture:> I<arch>|B<all>|B<any> (necessário)

note: type: textblock
en: The architecture specifies on which type of hardware this package runs.  For packages that run on all architectures, use the B<any> value.  For packages that are architecture independent, such as shell and Perl scripts or documentation, use the B<all> value.  To restrict the packages to a certain set of architectures, specify the architecture names, separated by a space.  It's also possible to put architecture wildcards in that list (see L<dpkg-architecture(1)> for more information about them).
pt: A arquitectura especifica em que tipo de hardware este pacote corre. Para os pacotes que correm em toras as arquitecturas, use o valor B<any>. Para pacotes que são independentes da arquitectura, tais como scripts de shell e Perl ou documentação, use o valor B<all>. Para restringir os pacotes a certo  conjunto de arquitecturas, especifique os nomes das arquitecturas, separadas por um espaço. É também possível colocar wildcards de arquitecturas nessa lista (veja L<dpkg-architecture(1)> para mais informação sobre isto).

note: type: textblock
en: This field specifies the conditions for which this binary package does or does not build.  To express that condition, the same restriction formula syntax from the B<Build-Depends> field is used (including the angle brackets).
pt: Este campo especifica as condições para quais este pacote compila ou não compila. Para expressar essas condições, é usada a mesma sintaxe de fórmula de restrição que se usa no campo B<Build-Depends> (incluindo os colchetes angulares).

note: type: textblock
en: If a binary package stanza does not contain this field, then it implicitly means that it builds with all build profiles (including none at all).
pt: Se uma estrofe de pacote binário não conter este campo, então significa implicitamente que compila com todos os perfis de compilação (incluindo nenhum deles).

note: type: textblock
en: In other words, if a binary package stanza is annotated with a non-empty B<Build-Profiles> field, then this binary package is generated if and only if the condition expressed by the conjunctive normal form expression evaluates to true.
pt: Por outras palavras, se uma estrofe de pacote binário estiver anotado com um campo B<Build-Profiles> não vazio, então este pacote binário é gerado se e apenas se a condição expressa pela expressão de forma normal conjuntiva ser avaliada como verdadeira.

note: type: textblock
en: These fields are described in the L<deb-control(5)> manual page, as they are copied literally to the control file of the binary package.
pt: Estes campos estão descritos no manual do L<deb-control(5)>, pois eles são literalmente copiados para o ficheiro de controle do pacote binário.

note: type: textblock
en: These fields declare relationships between packages.  They are discussed in the L<deb-control(5)> manual page.  When these fields are found in I<debian/control> they can also end with a trailing comma (since dpkg 1.10.14), have architecture specifications and restriction formulas which will all get reduced when generating the fields for L<deb-control(5)>.
pt: Estes campos declaram relacionamentos entre pacotes. Eles são discutidos no manual L<deb-control(5)>. Quando estes campos são encontrados em I<debian/control> eles podem também terminar com uma vírgula final (desde dpkg 1.10.14), têm especificações de arquitectura, e fórmulas de restrição que serão todas reduzidas quando se gera os campos para L<deb-control(5)>.

note: type: textblock
en: These fields are used by the debian-installer in B<udeb>s and are usually not needed.  For more details about them, see L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>.
pt: Estes campos são usados pelo instalador de debian em B<udeb>s e geralmente não são necessários. Para mais detalhes acerca deles, veja L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>.

note: type: =head1
en: USER-DEFINED FIELDS
pt: CAMPOS DEFINIDOS PELO UTILIZADOR

note: type: textblock
en: It is allowed to add additional user-defined fields to the control file.  The tools will ignore these fields.  If you want the fields to be copied over to the output files, such as the binary packages, you need to use a custom naming scheme: the fields should start with an B<X>, followed by zero or more of the letters B<SBC> and a hyphen.
pt: É permitido adicionar campos adicionais definidos pelo utilizador. As ferramentas irão ignorar estes campos. -Se deseja que os campos sejam copiados os ficheiros resultantes, tal como um pacote binário, você precisa de usar um esquema de nomeação personalizado: os campos devem começar com um B<X>, seguido de zero ou mais das letras B<SBC> e um hífen.

note: type: textblock
en: The field will appear in the source package control file, see L<dsc(5)>.
pt: O campo irá aparecer no ficheiro de controle do pacote fonte, veja L<dsc(5)>.

note: type: textblock
en: The field will appear in the control file in the binary package, see L<deb-control(5)>.
pt: O campo irá aparecer no ficheiro de controle do pacote binário, veja L<deb-control(5)>.

note: type: textblock
en: The field will appear in the upload control (.changes) file, see L<deb-changes(5)>.
pt: O campo irá aparecer no ficheiro de controle de envio (.changes), veja L<deb-changes(5)>.

note: type: textblock
en: Note that the B<X>[B<SBC>]B<-> prefixes are stripped when the fields are copied over to the output files.  A field B<XC-Approved-By> will appear as B<Approved-By> in the changes file and will not appear in the binary or source package control files.
pt: Note que os prefixos B<X>[B<SBC>]B<-> são cortados quando so campos são copiados para os ficheiros resultantes. Um campo B<XC-Approved-By> irá aparecer como B<Approved-By> no ficheiro changes e não irá aparecer nos ficheiros de controle de pacote binário ou fonte.

note: type: textblock
en: Take into account that these user-defined fields will be using the global namespace, which might at some point in the future collide with officially recognized fields.  To avoid such potential situation you can prefix those fields with B<Private->, such as B<XB-Private-New-Field>.
pt: Tenha em conta que estes campos definidos pelo utilizador irão usar o espaço de nomes global, o que poderá em algum ponto no futuro colidir com campos oficialmente reconhecidos. Para evitar tal potencial situação, você pode prefixar esse campos com B<Private->, tal como B<XB-Private-New-Field>.

note: type: textblock
en: deb-src-files - Debian distribute files format
pt: deb-src-files - Formato Debian de distribuição de ficheiros

note: type: textblock
en: This file contains the list of artifacts that are to be distributed via the B<.changes> control file.
pt: Este ficheiro contem a lista de artefactos que são para ser distribuídos via ficheiro de controle B<.changes>.

note: type: textblock
en: The I<debian/files> file has a simple whitespace-delimited format.
pt: O ficheiro I<debian/files> tem um formato de delimitação simples por espaços em branco.

note: type: textblock
en: I<filename> is the name of the artifact to distribute.
pt: I<filename> é o nome do artefacto a distribuir.

note: type: textblock
en: I<section> and I<priority> correspond to the respective control fields available in the .deb.  The allowed values are specific to each distribution archive.
pt: I<section> e I<priority> correspondem aos campos de controle respectivos disponíveis no .deb. Os valores permitidos são específicos para cada arquivo de distribuição.

note: type: textblock
en: I<keyword=value...> corresponds to an optional whitespace-delimited list of attributes for this entry.  The only currently supported keyword is B<automatic> with value B<yes>, to mark automatically generated files.
pt: I<keyword=value...> corresponde uma lista opcional delimitada por espaços em branco de atributos para esta entrada. A única palavra-chave presentemente suportada é B<automatic> com valor B<yes>, para marcar ficheiros gerados automaticamente.

note: type: =head1
en: NOTES
pt: NOTAS

note: type: textblock
en: This file is not intended to be modified directly, please use one of B<dpkg-gencontrol> or B<dpkg-distaddfile> to add entries to it.
pt: Este ficheiro não se destina a ser modificado directamente, por favor use um de B<dpkg-gencontrol> ou B<dpkg-distaddfile> para adicionar entradas nele.

note: type: textblock
en: deb-src-rules - Debian source package rules file
pt: deb-src-rules - Ficheiro de regras de pacotes fonte Debian

note: type: textblock
en: This file contains the instructions necessary to build the binary packages from the source package.
pt: Este ficheiro contem as instruções necessárias para compilar os pacotes binários a partir do pacote fonte.

note: type: textblock
en: The I<debian/rules> file is an executable Makefile, with a shebang that is usually set to "#!/usr/bin/make -f".
pt: O ficheiro I<debian/rules> é um Makefile executável, com algo que é geralmente definido para "#!/usr/bin/make -f".

note: type: textblock
en: It must support the following make targets:
pt: Tem de suportar os seguintes alvos do make:

note: type: textblock
en: Clean up the source tree, by undoing any change done by any of the build and binary targets.  This target will be called with root privileges.
pt: Limpa a árvore fonte, ao desfazer qualquer alteração feita por qualquer dos alvos binários ou de compilação. Este alvo será chamado com privilégios de root.

note: type: textblock
en: Build architecture independent files required to build any architecture independent binary package.  If there are no architecture independent binary packages to generate, the target must still exist but do nothing.  This target must not require root privileges.
pt: Ficheiros independentes da arquitectura de compilação requeridos para compilar qualquer pacote binário independente da arquitectura. Se não existir nenhum pacote binário independente da arquitectura para gerar, o alvo continua a ter e existir mas não faz nada. Este alvo não pode requerer privilégios de root.

note: type: textblock
en: Build architecture dependent files required to build any architecture dependent binary package.  If there are no architecture dependent binary packages to generate, the target must still exist but do nothing.  This target must not require root privileges.
pt: Ficheiros dependentes da arquitectura de compilação requeridos para compilar qualquer pacote binário dependente da arquitectura. Se não existir nenhum pacote binário dependente da arquitectura para gerar, o alvo continua a ter e existir mas não faz nada. Este alvo não pode requerer privilégios de root.

note: type: textblock
en: Build architecture independent and dependent files, either by depending (at least transitively) on B<build-indep> and/or B<build-arch> or by inlining what those targets would do.  This target must not require root privileges.
pt: Ficheiros independentes e dependentes de arquitectura de compilação, seja por depender (pelo menos transitivamente) de B<build-indep> e/ou B<build-arch> ou ao alinhar com o que esses alvos devem fazer. Este alvo não deve requerer privilégios de root.

note: type: textblock
en: Build architecture independent binary packages.  This target must depend (at least transitively) on either B<build-indep> or B<build>.  This target will be called with root privileges.
pt: Pacotes binários independentes de arquitectura de compilação. Este alvo deve depender (pelo menos transitivamente) de B<build-indep> ou de B<build>. Este alvo será chamado com privilégios de root.

note: type: textblock
en: Build architecture dependent binary packages.  This target must depend (at least transitively) on either B<build-arch> or B<build>.  This target will be called with root privileges.
pt: Pacotes binários dependentes de arquitectura de compilação. Este alvo deve depender (pelo menos transitivamente) de B<build-arch> ou de B<build>. Este alvo será chamado com privilégios de root.

note: type: textblock
en: Build architecture independent and dependent binary packages, either by depending (at least transitively) on B<binary-indep> and/or B<binary-arch> or by inlining what those targets would do.  This target will be called with root privileges.
pt: Pacotes binários independentes e dependentes de arquitectura de compilação, seja por depender (pelo menos transitivamente) de B<binary-indep> e/ou B<binary-arch> ou ao alinhar com o que esses alvos devem fazer. Este alvo será chamado com privilégios de root.

note: type: textblock
en: deb-src-symbols - Debian's extended shared library template file
pt: deb-src-symbols - ficheiro modelo de biblioteca partilhada extensiva de Debian

note: type: textblock
en: The symbol file templates are shipped in Debian source packages, and its format is a superset of the symbols files shipped in binary packages, see L<deb-symbols(5)>.
pt: Os modelos de ficheiros symbol são enviados em pacotes fonte Debian, e o seu formato é um superconjunto dos ficheiros symbols enviados em pacotes binários, veja L<deb-symbols(5)>.

note: type: =head2
en: Comments
pt: Comentários

note: type: textblock
en: Comments are supported in template symbol files.  Any line with ‘#’ as the first character is a comment except if it starts with ‘#include’ (see section L</Using includes>).  Lines starting with ‘#MISSING:’ are special comments documenting symbols that have disappeared.
pt: Comentários são suportados em modelos de ficheiros de símbolos: Qualquer linha com um ‘#’ no primeiro caractere é um comentário excepto se começar com ‘#include’ (veja secção L</Usando inclusões>). As linhas que começam com ‘#MISSING:’ são comentários especiais que documentam símbolos que desapareceram.

note: type: =head2
en: Using #PACKAGE# substitution
pt: Usando substituição de #PACKAGE#

note: type: textblock
en: In some rare cases, the name of the library varies between architectures.  To avoid hardcoding the name of the package in the symbols file, you can use the marker I<#PACKAGE#>.  It will be replaced by the real package name during installation of the symbols files.  Contrary to the I<#MINVER#> marker, I<#PACKAGE#> will never appear in a symbols file inside a binary package.
pt: Em alguns casos raros, o nome da biblioteca varia entre arquitecturas. Para evitar dificultar o nome do pacote no ficheiro de símbolos, você pode usar o marcador I<#PACKAGE#>. Será substituído pelo nome real do pacote durante a instalação dos ficheiros de símbolos. Contrariamente ao marcador I<#MINVER#>, I<#PACKAGE#> nunca irá aparecer num ficheiro de símbolos dentro de um pacote binário.

note: type: =head2
en: Using symbol tags
pt: Usar etiquetas símbolo

note: type: textblock
en: Symbol tagging is useful for marking symbols that are special in some way.  Any symbol can have an arbitrary number of tags associated with it.  While all tags are parsed and stored, only some of them are understood by B<dpkg-gensymbols> and trigger special handling of the symbols.  See subsection L</Standard symbol tags> for reference of these tags.
pt: Etiquetagem de símbolos é útil para marcar símbolos que são especiais em algum modo. Qualquer símbolo pode ter um número arbitrário de etiquetas associadas com ele. Enquanto todas as etiquetas são analisadas e guardadas, apenas algumas delas são compreendidas pelo B<dpkg-gensymbols> e despoletam manuseamento especial dos símbolos. Veja a sub-secção L</Etiquetas símbolo standard> para referência a estas etiquetas.

note: type: textblock
en: Tag specification comes right before the symbol name (no whitespace is allowed in between).  It always starts with an opening bracket B<(>, ends with a closing bracket B<)> and must contain at least one tag.  Multiple tags are separated by the B<|> character.  Each tag can optionally have a value which is separated form the tag name by the B<=> character.  Tag names and values can be arbitrary strings except they cannot contain any of the special B<)> B<|> B<=> characters.  Symbol names following a tag specification can optionally be quoted with either B<'> or B<"> characters to allow whitespaces in them.  However, if there are no tags specified for the symbol, quotes are treated as part of the symbol name which continues up until the first space.
pt: A especificação de etiqueta vem logo antes do nome do símbolo (não é permitido nenhum espaço em branco entre eles). Começa sempre com um abre-parêntesis B<(>, termina com um fecha-parêntesis B<)> e tem de conter pelo menos uma etiqueta. Múltiplas etiquetas são separadas pelo caractere B<|>. Cada etiqueta pode opcionalmente ter um valor que é separado do nome da etiqueta com um caractere B<=>. Os nomes de etiquetas e valores podem ser strings arbitrárias excepto que não podem conter nenhum dos caracteres especiais B<)> B<|> B<=>. Nomes de símbolos que seguem a especificação das etiquetas podem opcionalmente ser citados com os caracteres B<'> ou B<"> para permitir espaços em brando neles. No entanto, se não existirem etiquetas especificadas para o símbolo, as citações são tratadas como parte do nome do símbolo o qual continua até ao primeiro espaço.

note: type: textblock
en: The first symbol in the example is named I<tagged quoted symbol> and has two tags: I<tag1> with value I<i am marked> and I<tag name with space> that has no value.  The second symbol named I<tagged_unquoted_symbol> is only tagged with the tag named I<optional>.  The last symbol is an example of the normal untagged symbol.
pt: O primeiro símbolo no exemplo é chamado I<tagged quoted symbol> e tem duas etiquetas: I<tag1> com valor I<i am marked> e I<tag name with space> que não tem nenhum valor. O segundo símbolo chamado I<tagged_unquoted_symbol> é apenas etiquetado com a etiqueta chamada I<optional>. O último símbolo é um exemplo do símbolo normal não etiquetado.

note: type: textblock
en: Since symbol tags are an extension of the L<deb-symbols(5)> format, they can only be part of the symbols files used in source packages (those files should then be seen as templates used to build the symbols files that are embedded in binary packages).  When B<dpkg-gensymbols> is called without the B<-t> option, it will output symbols files compatible to the L<deb-symbols(5)> format: it fully processes symbols according to the requirements of their standard tags and strips all tags from the output.  On the contrary, in template mode (B<-t>) all symbols and their tags (both standard and unknown ones)  are kept in the output and are written in their original form as they were loaded.
pt: Como as etiquetas de símbolos são uma extensão do formato L<deb-symbols(5)>, elas apenas fazer parte dos ficheiros de símbolos usados em pacotes fonte (esses ficheiros devem depois ser vistos como modelos usados para compilar os ficheiros de símbolos que são embebidos em pacotes binários. Quando B<dpkg-gensymbols> é chamado sem a opção B<-t>, irá escrever ficheiros de símbolos compatíveis com o formato L<deb-symbols(5)>: processa totalmente os símbolos de acordo com os requerimentos das suas etiquetas standard e remove todas as etiquetas do resultado. Pelo contrário, em modo de modelo (B<-t>) todos os símbolos e suas etiquetas (tanto standard como desconhecidas) são mantidas no resultado e são escritas no seu formato original como foram carregadas.

note: type: =head2
en: Standard symbol tags
pt: Etiquetas símbolo standard

note: type: textblock
en: A symbol marked as optional can disappear from the library at any time and that will never cause B<dpkg-gensymbols> to fail.  However, disappeared optional symbols will continuously appear as MISSING in the diff in each new package revision.  This behavior serves as a reminder for the maintainer that such a symbol needs to be removed from the symbol file or readded to the library.  When the optional symbol, which was previously declared as MISSING, suddenly reappears in the next revision, it will be upgraded back to the “existing” status with its minimum version unchanged.
pt: Um símbolo marcado como opcional pode desaparecer da biblioteca a qualquer altura e isso nunca fará o B<dpkg-gensymbols> falhar. No entanto, símbolos opcionais desaparecidos irão continuamente aparecer como MISSING no diff em cada nova revisão do pacote. Este comportamento serve como lembrete para o maintainer que tal símbolo precisa de ser removido do ficheiro de símbolos ou re-adicionado à biblioteca. Quando o símbolo opcional, que foi anteriormente declarado como MISSING, subitamente reaparece na próxima revisão, será actualizado de volta para o estado de "existente" com a sua versão mínima inalterada.

note: type: textblock
en: This tag is useful for symbols which are private where their disappearance do not cause ABI breakage.  For example, most of C++ template instantiations fall into this category.  Like any other tag, this one may also have an arbitrary value: it could be used to indicate why the symbol is considered optional.
pt: Esta etiqueta é útil para símbolos que são privados e para o seu desaparecimento não causar a rutura da ABI. Por exemplo, a maioria das instalações de modelos C++ caiem nesta categoria. Como qualquer outra etiqueta, esta também pode ter uma valor arbitrário: isso podia ser usado para indicar porquê o símbolo é considerado opcional.

note: type: textblock
en: These tags allow one to restrict the set of architectures where the symbol is supposed to exist.  The B<arch-bits> and B<arch-endian> tags are supported since dpkg 1.18.0.  When the symbols list is updated with the symbols discovered in the library, all arch-specific symbols which do not concern the current host architecture are treated as if they did not exist.  If an arch-specific symbol matching the current host architecture does not exist in the library, normal procedures for missing symbols apply and it may cause B<dpkg-gensymbols> to fail.  On the other hand, if the arch-specific symbol is found when it was not supposed to exist (because the current host architecture is not listed in the tag or does not match the endianness and bits), it is made arch neutral (i.e. the arch, arch-bits and arch-endian tags are dropped and the symbol will appear in the diff due to this change), but it is not considered as new.
pt: Estas bandeiras permitem-nos restringir o conjunto de arquitecturas onde o símbolo é suposto existir. As bandeiras B<arch-bits> e B<arch-endian> são suportadas desde dpkg 1.18.0. Quando a lista de símbolos é actualizada com os símbolos descobertos na biblioteca, todos os símbolos específicos de arquitectura que não dizem respeito à arquitectura da máquina actual são tratados como se não existissem. Se um símbolo específico-de-arquitectura que corresponda à arquitectura da máquina anfitriã atual não existir na biblioteca, aplica-se os procedimentos normais para símbolos em falta e isso pode causar que B<dpkg-gensymbols> falhe. Por outro lado, se o símbolo específico-de arquitectura for encontrado onde não era suporto existir (porque a arquitectura da máquina actual não está listada na etiqueta ou porque não corresponde ao endianness e bits), é tornado neutro em arquitectura (isto é, as etiquetas arch, arch-bits e arch-endian são largadas e o símbolo irá aparecer no diff devido a esta alteração), mas não é considerado como novo.

note: type: textblock
en: When operating in the default non-template mode, among arch-specific symbols only those that match the current host architecture are written to the symbols file.  On the contrary, all arch-specific symbols (including those from foreign arches) are always written to the symbol file when operating in template mode.
pt: Quando opera no modo predefinido não-modelo, entre os símbolos específicos de arquitectura, apenas aqueles que correspondem à arquitectura da máquina anfitriã actual são escritos no ficheiro de símbolos. Pelo contrário, quando se opera em modo de modelo, todos os símbolos específicos-de-arquitectura (incluindo aqueles de arquitecturas alienígenas) são sempre escritos no ficheiro de símbolos.

note: type: textblock
en: The format of I<architecture-list> is the same as the one used in the B<Build-Depends> field of I<debian/control> (except the enclosing square brackets []).  For example, the first symbol from the list below will be considered only on alpha, any-amd64 and ia64 architectures, the second only on linux architectures, while the third one anywhere except on armel.
pt: O formato de I<architecture-list> é o mesmo que o usado no campo B<Build-Depends> de I<debian/control> (excepto nos parêntesis rectos []). Por exemplo, o primeiro símbolo da lista em baixo será considerado apenas nas arquitecturas alpha, any-amd64 e ia64, o segundo apenas em arquitecturas de linux, enquanto o terceiro em todas excepto em armel.

note: type: textblock
en: The I<architecture-bits> is either B<32> or B<64>.
pt: O I<architecture-bits> ou é B<32> ou é B<64>.

note: type: textblock
en: The I<architecture-endianness> is either B<little> or B<big>.
pt: A I<arquitectura-classe-endian> é ou B<little> ou B<big>.

note: type: textblock
en: Multiple restrictions can be chained.
pt: Múltiplas restrições podem ser ligadas em corrente.

note: type: textblock
en: dpkg-gensymbols has a list of internal symbols that should not appear in symbols files as they are usually only side-effects of implementation details of the toolchain (since dpkg 1.20.1).  If for some reason, you really want one of those symbols to be included in the symbols file, you should tag the symbol with B<allow-internal>.  It can be necessary for some low level toolchain libraries like “libgcc”.
pt: O dpkg-gensymbols tem uma lista interna de símbolos que não devem aparecer em ficheiros de símbolos pois eles são geralmente apenas efeitos secundários de detalhes de implementação da ferramenta-cadeia (desde dpkg 1.20.1). Se por alguma razão, você querer realmente que um desses símbolos seja incluído no ficheiro de símbolos, você deve etiquetar o símbolo com B<allow-internal>. Pode ser necessário para algumas ferramentas-cadeia de baixo nível como “libgcc”.

note: type: textblock
en: A deprecated alias for B<allow-internal> (since dpkg 1.20.1, supported since dpkg 1.15.3).
pt: Um alias descontinuado para B<allow-internal> (desde dpkg 1.20.1, suportado desde dpkg 1.15.3).

note: type: textblock
en: Denotes I<c++> symbol pattern.  See L</Using symbol patterns> subsection below.
pt: indica o padrão de símbolos I<c++> . Veja a sub-secção L</Usar padrões de símbolos> em baixo.

note: type: textblock
en: Denotes I<symver> (symbol version) symbol pattern.  See L</Using symbol patterns> subsection below.
pt: Indica o padrão de símbolos I<symver> (versão de símbolo). Veja a sub-secção L</Usar padrões de símbolos> em baixo.

note: type: textblock
en: Denotes I<regex> symbol pattern.  See L</Using symbol patterns> subsection below.
pt: Indica o padrão de símbolos I<regex>. Veja a sub-secção L</Usar padrões de símbolos> em baixo.

note: type: =head2
en: Using symbol patterns
pt: Usar padrões de símbolos

note: type: textblock
en: Unlike a standard symbol specification, a pattern may cover multiple real symbols from the library.  B<dpkg-gensymbols> will attempt to match each pattern against each real symbol that does I<not> have a specific symbol counterpart defined in the symbol file.  Whenever the first matching pattern is found, all its tags and properties will be used as a basis specification of the symbol.  If none of the patterns matches, the symbol will be considered as new.
pt: Ao contrário de uma especificação de símbolo standard, um padrão pode cobrir vários símbolos reais da biblioteca. B<dpkg-gensymbols> irá tentar corresponder cada padrão com cada símbolo real que I<não> tem uma contrapartida de símbolo específica definida no ficheiro de símbolos. Sempre que o primeiro padrão de correspondência é encontrado, todas as suas etiquetas e propriedades serão usadas como a especificação base do símbolo. Se nenhum dos padrões corresponder, o símbolo irá ser considerado como novo.

note: type: textblock
en: A pattern is considered lost if it does not match any symbol in the library.  By default this will trigger a B<dpkg-gensymbols> failure under B<-c1> or higher level.  However, if the failure is undesired, the pattern may be marked with the I<optional> tag.  Then if the pattern does not match anything, it will only appear in the diff as MISSING.  Moreover, like any symbol, the pattern may be limited to the specific architectures with the I<arch> tag.  Please refer to L</Standard symbol tags> subsection above for more information.
pt: Um padrão é considerado perdido se não corresponder a nenhum símbolo da biblioteca. Por predefinição isto irá despoletar que B<dpkg-gensymbols> falhe sob B<-c1> ou nível mais alto. No entanto, se a falha for indesejável, o padrão pode ser marcado com a etiqueta I<optional>. Então se o padrão não corresponder a nada, irá apenas aparecer no diff como MISSING. Além disso, como qualquer símbolo, o padrão pode ser limitado a arquitecturas específicas com a etiqueta I<arch>. Por favor consulte a sub.secção L</Etiquetas símbolo standard> em cima para mais informação.

note: type: textblock
en: Patterns are an extension of the L<deb-symbols(5)> format hence they are only valid in symbol file templates.  Pattern specification syntax is not any different from the one of a specific symbol.  However, symbol name part of the specification serves as an expression to be matched against I<name@version> of the real symbol.  In order to distinguish among different pattern types, a pattern will typically be tagged with a special tag.
pt: Padrões são uma extensão do formato L<deb-symbols(5)> por isso eles são apenas válidos em modelos de ficheiros de símbolos. A sintaxe de especificação de padrões não é em nada diferente daquela de um símbolo específico. No entanto, a parte da especificação com o nome do símbolo serve como uma expressão para ser correspondida contra I<name@version> do símbolo real. De modo a se distinguir entre tipos diferentes de padrões, um padrão será tipicamente etiquetado com uma etiqueta especial.

note: type: textblock
en: At the moment, B<dpkg-gensymbols> supports three basic pattern types:
pt: Até ao momento, B<dpkg-gensymbols> suporta três tipos de padrão básicos:

note: type: textblock
en: This pattern is denoted by the I<c++> tag.  It matches only C++ symbols by their demangled symbol name (as emitted by L<c++filt(1)> utility).  This pattern is very handy for matching symbols which mangled names might vary across different architectures while their demangled names remain the same.  One group of such symbols is I<non-virtual thunks> which have architecture specific offsets embedded in their mangled names.  A common instance of this case is a virtual destructor which under diamond inheritance needs a non-virtual thunk symbol.  For example, even if _ZThn8_N3NSB6ClassDD1Ev@Base on 32-bit architectures will probably be _ZThn16_N3NSB6ClassDD1Ev@Base on 64-bit ones, it can be matched with a single I<c++> pattern:
pt: Este padrão é denotado pela etiqueta I<c++>. Corresponde apenas a símbolos C++ pelo seu nome desmutilado de símbolo (como emitido pelo utilitário L<c++filt(1)>). Este padrão é muito jeitoso para corresponder a símbolos cujos nomes mutilados podem variar por entre diferentes arquitecturas enquanto que os seus nomes desmutilados permanecem iguais. Um grupo de tais símbolos é I<non-virtual thunks> que têm embebidos desvios específicos de arquitectura nos seus nomes mutilados. Uma instância comum deste caso é um destruidor virtual que sob herança diamante precisa de um símbolo thunk não-virtual. Por exemplo, mesmo que  _ZThn8_N3NSB6ClassDD1Ev@Base em arquitecturas de 32bit provavelmente seja  _ZThn16_N3NSB6ClassDD1Ev@Base em 64bit, pode ser correspondido com um único padrão I<c++>:

note: type: textblock
en: The demangled name above can be obtained by executing the following command:
pt: O nome desmembrado em cima pode ser obtido ao executar o seguinte comando:

note: type: textblock
en: Please note that while mangled name is unique in the library by definition, this is not necessarily true for demangled names.  A couple of distinct real symbols may have the same demangled name.  For example, that's the case with non-virtual thunk symbols in complex inheritance configurations or with most constructors and destructors (since g++ typically generates two real symbols for them).  However, as these collisions happen on the ABI level, they should not degrade quality of the symbol file.
pt: Por favor note que enquanto o nome mutilado é único na biblioteca por definição, isto não é necessariamente verdade para nomes não-mutilados. Um par de símbolos reais distintos podem ter o mesmo nome mutilado. Por exemplo, esse é o caso com símbolos thunk não.virtuais em configurações de herança complexa ou com a maioria dos construtores e destruidores (pois o g++ tipicamente gera dois símbolos reais para eles). No entanto, como estas colisões acontecem no nível de ABI, não devem degradar a qualidade do ficheiro de símbolos.

note: type: textblock
en: This pattern is denoted by the I<symver> tag.  Well maintained libraries have versioned symbols where each version corresponds to the upstream version where the symbol got added.  If that's the case, you can use a I<symver> pattern to match any symbol associated to the specific version.  For example:
pt: Este padrão é denotado pela etiqueta I<symver>. Bibliotecas bem mantidas têm os símbolos organizados pela versão, onde cada versão corresponde à versão do autor de onde o símbolo foi obtido. Se for esse o caso, você pode usar um padrão I<symver> para corresponder a qualquer símbolo associado à versão específica. Por exemplo:

note: type: textblock
en: All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to minimal version of 2.0 and 2.7 respectively with the exception of the symbol access@GLIBC_2.0.  The latter will lead to a minimal dependency on libc6 version 2.2 despite being in the scope of the "(symver)GLIBC_2.0" pattern because specific symbols take precedence over patterns.
pt: Todos os símbolos associados com versões GLIBC_2.0 e GLIBC_2.7 irão para versões mínimas de 2.0 e 2.7 respetivamente com a excepção do símbolo access@GLIBC_2.0. O último irá tornar-se uma dependência mínima em libc6 versão 2.2 apenas de estar no escopo do padrão "(symver)GLIBC_2.0" porque símbolos específicos tomam precedência sobre padrões.

note: type: textblock
en: Please note that while old style wildcard patterns (denoted by "*@version" in the symbol name field) are still supported, they have been deprecated by new style syntax "(symver|optional)version".  For example, "*@GLIBC_2.0 2.0" should be written as "(symver|optional)GLIBC_2.0 2.0" if the same behavior is needed.
pt: Por favor note que apesar de os padrões de wildcard ao estilo antigo (denotados por "*@version" no campo do nome do símbolo) ainda serem suportados, estes foram descontinuados pela nova sintaxe "(symver|optional)version". Por exemplo, "*@GLIBC_2.0 2.0" deve ser escrito como "(symver|optional)GLIBC_2.0 2.0" se for necessário o mesmo comportamento.

note: type: textblock
en: Regular expression patterns are denoted by the I<regex> tag.  They match by the perl regular expression specified in the symbol name field.  A regular expression is matched as it is, therefore do not forget to start it with the I<^> character or it may match any part of the real symbol I<name@version> string.  For example:
pt: Padrões de expressões regulares são denotadas pela etiqueta I<regex>. Eles correspondem pelas expressões regulares perl especificadas no campo do nome do símbolo. Uma expressão regular corresponde tal como está, assim não se esqueça de a arrancar com o caractere I<^> ou poderá corresponder a qualquer parte da string I<name@version> do símbolo real. Por exemplo:

note: type: textblock
en: Symbols like "mystack_new@Base", "mystack_push@Base", "mystack_pop@Base", etc., will be matched by the first pattern while "ng_mystack_new@Base" would not.  The second pattern will match all symbols having the string "private" in their names and matches will inherit I<optional> tag from the pattern.
pt: Símbolos como "mystack_new@Base", "mystack_push@Base", "mystack_pop@Base" etc, irão corresponder ao primeiro padrão, enquanto "ng_mystack_new@Base" não o fará. O segundo padrão irá corresponder a todos os símbolos que tenham a string "private" nos seus nomes e as correspondências irão herdar a etiqueta I<optional> a partir do padrão.

note: type: textblock
en: Basic patterns listed above can be combined where it makes sense.  In that case, they are processed in the order in which the tags are specified.  For example, both:
pt: Os padrões básicos listados em cima podem ser combinados onde isso fizer sentido, nesse caso, eles são processados pela ordem em que as etiquetas estão especificadas. Por exemplo, ambos:

note: type: textblock
en: will match symbols "_ZN3NSA6ClassA7Private11privmethod1Ei@Base" and "_ZN3NSA6ClassA7Private11privmethod2Ei@Base".  When matching the first pattern, the raw symbol is first demangled as C++ symbol, then the demangled name is matched against the regular expression.  On the other hand, when matching the second pattern, regular expression is matched against the raw symbol name, then the symbol is tested if it is C++ one by attempting to demangle it.  A failure of any basic pattern will result in the failure of the whole pattern.  Therefore, for example, "__N3NSA6ClassA7Private11privmethod\dEi@Base" will not match either of the patterns because it is not a valid C++ symbol.
pt: irá corresponder aos símbolos "_ZN3NSA6ClassA7Private11privmethod1Ei@Base" e "_ZN3NSA6ClassA7Private11privmethod2Ei@Base". Quando coincide o primeiro padrão, o símbolo cru é primeiro desmutilado como símbolo C++, depois o nome desmutilado é coincidido com a expressão regular. Por outro lado, quando coincide o segundo padrão, a expressão regular é coincidida com o nome cru do símbolo, depois os símbolo é testado se é um C++ ao tentar desmutila-lo. Uma falha de qualquer padrão básico irá resultar na falha de todo o padrão. Por isso, por exemplo, "__N3NSA6ClassA7Private11privmethod\dEi@Base" não irá corresponder a nenhum dos padrões porque não é um símbolo C++ válido.

note: type: textblock
en: In general, all patterns are divided into two groups: aliases (basic I<c++> and I<symver>) and generic patterns (I<regex>, all combinations of multiple basic patterns).  Matching of basic alias-based patterns is fast (O(1))  while generic patterns are O(N) (N - generic pattern count) for each symbol.  Therefore, it is recommended not to overuse generic patterns.
pt: Em geral, todos os padrões são divididos em dois grupos: aliases (basic I<c++> e I<symver>) e padrões genéricos (I<regex>, todas as combinações de múltiplos padrões básicos). A correspondência de padrões básicos baseados-em-alias é rápida (O(1)) enquanto que padrões genéricos são O(N) (N - contagem de padrão genérico) para cada símbolo. Assim, é recomendado não sobre-utilizar padrões genéricos.

note: type: textblock
en: When multiple patterns match the same real symbol, aliases (first I<c++>, then I<symver>) are preferred over generic patterns.  Generic patterns are matched in the order they are found in the symbol file template until the first success.  Please note, however, that manual reordering of template file entries is not recommended because B<dpkg-gensymbols> generates diffs based on the alphanumerical order of their names.
pt: Quando múltiplos padrões correspondem ao mesmo símbolo real, os aliases (primeiro I<c++>, depois I<symver>) são preferidos sobre padrões genéricos. Padrões genéricos são correspondidos pela ordem que são encontrados no modelo de ficheiro de símbolos até ao primeiro sucesso. Por favor note, no entanto, esse reordenar manual das entradas no ficheiro modelo não é recomendado porque B<dpkg-gensymbols> gera diffs baseados na ordem alfanumérica dos seus nomes.

note: type: =head2
en: Using includes
pt: Usando inclusões

note: type: textblock
en: When the set of exported symbols differ between architectures, it may become inefficient to use a single symbol file.  In those cases, an include directive may prove to be useful in a couple of ways:
pt: Quando o conjunto de símbolos exportados difere entre arquitecturas, pode tornar-se ineficiente usar um único ficheiro de símbolos. Nesses casos, uma directiva de inclusão pode provar ser útil de várias maneiras:

note: type: textblock
en: You can factorize the common part in some external file and include that file in your I<package>.symbols.I<arch> file by using an include directive like this:
pt: Você pode factorizar a parte comum em algum ficheiro externo e incluir esse ficheiro no seu ficheiro I<package>.symbols.I<arch> ao usar uma directiva de inclusão como esta:

note: type: textblock
en: The include directive may also be tagged like any symbol:
pt: A directiva de inclusão pode também ser etiquetada como qualquer símbolo:

note: type: textblock
en: As a result, all symbols included from I<file-to-include> will be considered to be tagged with I<tag> ... I<tagN> by default.  You can use this feature to create a common I<package>.symbols file which includes architecture specific symbol files:
pt: Como resultado, todos os símbolos incluídos de I<file-to-include> serão considerados para serem etiquetados com I<tag> ... I<tagN> por predefinição. Você pode usar esta funcionalidade para criar um ficheiro I<package>.symbols comum que inclui ficheiros de símbolos específicos de arquitectura:

note: type: textblock
en: The symbols files are read line by line, and include directives are processed as soon as they are encountered.  This means that the content of the included file can override any content that appeared before the include directive and that any content after the directive can override anything contained in the included file.  Any symbol (or even another #include directive) in the included file can specify additional tags or override values of the inherited tags in its tag specification.  However, there is no way for the symbol to remove any of the inherited tags.
pt: Os ficheiros de símbolos são lidos linha a linha, e as directivas de inclusão são processadas assim que são encontradas. Isto significa que o conteúdo do ficheiro incluído pode sobrepor qualquer conteúdo que apareceu antes da directiva de inclusão e que qualquer conteúdo após a directiva pode sobrepor qualquer coisa contida no ficheiro incluído. Qualquer símbolo (ou mesmo outra directiva #include) no ficheiro incluído pode especificar etiquetas adicionais ou sobrepor valores das etiquetas herdadas e a sua especificação de etiqueta. Contudo, não existe maneira do símbolo remover qualquer das etiquetas herdadas.

note: type: textblock
en: An included file can repeat the header line containing the SONAME of the library.  In that case, it overrides any header line previously read.  However, in general it's best to avoid duplicating header lines.  One way to do it is the following:
pt: Um ficheiro incluído pode repetir a linha de cabeçalho que contém o SONAME da biblioteca. Nesse caso, sobrepõe qualquer linha de cabeçalho lida anteriormente. No entanto, geralmente é melhor duplicar as linhas de cabeçalho. Um modo de fazer isto é o seguinte:

note: type: textblock
en: deb-substvars - Debian source substitution variables
pt: deb-substvars - variáveis de substituição de fonte Debian

note: type: textblock
en: B<debian/substvars>, B<debian/>I<binary-package>B<.substvars>, variables
pt: Variáveis B<debian/substvars>, B<debian/>I<binary-package>B<.substvars>

note: type: textblock
en: Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their control information (to the source control file B<.dsc> for B<dpkg-source> and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>)  they perform some variable substitutions on the output file.
pt: Antes de B<dpkg-source>, B<dpkg-gencontrol> e B<dpkg-genchanges> escreverem a sua informação de controle (no ficheiro de de controle de fonte B<.dsc> para B<dpkg-source> e para a saída standard para B<dpkg-gencontrol> e B<dpkg-genchanges>) eles executam algumas substituições de variáveis no ficheiro resultante.

note: type: =head2
en: Variable Syntax
pt: Sintaxe de Variável

note: type: textblock
en: A variable substitution has the form B<${>I<variable-name>B<}>.  Variable names consist of alphanumerics (a-zA-Z0-9), hyphens (-) and colons (:) and start with an alphanumeric, and are case-sensitive, even though they might refer to other entities which are case-preserving.  Variable substitutions are performed repeatedly until none are left; the full text of the field after the substitution is rescanned to look for more substitutions.
pt: A substituição de variável tem o formato B<${>I<variable-name>B<}>.  Nomes de varáveis consistem de alfanuméricos (a-zA-Z0-9), hífens (-) dois pontos (:) e começam com um alfanumérico, e são sensíveis a maiúsculas/minúsculas, apesar de poderem referir a outras entidades, que são preservadoras de maiúsculas/minúsculas. Substituições de variáveis são executadas repetidamente até que não sobre nenhuma, o texto completo do campo após a substituição é re-sondado para se procurar por mais substituições.

note: type: =head2
en: File Syntax
pt: Sintaxe de Ficheiro

note: type: textblock
en: Substitution variables can be specified in a file.  These files consist of lines of the form I<name>B<=>I<value> or I<name>B<?=>I<value>.  The B<=> operator assigns a normal substitution variable, while the B<?=> operator (since dpkg 1.21.8) assigns an optional substitution variable which will emit no warnings even if unused.  Trailing whitespace on each line, blank lines, and lines starting with a B<#> symbol (comments) are ignored.
pt: As variáveis de substituição podem ser especificadas num ficheiro. Estes ficheiros consistem de linhas no formato I<name>B<=>I<value> ou I<name>B<?=>I<value>. O operado B<=> designa uma substituição normal de variável, enquanto o operador B<?=> (desde dpkg 1.21.8) designa uma variável de substituição opcional a qual não irá emitir avisos mesmo se não for usada. Espaços no final de cada linha, as linhas em branco, e as linhas que comecem com o símbolo B<#> (comentários) serão ignoradas.

note: type: =head2
en: Substitution
pt: Substituição

note: type: textblock
en: Variables can be set using the B<-V> common option.  They can be also specified in the file B<debian/substvars> (or whatever other file is specified using the B<-T> common option).
pt: As variáveis podem ser definidas usando a opção comum B<-V>. Elas podem também ser especificadas no ficheiro B<debian/substvars> (ou em qualquer outro ficheiro especificado usando a opção comum B<-T>).

note: type: textblock
en: After all the substitutions have been done each occurrence of the string B<${}> (which is not an actual substitution variable) is replaced with a B<$> sign.  This can be used as an escape sequence such as B<${}{>I<VARIABLE>B<}> which will end up as B<${>I<VARIABLE>B<}> on the output.
pt: Após todas as substituições terem sido feitas, cada ocorrência da string B<${}> (a qual não é uma variável de substituição real) é substituída por um sinal B<$>. Isto pode ser usado como sequência de escape tal como B<${}{>I<VARIABLE>B<}> o que irá acabar como B<${>I<VARIABLE>B<}> na saída.

note: type: textblock
en: If a variable is referred to but not defined it generates a warning and an empty value is assumed.
pt: Se uma variável for referida mas não definida, irá gerar um aviso e é assumido um valor vazio.

note: type: textblock
en: While variable substitution is done on all control fields, some of those fields are used and needed during the build when the substitution did not yet occur.  That's why you can't use variables in the B<Package>, B<Source> and B<Architecture> fields.
pt: Enquanto uma substituição de variável é feita em todos os campos de controle, alguns desse campos são usados e necessários durante a compilação quando a substituição ainda não aconteceu. É por isso que não pode usar vaiáveis nos campos B<Package>, B<Source> e B<Architecture>.

note: type: textblock
en: Variable substitution happens on the content of the fields after they have been parsed, thus if you want a variable to expand over multiple lines you do not have to include a space after the newline.  This is done implicitly when the field is output.  For example, if the variable B<${Description}> is set to "foo is bar.${Newline}foo is great." and if you have the following field:
pt: A substituição de variável acontece no conteúdo dos campos após terem sido analisados, mas se você quer que uma variável expanda por várias linhas você não precisa de incluir um espaço após a mudança de linha. Isto é feito implicitamente quando o campo é emitido. Por exemplo, se a variável B<${Description}> for definida para "foo is bar.${Nova-linha}foo is great." e se você tiver o seguinte campo:

note: type: textblock
en: It will result in:
pt: Irá resultar em:

note: type: =head2
en: Built-in Variable
pt: Variável Embutida

note: type: textblock
en: Additionally, the following standard variables are always available:
pt: Adicionalmente, estão sempre disponíveis as seguintes variáveis standard:

note: type: textblock
en: The current host architecture (i.e. the architecture the package is being built for, the equivalent of B<DEB_HOST_ARCH>).
pt: A arquitectura da máquina actual (isto é, a arquitectura para a qual o pacote está a ser compilado, o equivalente a B<DEB_HOST_ARCH>).

note: type: textblock
en: The current vendor name (since dpkg 1.20.0).  This value comes from the B<Vendor> field for the current vendor's origin file, as L<dpkg-vendor(1)> would retrieve it.
pt: O nome do fornecedor actual (desde dpkg 1.20.0). Este valor vem do campo B<Vendor> do ficheiro original do fornecedor actual, como L<dpkg-vendor(1)> o obteria.

note: type: textblock
en: The current vendor ID (since dpkg 1.20.0).  This is just the lowercase variant of B<vendor:Name>.
pt: O ID da versão actual (desde dpkg 1.20.0). Isto é apenas a variante em minúsculas de B<vendor:Name>.

note: type: textblock
en: The source package version (since dpkg 1.13.19).
pt: A versão do pacote fonte (desde dpkg 1.13.19).

note: type: textblock
en: The upstream source package version, including the Debian version epoch if any (since dpkg 1.13.19).
pt: A versão de pacote fonte do autor original, incluindo a época da versão Debian se existir (desde dpkg 1.13.19).

note: type: textblock
en: The binary package version (which may differ from B<source:Version> in a binNMU for example; since dpkg 1.13.19).
pt: A versão do pacote binário (que pode ser diferente de B<source:Version> numa binNMU por exemplo; desde dpkg 1.13.19).

note: type: textblock
en: The source package version (from the changelog file).  This variable is now B<obsolete> and emits an error when used as its meaning is different from its function, please use the B<source:Version> or B<binary:Version> as appropriate.
pt: A versão do pacote fonte (a partir do ficheiro changelog). Esta variável está agora B<obsoleta> e emite um erro quando usada pois o seu significado é diferente da sua função, por favor use B<source:Version> ou B<binary:Version> como apropriado.

note: type: textblock
en: The source package synopsis, extracted from the source stanza B<Description> field, if it exists (since dpkg 1.19.0).
pt: O resumo do pacote fonte, extraído do campo B<Description> da estrofe fonte, se existir (desde dpkg 1.19.0).

note: type: textblock
en: The source package extended description, extracted from the source stanza B<Description> field, if it exists (since dpkg 1.19.0).
pt: A descrição extensa do pacote fonte, extraída do campo B<Description> da estrofe fonte, se existir (desde dpkg 1.19.0).

note: type: textblock
en: The approximate total size of the package's installed files.  This value is copied into the corresponding control file field; setting it will modify the value of that field.  If this variable is not set B<dpkg-gencontrol> will compute the default value by accumulating the size of each regular file and symlink rounded to 1 KiB used units, and a baseline of 1 KiB for any other filesystem object type.  With hardlinks only being counted once as a regular file.
pt: O tamanho total aproximado dos ficheiros instalados pelo pacote. Este valor é copiado para o campo do ficheiro de controle correspondente, defini-lo irá modificar o valor desse campo. Se esta variável não for definida, B<dpkg-gencontrol> irá computar o valor predefinido ao acumular o tamanho de cada ficheiro regular e link simbólico arredondando as unidades usadas para egular file and 1 KiB, e uma base de 1 KiB para qualquer outro tipo de objecto de sistema de ficheiros. Com os hardlinks a serem contados apenas uma vez como um ficheiro regular.

note: type: textblock
en: B<Note>: Take into account that this can only ever be an approximation, as the actual size used on the installed system will depend greatly on the filesystem used and its parameters, which might end up using either more or less space than the specified in this field.
pt: B<Nota>: Tenha em conta que isto só pode ser uma aproximação, pois o tamanho real usado no sistema instalado irá depender grandemente do sistema de ficheiros usado e dos seu parâmetros, o que pode acabar a usar mais ou menos espaço que aquele especificado neste campo.

note: type: textblock
en: Additional disk space used when the package is installed.  If this variable is set its value is added to that of the B<Installed-Size> variable (whether set explicitly or using the default value) before it is copied into the B<Installed-Size> control file field.
pt: Espaço de disco usado adicional quando o pacote é instalado. Se esta variável for definida o seu valor é adicionado àquele da variável B<Installed-Size> variable (quer definido explicitamente ou usando o valor predefinido), antes de ser copiado para p campo de ficheiro de controle B<Installed-Size>.

note: type: textblock
en: The value of the source stanza field I<field-name> (which must be given in the canonical capitalization; since dpkg 1.18.11).  Setting these variables has no effect other than on places where they are expanded explicitly.  These variables are only available when generating binary control files.
pt: O valor do campo I<field-name> da estrofe fonte (o qual deve ser dado em na capitalização canonical, desde dpkg 1.18.11). Definir estas variáveis não tem efeito para além de em lugares onde elas são explicitamente expandidas. Estas variáveis estão apenas disponíveis quando se geram ficheiros de controle binários.

note: type: textblock
en: The value of the output field I<field-name> (which must be given in the canonical capitalization).  Setting these variables has no effect other than on places where they are expanded explicitly.
pt: O valor do campo I<field-name> resultante (o qual deve ser dado em na capitalização canonical). Definir estas variáveis não tem efeito para além de em lugares onde elas são explicitamente expandidas.

note: type: textblock
en: The B<.changes> file format version generated by this version of the source packaging scripts.  If you set this variable the contents of the B<Format> field in the B<.changes> file will change too.
pt: A versão do formato de ficheiro B<.changes> gerada por esta versão de scripts de empacotamento de fonte. Se você definir esta variável, o conteúdo do campo B<Format> no ficheiro B<.changes> irá alterar também.

note: type: textblock
en: These variables each hold the corresponding character.
pt: Cada uma destas variáveis detêm o caractere correspondente.

note: type: textblock
en: Variable settings with names of this form are generated by B<dpkg-shlibdeps>.
pt: Definições de variáveis com nomes neste formato são geradas pelo B<dpkg-shlibdeps>.

note: type: textblock
en: The upstream version of dpkg (since dpkg 1.13.19).
pt: A versão de autor do dpkg (desde dpkg 1.13.19).

note: type: textblock
en: The full version of dpkg (since dpkg 1.13.19).
pt: A versão completa do dpkg (desde dpkg 1.13.19).

note: type: textblock
en: List of substitution variables and values.
pt: Lista de variáveis e valores de substituição.

note: type: textblock
en: deb-symbols - Debian's extended shared library information file
pt: deb-symbols - ficheiro de informação de biblioteca partilhada extensiva de Debian

note: type: textblock
en: The symbol files are shipped in Debian binary packages, and its format is a subset of the template symbol files used by L<dpkg-gensymbols(1)> in Debian source packages, see L<deb-src-symbols(5)>.
pt: Os ficheiros symbol são enviados em pacotes binários Debian, e o seu formato é um sub-conjunto dos ficheiros symbol modelo usados por L<dpkg-gensymbols(1)> em pacotes fonte Debian, veja L<deb-src-symbols(5)>.

note: type: textblock
en: The format for an extended shared library dependency information entry in these files is:
pt: O formato para uma entrada de informação de dependência de biblioteca partilhada extensiva nestes ficheiros é:

note: type: textblock
en: The I<library-soname> is exactly the value of the SONAME field as exported by L<objdump(1)>.  A I<dependency-template> is a dependency where I<#MINVER#> is dynamically replaced either by a version check like “(E<gt>= I<minimal-version>)” or by nothing (if an unversioned dependency is deemed sufficient).
pt: O I<library-soname> é exactamente o valor do campo SONAME como exportado por L<objdump(1)>. Um I<dependency-template> é uma dependência onde I<#MINVER#> é substituída dinamicamente seja por uma verificação de versão tipo “(E<gt>= I<minimal-version>)” ou por nada (se uma dependência isenta-de-versão for considerada suficiente).

note: type: textblock
en: Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being “Base” if the library is not versioned) is associated to a I<minimal-version> of its dependency template (the main dependency template is always used and will end up being combined with the dependency template referenced by I<id-of-dependency-template> if present).  The first alternative dependency template is numbered 1, the second one 2, etc.  Each column is separated by exactly a single whitespace.
pt: Cada I<symbol> exportado (listado como I<name>@I<version>, com I<version> sendo “Base” se a biblioteca for isenta-de-versão) estiver associado a um I<minimal-version> do seu modelo de dependência (o modelo de dependência principal é sempre usado e irá acabar sendo combinado com o modelo de dependência referenciado por I<id-of-dependency-template> se presente). O primeiro modelo de dependência alternativa é numerado 1, o segundo 2, etc. Cada coluna é separada por exactamente um único espaço em branco.

note: type: textblock
en: Each entry for a library can also have some fields of meta-information.  Those fields are stored on lines starting with an asterisk.  Currently, the only valid fields are:
pt: Cada entrada para uma biblioteca pode também ter alguns campos de meta-informação. Esses campos são armazenados em linhas que começam com um asterisco. Actualmente, os únicos campos válidos são:

note: type: textblock
en: It indicates the name of the “-dev” package associated to the library and is used by B<dpkg-shlibdeps> to make sure that the dependency generated is at least as strict as the corresponding build dependency (since dpkg 1.14.13).
pt: Indica que o nome do pacote “-dev” associado a um binário associado à biblioteca e é usado por B<dpkg-shlibdeps> para certificar que a dependência gerada é pelo menos tão rigorosa como a dependência de compilação correspondente (desde dpkg 1.14.13).

note: type: textblock
en: The same as B<Build-Depends-Package> but accepts a comma-separated list of package names (since dpkg 1.20.0).  This field will override any B<Build-Depends-Package> field present, and is mostly useful with “-dev” packages and metapackages depending on these, say for a transition period.
pt: O mesmo que B<Build-Depends-Package> mas aceita uma lista separada por virgulas de nomes de pacotes (desde dpkg 1.20.0). Este campo irá sobrepor qualquer campo B<Build-Depends-Package> presente, e é maioritariamente útil com pacotes “-dev” e meta-pacotes dependendo destes, digamos para um período de transição.

note: type: textblock
en: It indicates what internal symbol groups should be ignored, as a whitespace separated list, so that the symbols contained in those groups get included in the output file (since dpkg 1.20.1).  This should only be necessary for toolchain packages providing those internal symbols.  The available groups are system dependent, for ELF and GNU-based systems these are B<aeabi> and B<gomp>.
pt: Indica que grupos de símbolos internos deverão ser ignorados, como uma lista separada por espaços em branco, para que os símbolos contidos nesses grupos sejam incluídos no ficheiro resultante (desde dpkg 1.20.1). Isto só deve ser necessário para pacotes ferramenta-cadeia que providenciem esses símbolos internos. Os grupos disponíveis são dependentes do sistema, para ELF e sistemas baseados em GNU estes são B<aeabi> e B<gomp>.

note: type: textblock
en: A deprecated alias for B<Allow-Internal-Symbol-Groups> (since dpkg 1.20.1, supported since dpkg 1.17.6).
pt: Um alias descontinuado para B<Allow-Internal-Symbol-Groups> (desde dpkg 1.20.1, suportado desde dpkg 1.17.6).

note: type: =head2
en: Simple symbols file
pt: Ficheiro symbols simples

note: type: =head2
en: Advanced symbols file
pt: Ficheiro symbols avançado

note: type: textblock
en: deb-triggers - package triggers
pt: deb-triggers - triggers de pacote

note: type: textblock
en: A package declares its relationship to some trigger(s) by including a I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during package creation).
pt: Um pacote declara o seu relacionamento com alguns gatilho(s) ao incluir um ficheiro I<triggers> no seu arquivo de controle (isto é, I<DEBIAN/triggers>) durante a criação do pacote.

note: type: textblock
en: This file contains directives, one per line.  Leading and trailing whitespace and everything after the first B<#> on any line will be trimmed, and empty lines will be ignored.
pt: Este ficheiro contem directivas, uma por linha. Os espaços em branco no inicio e final e tudo para lá do primeiro B<#> em qualquer linha serão cortados, e as linhas vazias serão ignoradas.

note: type: textblock
en: The trigger control directives currently supported are:
pt: As directivas de controle de trigger actualmente suportadas são:

note: type: textblock
en: Specifies that the package is interested in the named trigger.  All triggers in which a package is interested must be listed using this directive in the triggers control file.
pt: Especifica que o pacote está interessado no gatilho nomeado. Todos os gatilhos nos quais um pacote está interessado devem ser listados usando esta directiva no ficheiro de controle triggers.

note: type: textblock
en: The “await” variants put the triggering package in triggers-awaited state depending on how the trigger was activated.  The “noawait” variant does not put the triggering packages in triggers-awaited state, even if the triggering package declared an “await” activation (either with an B<activate-await> or B<activate> directive, or by using the B<dpkg-trigger> B<--no-await> command-line option).  The “noawait” variant should be used when the functionality provided by the trigger is not crucial.
pt: As variantes “await” põem o pacote desencadeador em estado de espera-por-gatilho dependendo de como o gatilho foi activado. A variante “noawait” não põe os pacotes desencadeadores em estado de espera-por-gatilho, mesmo se o pacote desencadeador declarou uma activação “await” (seja com uma directiva  B<activate-await> ou B<activate>, ou ao usar a opção de linha de comandos B<dpkg-trigger> B<--no-await>). A variante “noawait” deve ser usada quando a funcionalidade disponibilizada pelo gatilho não é crucial.

note: type: textblock
en: Arranges that changes to this package's state will activate the specified trigger.  The trigger will be activated at the start of the following operations: unpack, configure, remove (including for the benefit of a conflicting package), purge and deconfigure.
pt: Faz com que alterações no estado deste pacote irão activar o gatilho especificado. O gatilho será activado no inicio das seguintes operações: desempacotar, configurar, remover (incluindo para o benefício de um pacote em conflito), purgar e desconfigurar.

note: type: textblock
en: The “await” variants only put the triggering package in triggers-awaited state if the interest directive is also “await”.  The “noawait” variant never puts the triggering packages in triggers-awaited state.  The “noawait” variant should be used when the functionality provided by the trigger is not crucial.
pt: As variantes “await” apenas põem o pacote desencadeador em estado de esperar-por-gatilhos se a directiva de interessa for também “await”. A variante  "noawait” nunca põe os pacotes desencadeadores em estado de esperar-por-gatilhos. A variante “noawait” deve ser usada quando a funcionalidade disponibilizada pelo gatilho não é crucial.

note: type: textblock
en: If this package disappears during the unpacking of another package the trigger will be activated when the disappearance is noted towards the end of the unpack.  Trigger processing, and transition from triggers-awaited to installed, does not cause activations.  In the case of unpack, triggers mentioned in both the old and new versions of the package will be activated.
pt: Se este pacote desaparecer durante o desempacotar de outro pacote, o gatilho será activado quando o desaparecimento é notado no final do desempacotamento. O processamento do gatilho, e a transição de esperar-por-gatilho para instalado, não causam activações. No caso de desempacotamento, serão activados os gatilhos mencionados em ambas versões velhas e novas do pacote.

note: type: textblock
en: Unknown directives are an error which will prevent installation of the package.
pt: Directivas desconhecidas são um erro que irá impedir a instalação do pacote.

note: type: textblock
en: The “-noawait” variants should always be favored when possible since triggering packages are not put in triggers-awaited state and can thus be immediately configured without requiring the processing of the trigger.  If the triggering packages are dependencies of other upgraded packages, it will avoid an early trigger processing run and make it possible to run the trigger only once as one of the last steps of the upgrade.
pt: As variantes “-noawait” devem sempre ser favorecidas quando possível pois os pacotes desencadeadores não são postos em estado esperar-por-gatilho e assim podem ser configurados imediatamente sem se requerer o processamento de um gatilho. Se os pacotes desencadeadores forem dependências de outros pacotes actualizados, irá evitar um processamento adiantado de um gatilho e torna possível correr o gatilho apenas num dos últimos passos da actualização.

note: type: textblock
en: The “-noawait” variants are supported since dpkg 1.16.1, and will lead to errors if used with an older dpkg.
pt: As variantes “-noawait” são suportadas desde dpkg 1.16.1, e irão produzir erros se usadas com um dpkg anterior.

note: type: textblock
en: The “-await” alias variants are supported since dpkg 1.17.21, and will lead to errors if used with an older dpkg.
pt: As alias de variantes “-await” são suportadas desde dpkg 1.17.21, e irão produzir erros se usadas com um dpkg anterior.

note: type: textblock
en: When a package provides an B<interest-noawait> directive, any activation will set the triggering package into “noawait” mode, regardless of the awaiting mode requested by the activation (either “await” or “noawait”).  When a package provides an B<interest> or B<interest-await> directive, any activation will set the triggering package into “await” or “noawait“ depending on how it was activated.
pt: Quando um pacote disponibiliza uma directiva B<interest-noawait>, qualquer activação irá colocar o pacote desencadeador em modo “noawait”, independentemente do modo de espera requisitado pela activação (seja “await” ou “noawait”). Quando um pacote disponibiliza uma directiva B<interest> ou B<interest-await>, qualquer activação irá coloca ro pacote desencadeador em modo “await” ou “noawait“ dependendo do modo como foi activado.

note: type: textblock
en: deb-version - Debian package version number format
pt: deb-version - formato Debian do número de versão do pacote

note: type: textblock
en: Version numbers as used for Debian binary and source packages consist of three components.  These are:
pt: Os números de versões como usados para pacotes binário e fonte Debian consistem de três componentes. Estes são:

note: type: textblock
en: This is a single (generally small) unsigned integer.  It may be omitted, in which case zero is assumed.  If it is omitted then the I<upstream-version> may not contain any colons.
pt: Este é um único (geralmente pequeno) inteiro não assinado. Pode ser omitido, o que em tal caso é assumido zero. Se for omitido então a I<versão-do-autor> pode não conter nenhuns dois pontos (:).

note: type: textblock
en: It is provided to allow mistakes in the version numbers of older versions of a package, and also a package's previous version numbering schemes, to be left behind.
pt: É fornecido para permitir enganos nos números de versão de versões antigas de um pacote, e também esquemas de numeração de versões antigas de um pacote, para se deixar para trás.

note: type: textblock
en: This is the main part of the version number.  It is usually the version number of the original (“upstream”)  package from which the I<.deb> file has been made, if this is applicable.  Usually this will be in the same format as that specified by the upstream author(s); however, it may need to be reformatted to fit into the package management system's format and comparison scheme.
pt: Esta é a parte principal no número de versão. É geralmente o número de versão do pacote original (do autor) a partir do qual p ficheiro I<.deb> foi feito, se isto for aplicável. Geralmente isto ficará no mesmo formato que aquele especificado pelo autor original, no entanto, pode precisar de ser reformatado para se ajustar ao formato do sistema de gestão de pacotes e esquema de comparação.

note: type: textblock
en: The comparison behavior of the package management system with respect to the I<upstream-version> is described below.  The I<upstream-version> portion of the version number is mandatory.
pt: O comportamento comparativo do sistema de gestão de pacotes com respeito a I<upstream-version> é descrito abaixo. A porção I<upstream-version> do número de versão é obrigatória.

note: type: textblock
en: The I<upstream-version> may contain only alphanumerics (“A-Za-z0-9”) and the characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) and should start with a digit.  If there is no I<debian-revision> then hyphens are not allowed; if there is no I<epoch> then colons are not allowed.
pt: O I<upstream-version> apenas pode conter alfanuméricos (“A-Za-z0-9”) e os caracteres B<.> B<+> B<-> B<:> B<~> (ponto, mais, hífen, dois pontos, til) e deve começar com um digito. Se não existir nenhum I<debian-revision> então os hífens não são permitidos, se não existir nenhum I<epoch> então símbolos dois pontos não são permitidos.

note: type: textblock
en: This part of the version number specifies the version of the Debian package based on the upstream version.  It may contain only alphanumerics and the characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the same way as the I<upstream-version> is.
pt: Esta parte do número de versão especifica a versão do pacote Debian baseada na versão do autor. Só pode conter alfanuméricos e os caracteres B<+> B<.> B<~> (mais, ponto, til) e é comparado do mesmo modo que I<upstream-version> é.

note: type: textblock
en: It is optional; if it isn't present then the I<upstream-version> may not contain a hyphen.  This format represents the case where a piece of software was written specifically to be turned into a Debian package, and so there is only one “debianization” of it and therefore no revision indication is required.
pt: É opcional; se não estiver presente então o I<upstream-version> não pode conter um hífen. Este formato representa o caso onde um pedaço de software foi escrito especificamente para ser tornado num pacote Debian, e assim há apenas uma “debianizaçao” dele e assim sendo não é requerido nenhuma indicação de revisão.

note: type: textblock
en: It is conventional to restart the I<debian-revision> at ‘1’ each time the I<upstream-version> is increased.
pt: É convencional reiniciar a I<revisão-debian> a ‘1’ cada vez que a I<versão-do-autor> é incrementada.

note: type: textblock
en: Dpkg will break the version number apart at the last hyphen in the string (if there is one) to determine the I<upstream-version> and I<debian-revision>.  The absence of a I<debian-revision> compares earlier than the presence of one (but note that the I<debian-revision> is the least significant part of the version number).
pt: O dpkg irá separar o número de versão pelo último hífen da string (se existir um) para determinar I<upstream-version> e I<debian-revision>. A ausência de I<debian-revision> é comparada antes da presença de uma (mas note que I<debian-revision> é a parte menos significante do número da versão).

note: type: =head2
en: Sorting algorithm
pt: Algoritmo de ordenar

note: type: textblock
en: The I<upstream-version> and I<debian-revision> parts are compared by the package management system using the same algorithm:
pt: As partes I<versão-do-autor> e I<revisão-debian> são comparadas pelo sistema de gestão de pacotes usando o mesmo algoritmo:

note: type: textblock
en: The strings are compared from left to right.
pt: As strings são comparadas da esquerda para a direita.

note: type: textblock
en: First the initial part of each string consisting entirely of non-digit characters is determined.  These two parts (one of which may be empty) are compared lexically.  If a difference is found it is returned.  The lexical comparison is a comparison of ASCII values modified so that all the letters sort earlier than all the non-letters and so that a tilde sorts before anything, even the end of a part.  For example, the following parts are in sorted order: ‘~~’, ‘~~a’, ‘~’, the empty part, ‘a’.
pt: Primeiro é determinada a parte inicial de cada string consistindo inteiramente de caracteres não-dígitos. Estas duas partes (uma delas pode estar vazia) são comparadas lexicamente. Se uma diferença for encontrada, é retornada. A comparação léxica é uma comparação de valores ASCII modificados para que todas as letras fiquem organizadas antes das não-letras e assim para que um título fique organizado antes de tudo, mesmo do final de uma parte. Por exemplo, as seguintes partes estão organizadas em ordem: ‘~~’, ‘~~a’, ‘~’, a parte vazia, ‘a’.

note: type: textblock
en: Then the initial part of the remainder of each string which consists entirely of digit characters is determined.  The numerical values of these two parts are compared, and any difference found is returned as the result of the comparison.  For these purposes an empty string (which can only occur at the end of one or both version strings being compared) counts as zero.
pt: Então é determinada a parte inicial do restante de cada string que consiste inteiramente de caracteres dígitos. Os valores numéricos destas duas partes são comparados, e qualquer diferença encontrada é retornada como resultado da comparação. Para estes objectivos uma string vazia (a qual pode apenas ocorrer no final de uma ou ambas strings de versão a serem comparadas) conta como zero.

note: type: textblock
en: These two steps (comparing and removing initial non-digit strings and initial digit strings) are repeated until a difference is found or both strings are exhausted.
pt: Estes dois passos (comparar e remover strings não-dígito iniciais) são repetidos até que seja encontrada uma diferença ou ambas strings estão esgotadas.

note: type: textblock
en: Note that the purpose of epochs is to allow us to leave behind mistakes in version numbering, and to cope with situations where the version numbering scheme changes.  It is B<not> intended to cope with version numbers containing strings of letters which the package management system cannot interpret (such as ‘ALPHA’ or ‘pre-’), or with silly orderings.
pt: Note que o objectivo de épocas é permitir-nos deixar para trás enganos na numeração das versões, e para lidar com situações onde o esquema de numeração da versão mude. B<Não> se destina a lidar com números de versões que contém strings de letras que o sistema de gestão de pacotes não pode interpretar (tais como ‘ALPHA’ ou ‘pre-’), ou com pedidos tolos.

note: type: textblock
en: The tilde character and its special sorting properties were introduced in dpkg 1.10 and some parts of the dpkg build scripts only gained support for it later in the 1.10.x series.
pt: O caractere til e as suas propriedades de organização especiais foi introduzido no dpkg 1.10 e algumas partes dos scripts de compilação do dpkg apenas ganharam suporte para ele nas séries 1.10.x.

note: type: textblock
en: deb - Debian binary package format
pt: deb - Formato Debian de pacotes binários

note: type: textblock
en: The B<.deb> format is the Debian binary package file format.  It is understood since dpkg 0.93.76, and is generated by default since dpkg 1.2.0 and 1.1.1elf (i386/ELF builds).
pt: O formato B<.deb> é o formato de ficheiro de pacote binários Debian. É compreendido deste o dpkg 0.93.76, e é gerado por predefinição desde o dpkg 1.2.0 e 1.1.1elf (i386/compilações ELF).

note: type: textblock
en: The format described here is used since Debian 0.93; details of the old format are described in L<deb-old(5)>.
pt: O formato descrito aqui é usado desde Debian 0.93; detalhes do formato antigo estão descritos em L<deb-old(5)>.

note: type: textblock
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  Only the common B<ar> archive format is supported, with no long file name extensions, but with file names containing an optional trailing slash, which limits their length to 15 characters (from the 16 allowed).  File sizes are limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 MiB member files.
pt: O ficheiro é um arquivo B<ar> com um valor mágico de B<!E<lt>archE<gt>>. Apenas é suportado o formato de arquivo B<ar> comum, sem extensões longas de nome de ficheiro, mas com nomes de ficheiro que contêm uma barra invertida opcional, o que limita o seu comprimento a 15 caracteres (dos 16 permitidos). Os tamanhos dos ficheiros são limitados a 10 dígitos decimais do ASCII, permitindo aproximadamente 9536.74 MiB de ficheiros membros.

note: type: textblock
en: The B<tar> archives currently allowed are, the old-style (v7) format, the pre-POSIX ustar format, a subset of the GNU format (new style long pathnames and long linknames, supported since dpkg 1.4.1.17; large file metadata since dpkg 1.18.24), and the POSIX ustar format (long names supported since dpkg 1.15.0).  Unrecognized tar typeflags are considered an error.  Each tar entry size inside a tar archive is limited to 11 ASCII octal digits, allowing for up to 8 GiB tar entries.  The GNU large file metadata support permits 95-bit tar entry sizes and negative timestamps, and 63-bit UID, GID and device numbers.
pt: Os arquivos B<tar> actualmente permitidos são, o formato de estilo antigo (v7), o formato ustar pré-POSIX, um subconjunto do formato GNU (nomes de caminho longos e nomes de links longos no novo estilo suportados desde dpkg 1.4.1.17; metadados de ficheiros longos desde dpkg 1.18.24), e o formato ustar do POSIX (nomes longos suportados desde o dpkg 1.15.0). Tipos de flags de tar não reconhecidas são consideradas um erro. Cada tamanho de entrada tar dentro do arquivo tar está limitada a 11 dígitos ASCII em octal, permitindo até 8 GiB de entradas tar. O suporte a metadados de ficheiros longos de GNU permite tamanhos de entrada tar de 95-bit e marcas temporais negativas, e UID de 63-bit, GID e números de dispositivos.

note: type: textblock
en: The first member is named B<debian-binary> and contains a series of lines, separated by newlines.  Currently only one line is present, the format version number, B<2.0> at the time this manual page was written.  Programs which read new-format archives should be prepared for the minor number to be increased and new lines to be present, and should ignore these if this is the case.
pt: O primeiro membro é chamado B<debian-binary> e contém uma série de linhas, separadas por novas linhas. Actualmente está presente apenas uma linha, o número de versão do formato, B<2.0> na altura que este manual foi escrito, Programas que leem arquivos de novo formato deve estar preparados para o número menor estar aumentado e e estarem presentes novas linhas, e devem ignorar estas se for o caso.

note: type: textblock
en: If the major number has changed, an incompatible change has been made and the program should stop.  If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
pt: Se o número maior mudou, foi feita uma mudança incompatível e o programa deverá parar. Se não o fizer, então o programa deve ser capaz de continuar em segurança, a menos que encontre um membro inesperado no arquivo (excepto no fim), como descrito em baixo.

note: type: textblock
en: The second required member is named B<control.tar>.  It is a tar archive containing the package control information, either not compressed (supported since dpkg 1.17.6), or compressed with gzip (with B<.gz> extension) or xz (with B<.xz> extension, supported since 1.17.6), zstd (with B<.zst> extension, supported since dpkg 1.21.18), as a series of plain files, of which the file B<control> is mandatory and contains the core control information, the B<md5sums>, B<conffiles>, B<triggers>, B<shlibs> and B<symbols> files contain optional control information, and the B<preinst>, B<postinst>, B<prerm> and B<postrm> files are optional maintainer scripts.  The control tarball may optionally contain an entry for ‘B<.>’, the current directory.
pt: O segundo membro obrigatório é chamado B<control.tar>. É um arquivo tar que contém a informação de controle do pacote, esteja não comprimido (suportado desde dpkg 1.17.6), ou comprimido com gzip (com extensão B<.gz>) ou xz (com extensão B<.xz>, suportado desde 1.17.6), zstd (com extensão B<.zst>, suportado desde dpkg 1.21.18), como uma série de ficheiros simples, do qual o ficheiro B<control> é obrigatório e contém a informação de controle do núcleo, os ficheiros B<md5sums>, B<conffiles>, B<triggers>, B<shlibs> e B<symbols> contêm informação de controle opcional, e os ficheiros B<preinst>, B<postinst>, B<prerm> e B<postrm> são scripts opcionais do maintainer. O tarbal de controle pode opcionalmente conter uma entrada para ‘B<.>’, o directório actual.

note: type: textblock
en: The third, last required member is named B<data.tar>.  It contains the filesystem as a tar archive, either not compressed (supported since dpkg 1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> extension, supported since dpkg 1.15.6), zstd (with B<.zst> extension, supported since dpkg 1.21.18), bzip2 (with B<.bz2> extension, supported since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported since dpkg 1.13.25).
pt: O terceiro e último membro obrigatório é chamado B<data.tar>. Contém o sistema de ficheiros como um arquivo tar, esteja não comprimido (suportado desde  dpkg 1.10.24), ou comprimido com gzip (com extensão B<.gz>), xz (com extensão B<.xz>, suportado desde dpkg 1.15.6), zstd (com extensão B<.zst> suportado desde dpkg 1.21.18), bzip2 (com extensão B<.bz2>, suportado desde dpkg 1.10.24) ou lzma (com extensão B<.lzma>, suportado desde dpkg 1.13.25).

note: type: textblock
en: These members must occur in this exact order.  Current implementations should ignore any additional members after B<data.tar>.  Further members may be defined in the future, and (if possible) will be placed after these three.  Any additional members that may need to be inserted after B<debian-binary> and before B<control.tar> or B<data.tar> and which should be safely ignored by older programs, will have names starting with an underscore, ‘B<_>’.
pt: Estes membros têm de ocorrer na ordem exacta. As implementações actuais deverão ignorar quaisquer membros adicionais após o B<data.tar>. Podem ser definidos mais membros no futuro, e (se possível) serão colocados após estes três. Quaisquer membros adicionais que possam precisar de serem inseridos após B<debian-binary> e antes de B<control.tar> ou B<data.tar> e que deverão ser seguramente ignorados por programas mais antigos, terão os nomes a começar com um underscore, ‘B<_>’.

note: type: textblock
en: Those new members which won't be able to be safely ignored will be inserted before B<data.tar> with names starting with something other than underscores, or will (more likely) cause the major version number to be increased.
pt: Estes novos membros que não serão capazes de serem ignorados em segurança irão ser inseridos antes de B<data.tar> com nomes que começam com algo diferente de underscores (_), ou irão (mais provavelmente) causar que o número de versão maior seja aumentado.

note: type: =head1
en: MEDIA TYPE
pt: TIPO DE MEDIA

note: type: =head2
en: Current
pt: Corrente

note: type: =head2
en: Deprecated
pt: Descontinuado

note: type: textblock
en: deb822 - Debian RFC822 control data format
pt: deb822 - Formato Debian de dados de controle RFC822

note: type: textblock
en: The package management system manipulates data represented in a common format, known as I<control data>, stored in I<control files>.  Control files are used for source packages, binary packages and the B<.changes> files which control the installation of uploaded files (B<dpkg>'s internal databases are in a similar format).
pt: O sistema de gestão de pacotes manipula dados representados num formato comum, conhecido por I<control data>, guardado em I<control files>. Ficheiros de controle são usados para pacotes fonte, pacotes binários e os ficheiros B<.changes> que controlam a instalação dos ficheiros que foram enviados (as bases de dados internas do B<dpkg> estão num formato semelhante).

note: type: =head1
en: SYNTAX
pt: SINTAXE

note: type: textblock
en: A control file consists of one or more stanzas of fields (the stanzas sometimes used to be referred to as paragraphs).  The stanzas are separated by empty lines.  Parsers may accept lines consisting solely of U+0020 B<SPACE> and U+0009 B<TAB> as stanza separators, but control files should use empty lines.  Some control files allow only one stanza; others allow several, in which case each stanza usually refers to a different package.  (For example, in source packages, the first stanza refers to the source package, and later stanzas refer to binary packages generated from the source.)  The ordering of the stanzas in control files is significant.
pt: Um ficheiro de controle consiste de uma ou mais estrofes de campos (as estrofes são também por vezes referidos como parágrafos). As estrofes são separadas por linhas vazias. Os analisadores podem aceitar linhas consistindo apenas de U+0020 B<SPACE> e U+0009 B<TAB> como separadores de estrofes, mas os ficheiros de controle devem usar linhas vazias. Alguns ficheiros de controle permitem apenas uma estrofe; outros permitem várias, em qualquer caso cada estrofe geralmente faz referência a um pacote diferente. (Por exemplo, em pacotes fonte, a primeira estrofe refere-se ao pacote fonte, e as estrofes posteriores referem-se aos pacotes binários gerados a partir da fonte). A ordem das estrofes em ficheiros de controle é significativa.

note: type: textblock
en: Each stanza consists of a series of data fields.  Each field consists of the field name followed by a colon (U+003A ‘B<:>’), and then the data/value associated with that field.  The field name is composed of US-ASCII characters excluding control characters, space, and colon (i.e., characters in the ranges U+0021 ‘B<!>’ through U+0039 ‘B<9>’, and U+003B ‘B<;>’ through U+007E ‘B<~>’, inclusive).  Field names must not begin with the comment character (U+0023 ‘B<#>’), nor with the hyphen character (U+002D ‘B<->’).
pt: Cada estrofe consiste numa série de campos de dados.. Cada campo consiste do nome do campo seguido pelo símbolo dois pontos (U+003A ‘B<:>’), e depois o dado/valor associado a esse campo. O nome do campo é composto de caracteres US-ASCII excluindo caracteres de controle, espaço, e os dois pontos (isto é, caracteres (i.e., characters de U+0021 ‘B<!>’ até U+0039 ‘B<9>’, e U+003B ‘B<;>’ até U+007E ‘B<~>’, inclusive). Os nomes de campo não podem começar com o caractere de comentar (U+0023 ‘B<#>’), nem com o caractere hífen (U+002D ‘B<->’).

note: type: textblock
en: The field ends at the end of the line or at the end of the last continuation line (see below).  Horizontal whitespace (U+0020 B<SPACE> and U+0009 B<TAB>) may occur immediately before or after the value and is ignored there; it is conventional to put a single space after the colon.  For example, a field might be:
pt: O campo termina no fim da linha ou no fim da última linha de continuação (ver abaixo). Espaço em branco horizontal (U+0020 B<SPACE> e U+0009 B<TAB>) pode ocorrer imediatamente antes ou após do valor e é ignorado la; é convencional colocar um espaço único após os dois pontos. Por exemplo, um campo pode ser:

note: type: textblock
en: the field name is B<Package> and the field value B<dpkg>.
pt: o nome do campo é B<Package> e o valor do campo é B<dpkg>.

note: type: textblock
en: Empty field values are only permitted in source package control files (I<debian/control>).  Such fields are ignored.
pt: Campos com valores vazios são apenas permitidos em ficheiros de controle de pacotes fonte (I<debian/control>). Tais campos são ignorados.

note: type: textblock
en: A stanza must not contain more than one instance of a particular field name.
pt: Uma estrofe não pode conter mas do que uma instância (cópia) de um nome de campo particular.

note: type: textblock
en: There are three types of fields:
pt: Existem três tipos de campos:

note: type: textblock
en: The field, including its value, must be a single line.  Folding of the field is not permitted.  This is the default field type if the definition of the field does not specify a different type.
pt: O campo, incluindo o seu valor, tem de ser uma linha única. Dobrar o campo não é permitido. Este é o tipo de campo predefinido se a definição do campo não especificar um tipo diferente.

note: type: textblock
en: The value of a folded field is a logical line that may span several lines.  The lines after the first are called continuation lines and must start with a U+0020 B<SPACE> or a U+0009 B<TAB>.  Whitespace, including any newlines, is not significant in the field values of folded fields.
pt: O valor de um campo dobrado é uma linha lógica que pode continuar por várias linhas. As linhas após a primeira são chamadas linha de continuação e devem começar com um U+0020 B<SPACE> ou um U+0009 B<TAB>. O espaço em branco, incluindo quaisquer novas linhas, não é significante nos valores de campo de campos dobrados.

note: type: textblock
en: This folding method is similar to RFC5322, allowing control files that contain only one stanza and no multiline fields to be read by parsers written for RFC5322.
pt: O método de dobragem é semelhante a RFC5322, permitido aos ficheiros de controle que contêm apenas uma estrofe e nenhum campo multi-linha serem lidos por programas analisadores escritos para RFC5322.

note: type: textblock
en: The value of a multiline field may comprise multiple continuation lines.  The first line of the value, the part on the same line as the field name, often has special significance or may have to be empty.  Other lines are added following the same syntax as the continuation lines of the folded fields.  Whitespace, including newlines, is significant in the values of multiline fields.
pt: O valor de um campo multi-linha pode comprometer múltiplas linhas de continuação. A primeira linha do valor, a parte na mesma linha que tem o nome do campo, muitas vezes tem um significado especial ou pode precisar de estar vazia. As outras linhas são adicionadas seguindo a mesma sintaxe que as linhas de continuação dos campos dobrados. O espaço em branco, incluindo novas linhas, tem significado nos valores dos campos multi-linha.

note: type: textblock
en: Whitespace must not appear inside names (of packages, architectures, files or anything else) or version numbers, or between the characters of multi-character version relationships.
pt: Em espaço em branco não pode aparecer dentro de nomes (de pacotes, arquitecturas, ficheiros ou tudo o resto) ou números de versão, ou entre os caracteres de relacionamentos de versão multi-caractere.

note: type: textblock
en: The presence and purpose of a field, and the syntax of its value may differ between types of control files.
pt: A presença de objectivo de um campo, e a sintaxe do seu valor pode diferir entre os tipos de ficheiros de controle.

note: type: textblock
en: Field names are not case-sensitive, but it is usual to capitalize the field names using mixed case as shown below.  Field values are case-sensitive unless the description of the field says otherwise.
pt: Os nomes dos campos não são sensíveis a maiúsculas/minúsculas, mas é usual capitalizar os nomes dos campos usando misturas como mostrado em baixo. Os valores do campos são sensíveis a  maiúsculas/minúsculas excepto se a descrição do campo diga o contrário.

note: type: textblock
en: Stanza separators (empty lines) and lines consisting only of U+0020 B<SPACE> and U+0009 B<TAB>, are not allowed within field values or between fields.  Empty lines in field values are usually escaped by representing them by a U+0020 B<SPACE> followed by a dot (U+002E ‘B<.>’).
pt: Separadores de estrofes (linhas vazias) e linhas consistindo apenas de U+0020 B<SPACE> e U+0009 B<TAB>, não são permitidos dentro de valores de campo ou entre campos. Linhas vazias em valores de campo são normalmente escapadas ao representa-las por um U+0020 B<SPACE> seguido de um ponto (U+002E ‘B<.>’).

note: type: textblock
en: Lines starting with U+0023 ‘B<#>’, without any preceding whitespace are comments lines that are only permitted in source package control files (I<debian/control>) and in L<deb-origin(5)> files.  These comment lines are ignored, even between two continuation lines.  They do not end logical lines.
pt: Linhas começadas com U+0023 ‘B<#>’, sem nenhum espaço em branco a preceder são linhas de comentários que são apenas permitidos em ficheiros de controle dos pacotes fonte (I<debian/control>) e em ficheiros L<deb-origin(5)>. Estas linhas de comentários são ignoradas, mesmo entre duas linhas de continuação. Elas não terminam linhas lógicas.

note: type: textblock
en: All control files must be encoded in UTF-8.
pt: Todos os ficheiros de controle têm de estar codificados em UTF-8.

note: type: textblock
en: dpkg-architecture - set and determine the architecture for package building
pt: dpkg-architecture - define e determina a arquitectura para compilação de pacotes

note: type: textblock
en: B<dpkg-architecture> provides a facility to determine and set the build and host architecture for package building.
pt: B<dpkg-architecture> disponibiliza uma habilidade para determinar e definir a arquitectura de compilação e da máquina para compilação de pacotes.

note: type: textblock
en: 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.
pt: 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 L<dpkg(1)>, e não pode ser definida na linha de comandos.

note: type: textblock
en: 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.
pt: 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 L<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.

note: type: =head1
en: COMMANDS
pt: COMANDOS

note: type: textblock
en: Print the environment variables, one each line, in the format I<VARIABLE=value>.  This is the default action.
pt: Escreve as variáveis de ambiente, uma em cada linha, no formato I<VARIÁVEL=valor>. Esta é a acção predefinida.

note: type: textblock
en: Check for equality of architecture (since dpkg 1.13.13).  It compares the current or specified Debian host architecture against I<architecture>, to check if they are equal.  This action will not expand the architecture wildcards.  Command finishes with an exit status of 0 if matched, 1 if not matched.
pt: 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.

note: type: textblock
en: Check for identity of architecture (since dpkg 1.13.13).  It compares the current or specified Debian host architecture against I<architecture-wildcard> after having expanded it as an architecture wildcard, to check if they match.  Command finishes with an exit status of 0 if matched, 1 if not matched.
pt: 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.

note: type: textblock
en: Print the value of a single variable.
pt: Escreve o valor de uma variável única.

note: type: textblock
en: Print an export command.  This can be used to set the environment variables using the POSIX shell or make B<eval>, depending on the output format.
pt: 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.

note: type: textblock
en: Print a similar command to B<--print-set> but to unset all variables.
pt: Escreve um comando semelhante ao B<--print-set> mas para limpar o valor de todas as variáveis.

note: type: textblock
en: Execute a I<command-string> in an environment which has all variables set to the determined value.
pt: Executa uma I<command-string> num ambiente que tem todas as variáveis definidas para o determinado valor.

note: type: textblock
en: If the I<command-string> contains shell metacharacters, then it will be invoked through the system bourne shell.
pt: Se a I<string-de-comando> conter meta-caracteres de shell, então será invocada através da shell limite do sistema.

note: type: textblock
en: Print a list of valid architecture names.  Possibly restricted by one or more of the matching options B<--match-wildcard>, B<--match-bits> or B<--match-endian> (since dpkg 1.17.14).
pt: 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).

note: type: textblock
en: Show the usage message and exit.
pt: Mostra a mensagem de utilização e termina.

note: type: textblock
en: Show the version and exit.
pt: Mostra a versão e termina.

note: type: =head1
en: OPTIONS
pt: OPÇÕES

note: type: textblock
en: Set the host Debian architecture.
pt: Define a arquitectura da máquina Debian

note: type: textblock
en: Set the host GNU system type.
pt: Define o tipo de sistema GNU da máquina.

note: type: textblock
en: Set the target Debian architecture (since dpkg 1.17.14).
pt: Define a arquitectura Debian de destino (desde dpkg 1.17.14).

note: type: textblock
en: Set the target GNU system type (since dpkg 1.17.14).
pt: Define o tipo de sistema GNU do destino (desde dpkg 1.17.14).

note: type: textblock
en: Restrict the architectures listed by B<--list-known> to ones matching the specified architecture wildcard (since dpkg 1.17.14).
pt: Restringe as arquitectura listadas por B<--list-known> a aquelas que correspondem à wildcard de arquitectura especificada (desde dpkg 1.17.14).

note: type: textblock
en: Restrict the architectures listed by B<--list-known> to ones with the specified CPU bits (since dpkg 1.17.14).  Either B<32> or B<64>.
pt: 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>.

note: type: textblock
en: Restrict the architectures listed by B<--list-known> to ones with the specified endianness (since dpkg 1.17.14).  Either B<little> or B<big>.
pt: 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>.

note: type: textblock
en: Sets the output format for B<--print-set> and B<--print-unset> (since dpkg 1.20.6), to either B<shell> (default) or B<make>.
pt: 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>.

note: type: textblock
en: 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)>).
pt: 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 L<dpkg-buildpackage(1)>).

note: type: =head1
en: TERMS
pt: TERMOS

note: type: =item
en: build machine
pt: máquina de compilação

note: type: textblock
en: The machine the package is built on.
pt: A máquina onde o pacote é compilado.

note: type: =item
en: host machine
pt: máquina anfitriã

note: type: textblock
en: The machine the package is built for.
pt: A máquina para onde o pacote é compilado.

note: type: =item
en: target machine
pt: máquina destino (alvo)

note: type: textblock
en: The machine the compiler is building for, or the emulator will run code for.  This is only needed when building a cross-toolchain (or emulator), one that will be built on the build architecture, to be run on the host architecture, and to build (or run emulated) code for the target architecture.
pt: 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.

note: type: =item
en: Debian architecture
pt: Arquitectura Debian

note: type: textblock
en: The Debian architecture string, which specifies the binary tree in the FTP archive.  Examples: i386, sparc, hurd-i386.
pt: A string de arquitectura Debian, a qual especifica a árvore binária no arquivo FTP. Exemplos: i386, sparc, hurd-i386.

note: type: =item
en: Debian architecture tuple
pt: Tuple de arquitectura Debian

note: type: textblock
en: A Debian architecture tuple is the fully qualified architecture with all its components spelled out.  This differs with Debian architectures in that at least the I<cpu> component does not embed the I<abi>.  The current tuple has the form I<abi>-I<libc>-I<os>-I<cpu>.  Examples: base-gnu-linux-amd64, eabihf-musl-linux-arm.
pt: 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.

note: type: =item
en: Debian architecture wildcard
pt: Wildcard de arquitectura Debian

note: type: textblock
en: A Debian architecture wildcard is a special architecture string that will match any real architecture being part of it.  The general form is a Debian architecture tuple with four or less elements, and with at least one of them being B<any>.  Missing elements of the tuple are prefixed implicitly as B<any>, and thus the following pairs are equivalent:
pt: 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:

note: type: textblock
en: Examples: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any.
pt: Exemplos: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any.

note: type: =item
en: GNU system type
pt: Tipo de sistema GNU

note: type: textblock
en: An architecture specification string consisting of two parts separated by a hyphen: cpu and system.  Examples: i586-linux-gnu, sparc-linux-gnu, i686-gnu, x86_64-netbsd.
pt: 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.

note: type: textblock
en: The clarified GNU system type, used for filesystem paths.  This triplet does not change even when the baseline ISA gets bumped, so that the resulting paths are stable over time.  The only current difference with the GNU system type is that the CPU part for i386 based systems is always i386.  Examples: i386-linux-gnu, x86_64-linux-gnu.  Example paths: /lib/powerpc64le-linux-gnu/, /usr/lib/i386-kfreebsd-gnu/.
pt: 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/.

note: type: =head1
en: VARIABLES
pt: VARIÁVEIS

note: type: textblock
en: The following variables are read from the environment (unless B<--force> has been specified) and set by B<dpkg-architecture> (see the B<TERMS> section for a description of the naming scheme):
pt: 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):

note: type: textblock
en: The Debian architecture of the build machine.
pt: A arquitectura Debian da máquina de compilação.

note: type: textblock
en: The Debian ABI name of the build machine (since dpkg 1.18.11).
pt: O nome ABI Debian da máquina de compilação (desde dpkg 1.18.11).

note: type: textblock
en: The Debian libc name of the build machine (since dpkg 1.18.11).
pt: O nome libc Debian da máquina de compilação (desde dpkg 1.18.11).

note: type: textblock
en: The Debian system name of the build machine (since dpkg 1.13.2).
pt: O nome de sistema Debian da máquina de compilação (desde dpkg 1.13.2).

note: type: textblock
en: The Debian CPU name of the build machine (since dpkg 1.13.2).
pt: O nome de CPU de Debian da máquina de compilação (desde dpkg 1.13.2).

note: type: textblock
en: The pointer size of the build machine (in bits; since dpkg 1.15.4).
pt: O tamanho do ponteiro da máquina de compilação (em bits, desde dpkg 1.15.4).

note: type: textblock
en: The endianness of the build machine (little / big; since dpkg 1.15.4).
pt: A classe endian da máquina de compilação (ittle / big; desde dpkg 1.15.4).

note: type: textblock
en: The GNU CPU part of B<DEB_BUILD_GNU_TYPE>.
pt: A parte CPU GNU de B<DEB_BUILD_GNU_TYPE>.

note: type: textblock
en: The GNU system part of B<DEB_BUILD_GNU_TYPE>.
pt: A parte de system GNU de B<DEB_BUILD_GNU_TYPE>.

note: type: textblock
en: The GNU system type of the build machine.
pt: O tipo de sistema GNU da máquina de compilação.

note: type: textblock
en: The clarified GNU system type of the build machine, used for filesystem paths (since dpkg 1.16.0).
pt: O tipo de sistema GNU clarificado da máquina de compilação, usado para caminhos do sistema de ficheiros (desde dpkg 1.16.0).

note: type: textblock
en: The Debian architecture of the host machine.
pt: A arquitectura Debian da máquina anfitriã.

note: type: textblock
en: The Debian ABI name of the host machine (since dpkg 1.18.11).
pt: O nome ABI Debian da máquina anfitriã (desde dpkg 1.18.11).

note: type: textblock
en: The Debian libc name of the host machine (since dpkg 1.18.11).
pt: O nome libc Debian da máquina anfitriã (desde dpkg 1.18.11).

note: type: textblock
en: The Debian system name of the host machine (since dpkg 1.13.2).
pt: O nome de sistema Debian da máquina anfitriã (desde dpkg 1.13.2).

note: type: textblock
en: The Debian CPU name of the host machine (since dpkg 1.13.2).
pt: O nome de CPU de Debian da máquina anfitriã (desde dpkg 1.13.2).

note: type: textblock
en: The pointer size of the host machine (in bits; since dpkg 1.15.4).
pt: O tamanho do ponteiro da máquina anfitriã (em bits, desde dpkg 1.15.4).

note: type: textblock
en: The endianness of the host machine (little / big; since dpkg 1.15.4).
pt: A classe endian da máquina anfitriã (ittle / big; desde dpkg 1.15.4).

note: type: textblock
en: The GNU CPU part of B<DEB_HOST_GNU_TYPE>.
pt: A parte CPU GNU de B<DEB_HOST_GNU_TYPE>.

note: type: textblock
en: The GNU system part of B<DEB_HOST_GNU_TYPE>.
pt: A parte de system GNU de B<DEB_HOST_GNU_TYPE>.

note: type: textblock
en: The GNU system type of the host machine.
pt: O tipo de sistema GNU da máquina anfitriã.

note: type: textblock
en: The clarified GNU system type of the host machine, used for filesystem paths (since dpkg 1.16.0).
pt: O tipo de sistema GNU clarificado da máquina anfitriã, usado para caminhos do sistema de ficheiros (desde dpkg 1.16.0).

note: type: textblock
en: The Debian architecture of the target machine (since dpkg 1.17.14).
pt: A arquitectura Debian da máquina de destino (desde dpkg 1.17.14).

note: type: textblock
en: The Debian ABI name of the target machine (since dpkg 1.18.11).
pt: O nome ABI Debian da máquina alvo (desde dpkg 1.18.11).

note: type: textblock
en: The Debian libc name of the target machine (since dpkg 1.18.11).
pt: O nome libc Debian da máquina alvo (desde dpkg 1.18.11).

note: type: textblock
en: The Debian system name of the target machine (since dpkg 1.17.14).
pt: O nome de sistema Debian da máquina de destino (desde dpkg 1.17.14).

note: type: textblock
en: The Debian CPU name of the target machine (since dpkg 1.17.14).
pt: O nome de CPU de Debian da máquina de destino (desde dpkg 1.17.14).

note: type: textblock
en: The pointer size of the target machine (in bits; since dpkg 1.17.14).
pt: O tamanho do ponteiro da máquina de destino (em bits, desde dpkg 1.17.14).

note: type: textblock
en: The endianness of the target machine (little / big; since dpkg 1.17.14).
pt: A classe endian da máquina de destino (ittle / big; desde dpkg 1.17.14).

note: type: textblock
en: The GNU CPU part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14).
pt: A parte CPU GNU de B<DEB_TARGET_GNU_TYPE> (desde dpkg 1.17.14).

note: type: textblock
en: The GNU system part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14).
pt: A parte de system GNU de B<DEB_TARGET_GNU_TYPE> (desde dpkg 1.17.14).

note: type: textblock
en: The GNU system type of the target machine (since dpkg 1.17.14).
pt: O tipo de sistema GNU da máquina de destino (desde dpkg 1.17.14).

note: type: textblock
en: The clarified GNU system type of the target machine, used for filesystem paths (since dpkg 1.17.14).
pt: O tipo de sistema GNU clarificado da máquina de destino, usado para caminhos do sistema de ficheiros (desde dpkg 1.17.14).

note: type: =head2
en: Architecture tables
pt: Tabelas de arquitecturas

note: type: textblock
en: All these files have to be present for B<dpkg-architecture> to work.  Their location can be overridden at runtime with the environment variable B<DPKG_DATADIR>.  These tables contain a format B<Version> pseudo-field on their first line to mark their format, so that parsers can check if they understand it, such as "# Version=1.0".
pt: 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".

note: type: textblock
en: Table of known CPU names and mapping to their GNU name.  Format version 1.0 (since dpkg 1.13.2).
pt: 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).

note: type: textblock
en: Table of known operating system names and mapping to their GNU name.  Format version 2.0 (since dpkg 1.18.11).
pt: 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).

note: type: textblock
en: Mapping between Debian architecture tuples and Debian architecture names.  Format version 1.0 (since dpkg 1.18.11).
pt: Mapeamento entre tuples de arquitectura Debian e nomes de arquitectura Debian. Versão de formato 1.0 (desde dpkg 1.18.11).

note: type: textblock
en: Table of Debian architecture ABI attribute overrides.  Format version 2.0 (since dpkg 1.18.11).
pt: Tabela de sobreposições de atributos ABI de arquitectura Debian. Versão de formato 2.0 (desde dpkg 1.18.11).

note: type: =head2
en: Packaging support
pt: Suporte a empacotamento

note: type: textblock
en: Makefile snippet that properly sets and exports all the variables that B<dpkg-architecture> outputs (since dpkg 1.16.1).
pt: 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).

note: type: textblock
en: B<dpkg-buildpackage> accepts the B<-a> option and passes it to B<dpkg-architecture>.  Other examples:
pt: B<dpkg-buildpackage> aceita a opção B<-a> e passa-a para B<dpkg-architecture>. Outros exemplos:

note: type: textblock
en: Check if the current or specified host architecture is equal to an architecture:
pt: Verifica se a arquitectura actual ou da máquina especificada é igual a uma arquitectura:

note: type: textblock
en: Check if the current or specified host architecture is a Linux system:
pt: Verifica se a arquitectura actual ou da máquina especificada é um sistema Linux.

note: type: =head2
en: Usage in debian/rules
pt: Utilização em debian/rules

note: type: textblock
en: The environment variables set by B<dpkg-architecture> are passed to I<debian/rules> as make variables (see make documentation).  However, you should not rely on them, as this breaks manual invocation of the script.  Instead, you should always initialize them using B<dpkg-architecture> with the B<-q> option.  Here are some examples, which also show how you can improve the cross compilation support in your package:
pt: 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:

note: type: textblock
en: Retrieving the GNU system type and forwarding it to ./configure:
pt: Obter o tipo de sistema GNU e reencaminha-lo para ./configure:

note: type: verbatim
en:  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)
pt:  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)

note: type: textblock
en: Doing something only for a specific architecture:
pt: Fazer algo apenas para uma arquitectura específica:

note: type: textblock
en: or if you only need to check the CPU or OS type, use the B<DEB_HOST_ARCH_CPU> or B<DEB_HOST_ARCH_OS> variables.
pt: 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: type: textblock
en: Note that you can also rely on an external Makefile snippet to properly set all the variables that B<dpkg-architecture> can provide:
pt: 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.

note: type: textblock
en: In any case, you should never use B<dpkg --print-architecture> to get architecture information during a package build.
pt: 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.

note: type: =head1
en: ENVIRONMENT
pt: AMBIENTE

note: type: textblock
en: If set, it will be used as the B<dpkg> data directory, where the architecture tables are located (since dpkg 1.14.17).  Defaults to «%PKGDATADIR%».
pt: 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%».

note: type: textblock
en: Sets the color mode (since dpkg 1.18.5).  The currently accepted values are: B<auto> (default), B<always> and B<never>.
pt: Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites são: B<auto> (predefinido), B<always> e B<never>.

note: type: textblock
en: If set, it will be used to decide whether to activate Native Language Support, also known as internationalization (or i18n) support (since dpkg 1.19.0).  The accepted values are: B<0> and B<1> (default).
pt: 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).

note: type: textblock
en: All long command and option names available only since dpkg 1.17.17.
pt: Todos comandos e nomes de opções longos disponíveis apenas desde dpkg 1.17.17.

note: type: textblock
en: dpkg-build-api - source package dpkg build API level
pt: dpkg-build-api - nível API de compilação do dpkg de pacote fonte

note: type: textblock
en: The source package dpkg build API level, defines a versioned interface for source packages, where each API level provides specific behaviors and guarantees.
pt: O nível API de compilação dpkg de pacote fonte, define uma interface versionada para pacotes fonte, onde cada nível API fornece comportamentos e garantias específicas.

note: type: textblock
en: These interfaces can then be adopted by packages in a gradual way, and phased out more easily than with global behavior changes.
pt: Estas interfaces pode ser adotadas pelos pacotes num modo gradual, e descontinuadas mais facilmente que com alterações de comportamento globais.

note: type: textblock
en: The declaration of this API level is done through build-dependencies, in one of B<Build-Depends>, B<Build-Depends-Indep> or B<Build-Depends-Arch>, or via the environment variable B<DPKG_BUILD_API>, which will override these if both are present, and might emit a warning in case they are different.
pt: A declaração deste nível API é feita através de build-dependencies, em um de B<Build-Depends>, B<Build-Depends-Indep> ou B<Build-Depends-Arch>, ou via variável de ambiente B<DPKG_BUILD_API>, a qual vai sobrepor estas se ambas estiverem presentes, e pode emitir um aviso no caso de serem diferentes.

note: type: =head1
en: API LEVELS
pt: NÍVEIS DE API

note: type: textblock
en: This level is still under development, and cannot be declared via build-dependencies.
pt: Este nível ainda está em desenvolvimento, e não pode ser declarado via build-dependencies.

note: type: textblock
en: This is the recommended level.  Since dpkg 1.22.0.
pt: Este é o nível recomendado. Desde dpkg 1.22.0.

note: type: textblock
en: Changes from v0 are:
pt: As alterações a partir de v0 são:

note: type: textblock
en: B<dpkg-shlibdeps> no longer uses the B<LD_LIBRARY_PATH> environment variable.  The B<-l> option should be used instead.
pt: B<dpkg-shlibdeps> já não usa a variável de ambiente B<LD_LIBRARY_PATH>. Deve ser usada a opção B<-l> em vez disso.

note: type: textblock
en: B<dpkg-buildpackage> defaults to B<Rules-Requires-Root> value B<no>.  To restore the B<v0> behavior B<Rules-Requires-Root> should be set to B<binary-targets>.
pt: B<dpkg-buildpackage> predefine B<Rules-Requires-Root> para valor B<no>. Para restaurar o comportamento B<v0>, B<Rules-Requires-Root> deve ser definido para B<binary-targets>.

note: type: textblock
en: B<dpkg-buildpackage> expects all required F<debian/rules> targets to be supported and no longer has backwards compatibility fallback code.  The required targets are B<clean>, B<build>, B<build-indep>, B<build-arch>, B<binary-indep> and B<binary-arch>.
pt: B<dpkg-buildpackage> espera que todos os alvos F<debian/rules> requeridos sejam suportados e já não tem mais código de recurso para compatibilidade com versões anteriores. Os alvos requeridos são B<clean>, B<build>, B<build-indep>, B<build-arch>, B<binary-indep> e B<binary-arch>.

note: type: textblock
en: B<vendor.mk> defaults to using B<dpkg_vendor_derives_from_v1> for the B<dpkg_vendor_derives_from> macro.  To restore the B<v0> behavior set B<dpkg_vendor_derives_from> to B<dpkg_vendor_derives_from_v0>.
pt: B<vendor.mk> predefine para usar B<dpkg_vendor_derives_from_v1> para a macro B<dpkg_vendor_derives_from>. Para restaurar o comportamento B<v0> defina B<dpkg_vendor_derives_from> para B<dpkg_vendor_derives_from_v0>.

note: type: textblock
en: B<default.mk> defaults to including B<buildtools.mk>.
pt: B<default.mk> predefine para incluir B<buildtools.mk>.

note: type: textblock
en: This is the current global level, equivalent to not specifying one.  The interfaces and behaviors provided are subject to the normal global interface updates, which tend to require longer deprecation cycles and/or coordinated transitions.
pt: Este é o nível global actual, equivalente a não se especificar um. As interfaces e comportamentos fornecidos são sujeitos às actualizações da interface global normal, o que tende a requerer ciclos de descontinuação mais longos e/ou transições coordenadas.

note: type: textblock
en: dpkg-buildapi - returns the build API level to use during package build
pt: dpkg-buildapi - retorna o nível API de compilação a usar durante a compilação do pacote

note: type: textblock
en: B<dpkg-buildapi> is a tool to retrieve the L<dpkg-build-api(7)> level to use during build of source Debian packages.
pt: B<dpkg-buildapi> é uma ferramenta para obter o nível <dpkg-build-api(7)> a usar durante a compilação de pacotes fonte Debian.

note: type: textblock
en: This program was introduced in dpkg 1.22.0.
pt: Este programa foi introduzido no dpkg 1.22.0.

note: type: textblock
en: Specifies the main source control file to read information from.  The default is F<debian/control>.
pt: Especifica o ficheiro de controle fonte principal de onde ler informação. A predefinição é F<debian/control>.

note: type: textblock
en: The build API level to use.  This is intended to be used internally by the tools executed from F<debian/rules> to avoid having to parse F<debian/control> multiple times, and not to set the global build API level from F<debian/rules>, otherwise build drivers (such as L<dpkg-buildpackage(1)>) cannot access it.
pt: O nível API de compilação a usar. Isto destina-se a ser usado internamente pelas ferramentas executadas a partir de F<debian/rules> para se evitar ter de se analisar F<debian/control> várias vezes, e não para definir o nível API de compilação global de F<debian/rules>, caso contrário as drivers de compilação (como a L<dpkg-buildpackage(1)>) não poderiam aceder a ele.

note: type: textblock
en: Makefile snippet that will parse the build API level.
pt: Trecho do Makefile que irá analisar o nível API de compilação.

note: type: textblock
en: dpkg-buildflags - returns build flags to use during package build
pt: dpkg-buildflags - retorna flags de compilação para usar durante a compilação de pacotes

note: type: textblock
en: B<dpkg-buildflags> is a tool to retrieve compilation flags to use during build of Debian packages.
pt: B<dpkg-buildflags> é uma ferramenta para obter flags de compilação para usar durante a compilação de pacotes Debian.

note: type: textblock
en: The default flags are defined by the vendor but they can be extended/overridden in several ways:
pt: As flags predefinidas são definidas pelo fornecedor mas podem ser estendidas/sobrepostas de várias maneiras:

note: type: textblock
en: system-wide with B<%PKGCONFDIR%/buildflags.conf>;
pt: de todo o sistema com B<%PKGCONFDIR%/buildflags.conf>;

note: type: textblock
en: for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;
pt: para o utilizador actual com B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> onde B<$XDG_CONFIG_HOME> usa por predefinição B<$HOME/.config>;

note: type: textblock
en: temporarily by the user with environment variables (see section L</ENVIRONMENT>);
pt: temporariamente pelo utilizador com variáveis de ambiente (veja a secção L</AMBIENTE>);

note: type: textblock
en: dynamically by the package maintainer with environment variables set via B<debian/rules> (see section L</ENVIRONMENT>).
pt: dinamicamente pelo maintainer do pacote com variáveis de ambiente definidas via B<debian/rules> (veja a secção L</AMBIENTE>).

note: type: textblock
en: The configuration files can contain four types of directives:
pt: Os ficheiros de configuração podem conter quatro tipos de directivas:

note: type: textblock
en: Override the flag named I<flag> to have the value I<value>.
pt: Sobrescreve a flag chamada I<flag> para ter o valor I<valor>.

note: type: textblock
en: Strip from the flag named I<flag> all the build flags listed in I<value>.  Since dpkg 1.16.1.
pt: Despoja da flag chamada I<flag> todas as flags de compilação listadas em I<valor>. Desde dpkg 1.16.1.

note: type: textblock
en: Extend the flag named I<flag> by appending the options given in I<value>.  A space is prepended to the appended value if the flag's current value is non-empty.
pt: Estende a flag chamada I<flag> ao acrescentar as opções dadas em I<valor>. É usado um espaço a preceder o valor acrescentado se o valor da flag actual não estiver vazio.

note: type: textblock
en: Extend the flag named I<flag> by prepending the options given in I<value>.  A space is appended to the prepended value if the flag's current value is non-empty.  Since dpkg 1.16.1.
pt: Estende a flag chamada I<flag> ao precede-la com as opções dadas em I<valor>. É acrescentado um espaço ao valor precedido se o valor da flag actual não estiver vazio. Desde dpkg 1.16.1.

note: type: textblock
en: The configuration files can contain comments on lines starting with a hash (#).  Empty lines are also ignored.
pt: Os ficheiros de configuração podem conter comentários nas linhas que começam com um cardinal (#). As linhas vazias também são ignoradas.

note: type: textblock
en: This program was introduced in dpkg 1.15.7.
pt: Este programa foi introduzido no dpkg 1.15.7.

note: type: textblock
en: Print to standard output all compilation flags and their values.  It prints one flag per line separated from its value by an equal sign (“I<flag>=I<value>”).  This is the default action.
pt: Escreve na saída standard todas as bandeiras de compilação e os seus valores. Escreve uma bandeira por linha separada do seu valor por um sinal de igual ("I<flag>=I<value>"). Esta é a acção predefinida.

note: type: textblock
en: Print the list of flags supported by the current vendor (one per line).  See the L</SUPPORTED FLAGS> section for more information about them.
pt: Escreve a lista das flags suportadas pelo fornecedor actual (uma por cada linha). Veja a secção L</FLAGS SUPORTADAS> para mais informação sobre elas.

note: type: textblock
en: Display any information that can be useful to explain the behavior of B<dpkg-buildflags> (since dpkg 1.16.5): relevant environment variables, current vendor, state of all feature flags.  Also print the resulting compiler flags with their origin.
pt: Mostra qualquer informação que possa ser útil para explicar o comportamento de B<dpkg-buildflags> (desde dpkg 1.16.5): variáveis de ambiente relevantes, fornecedor actual, estado de todas as bandeiras de funcionalidades. Também escreve as bandeira de compilação resultantes com as suas origens.

note: type: textblock
en: This is intended to be run from B<debian/rules>, so that the build log keeps a clear trace of the build flags used.  This can be useful to diagnose problems related to them.
pt: Isto destina-se a ser corrido a partir de B<debian/rules>, para que os relatórios de compilação mantenham um rasto claro das bandeiras de compilação usadas. Isto pode ser útil para diagnosticar problemas relacionados com elas.

note: type: textblock
en: Print to standard output commands that can be used to export all the compilation flags for some particular tool.  If the I<format> value is not given, B<sh> is assumed.  Only compilation flags starting with an upper case character are included, others are assumed to not be suitable for the environment.  Supported formats:
pt: Escreve na saída standard comandos que podem ser usados para exportar todas as bandeiras de compilação para alguma ferramenta particular. Se o valor I<format> não for fornecido, é assumido B<sh>. Apenas são incluídas bandeiras que comecem com um caractere maiúsculo, as outras são assumidas como não apropriadas para o ambiente. Formatos suportados:

note: type: textblock
en: Shell commands to set and export all the compilation flags in the environment.  The flag values are quoted so the output is ready for evaluation by a shell.
pt: Comandos de shell para definir e exportar todas as bandeiras de compilação no ambiente. Os valores das bandeiras são citados para que o resultado esteja pronto para avaliação pela shell.

note: type: textblock
en: Arguments to pass to a build program's command line to use all the compilation flags (since dpkg 1.17.0).  The flag values are quoted in shell syntax.
pt: Argumentos a passar para a linha de comandos dos programas de compilação para se usar todas as bandeiras de compilação (desde dpkg 1.17.0). Os valores das bandeiras são citados na sintaxe da shell.

note: type: textblock
en: This is a legacy alias for B<cmdline>.
pt: Este é um nome alternativo antigo para B<cmdline>.

note: type: textblock
en: Make directives to set and export all the compilation flags in the environment.  Output can be written to a Makefile fragment and evaluated using an B<include> directive.
pt: Faz as directivas definir e exportar todas as bandeiras de compilação no ambiente. O resultado pode ser escrito para o fragmento do Makefile e avaliado usando uma directiva B<include>.

note: type: textblock
en: Print the value of the flag on standard output.  Exits with 0 if the flag is known otherwise exits with 1.
pt: Escreve o valor da flag na saída standard. Termina com 0 se a flag for conhecida, caso contrário termina com 1.

note: type: textblock
en: Print the origin of the value that is returned by B<--get>.  Exits with 0 if the flag is known otherwise exits with 1.  The origin can be one of the following values:
pt: Escreve a origem do valor que é devolvido por B<--get>. Termina com 0 se a flag for conhecida, caso contrário termina com 1. A origem pode ser um dos seguintes valores:

note: type: textblock
en: the original flag set by the vendor is returned;
pt: é devolvida a flag origina definida pelo fornecedor;

note: type: textblock
en: the flag is set/modified by a system-wide configuration;
pt: a flag é definida/modifica por uma configuração de todo o sistema;

note: type: textblock
en: the flag is set/modified by a user-specific configuration;
pt: a flag é definida/modifica por uma configuração específica do utilizador;

note: type: textblock
en: the flag is set/modified by an environment-specific configuration.
pt: a flag é definida/modifica por uma configuração específica do ambiente;

note: type: textblock
en: Print any information that can be useful to explain the behavior of the program: current vendor, relevant environment variables, feature areas, state of all feature flags, whether a feature is handled as a builtin default by the compiler (since dpkg 1.21.14), and the compiler flags with their origin (since dpkg 1.19.0).
pt: Escreve qualquer informação que possa ser útil para explicar o comportamento do programa: fornecedor actual, variáveis de ambiente relevantes, áreas de funcionalidades, estado de todas as bandeiras de funcionalidades, se uma funcionalidade é lidada como uma predefinição de compilação pelo compilador (desde dpkg 1.21.14), a as bandeiras de compilação com as suas origens (desde dpkg 1.19.0).

note: type: textblock
en: For example:
pt: Por exemplo:

note: type: textblock
en: Print the features enabled for a given area (since dpkg 1.16.2).  If the feature is handled (even if only on some architectures) as a builtin default by the compiler, then a B<Builtin> field is printed (since dpkg 1.21.14).  See the L</FEATURE AREAS> section for more details about the currently recognized areas.  Exits with 0 if the area is known otherwise exits with 1.
pt: Escreve as funcionalidades activadas para uma dada área (desde dpkg 1.16.2). Se a funcionalidade é lidada (mesmo que apenas em algumas arquitecturas) como predefinição de compilação pelo compilador, então é escrito um campo B<Builtin> (desde dpkg 1.21.14). Veja a secção L</ÁREAS DE CARACTERÍSTICAS> para mais detalhes. acerca das áreas actualmente reconhecidas. Termina com 0 se a área for conhecida caso contrário termina com 1.

note: type: textblock
en: The output is in RFC822 format, with one section per feature.  For example:
pt: O resultado está em formato RFC822, com uma secção por característica. Por exemplo:

note: type: =head1
en: SUPPORTED FLAGS
pt: FLAGS SUPORTADAS

note: type: textblock
en: Options for the host assembler.  Default value: empty.  Since dpkg 1.21.0.
pt: Opções para o assemblador da máquina. Valor predefinido: vazio. Desde dpkg 1.21.0.

note: type: textblock
en: Options for the host C compiler.  The default value set by the vendor includes B<-g> and the default optimization level (B<-O2> usually, or B<-O0> if the B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>).
pt: Opções para o compilador de C da maquina. O valor predefinido regulado pelo fornecedor inclui B<-g> e o nível de optimização predefinido (geralmente B<-O2>, ou B<-O0> se a variável de ambiente B<DEB_BUILD_OPTIONS> definir I<noopt>).

note: type: textblock
en: Options for the host C preprocessor.  Default value: empty.
pt: Opções para o pré-processador de C da máquina. Valor predefinido: vazio.

note: type: textblock
en: Options for the host C++ compiler.  Same as B<CFLAGS>.
pt: Opções para o compilador de C++ da máquina. O mesmo que B<CFLAGS>.

note: type: textblock
en: Options for the host Objective C compiler.  Same as B<CFLAGS>.  Since dpkg 1.17.7.
pt: Opções para o compilador Objective C da máquina. O mesmo que B<CFLAGS>. Desde dpkg 1.17.7.

note: type: textblock
en: Options for the host Objective C++ compiler.  Same as B<CXXFLAGS>.  Since dpkg 1.17.7.
pt: Opções para o compilador Objective C++ da maquina. O mesmo que B<CXXFLAGS>. Desde dpkg 1.17.7.

note: type: textblock
en: Options for the host D compiler (ldc or gdc).  Since dpkg 1.20.6.
pt: Opções para o compilador D da maquina (ldc ou gdc). Desde dpkg 1.20.6.

note: type: textblock
en: Options for the host Fortran 77 compiler.  A subset of B<CFLAGS>.
pt: Opções para o compilador Fortran 77 da maquina. Um subconjunto de B<CFLAGS>.

note: type: textblock
en: Options for the host Fortran 9x compiler.  Same as B<FFLAGS>.  Since dpkg 1.17.7.
pt: Opções para o compilador Fortran 9x da maquina. O mesmo que B<FFLAGS>. Desde dpkg 1.17.7.

note: type: textblock
en: Options passed to the host compiler when linking executables or shared objects (if the linker is called directly, then B<-Wl> and B<,> have to be stripped from these options).  Default value: empty.
pt: Opções passadas ao compilador da maquina quando faz link a executáveis ou objetos partilhados (se o vinculador (linker) for chamado directamente, então B<-Wl> e B<,> têm de ser cortados destas opções). Valor predefinido: empty.

note: type: textblock
en: Options for the build assembler.  Default value: empty.  Since dpkg 1.22.1.
pt: Opções para o assemblador de compilação. Valor predefinido: vazio. Desde dpkg 1.21.0.

note: type: textblock
en: Options for the build C compiler.  The default value set by the vendor includes B<-g> and the default optimization level (B<-O2> usually, or B<-O0> if the B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>).  Since dpkg 1.22.1.
pt: Opções para o compilador de C de compilação. O valor predefinido regulado pelo fornecedor inclui B<-g> e o nível de optimização predefinido (geralmente B<-O2>, ou B<-O0> se a variável de ambiente B<DEB_BUILD_OPTIONS> definir I<noopt>). Desde dpkg 1.22.1.

note: type: textblock
en: Options for the build C preprocessor.  Default value: empty.  Since dpkg 1.22.1.
pt: Opções para o pre-processador C de compilação. Valor predefinido: vazio. Desde dpkg 1.21.0.

note: type: textblock
en: Options for the build C++ compiler.  Same as B<CFLAGS_FOR_BUILD>.  Since dpkg 1.22.1.
pt: Opções para o compilador C++ de compilação. O mesmo que B<CFLAGS_FOR_BUILD>. Desde dpkg 1.22.1.

note: type: textblock
en: Options for the build Objective C compiler.  Same as B<CFLAGS_FOR_BUILD>.  Since dpkg 1.22.1.
pt: Opções para o compilador Objective C de compilação. O mesmo que B<CFLAGS_FOR_BUILD>. Desde dpkg 1.22.1.

note: type: textblock
en: Options for the build Objective C++ compiler.  Same as B<CXXFLAGS_FOR_BUILD>.  Since dpkg 1.22.1.
pt: Opções para o compilador Objective C++ de compilação. O mesmo que B<CXXFLAGS_FOR_BUILD>. Desde dpkg 1.22.1.

note: type: textblock
en: Options for the build D compiler (ldc or gdc).  Since dpkg 1.22.1.
pt: Opções para o compilador D de compilação (ldc ou gdc). Desde dpkg 1.22.1.

note: type: textblock
en: Options for the build Fortran 77 compiler.  A subset of B<CFLAGS_FOR_BUILD>.  Since dpkg 1.22.1.
pt: Opções para o compilador Fortran 77 de compilação. Um subconjunto de B<CFLAGS_FOR_BUILD>. Desde dpkg 1.22.1.

note: type: textblock
en: Options for the build Fortran 9x compiler.  Same as B<FFLAGS_FOR_BUILD>.  Since dpkg 1.22.1.
pt: Opções para o compilador Fortran 9x de compilação. O mesmo que B<FFLAGS_FOR_BUILD>. Desde dpkg 1.22.1.

note: type: textblock
en: Options passed to the build compiler when linking executables or shared objects (if the linker is called directly, then B<-Wl> and B<,> have to be stripped from these options).  Default value: empty.  Since dpkg 1.22.1.
pt: Opções passadas ao compilador da compilação quando faz link a executáveis ou objetos partilhados (se o vinculador (linker) for chamado directamente, então B<-Wl> e B<,> têm de ser cortados destas opções). Valor predefinido: empty. Desde dpkg 1.22.1.

note: type: textblock
en: New flags might be added in the future if the need arises (for example to support other languages).
pt: Podem ser adicionadas novas bandeiras no futuro se a necessidade surgir (por exemplo para suportar outras linguagens).

note: type: =head1
en: FEATURE AREAS
pt: ÁREAS DE CARACTERÍSTICAS

note: type: textblock
en: Feature areas are currently vendor specific, and the ones described below are only recognized on Debian and derivatives.
pt: As áreas de características são actualmente especificadas pelo fornecedor. e as descritas em baixo são reconhecidas apenas em Debian e derivados.

note: type: textblock
en: Each area feature can be enabled and disabled in the B<DEB_BUILD_OPTIONS> and B<DEB_BUILD_MAINT_OPTIONS> environment variable's area value with the ‘B<+>’ and ‘B<->’ modifier.  Following the general syntax of these variables (described in L<dpkg-buildpackage(1)>), multiple feature areas can be specified separated by spaces, where each get feature specifiers as mandatory parameters after an equal sign (‘B<=>’).  The feature specifiers are comma-separated and parsed from left to right, where the settings within the same feature specifier override previous ones, even if the feature specifiers are split across multiple space-separated feature area settings for the same area.
pt: Cada área de característica pode ser activada e desactivada no valor de área das variáveis de ambiente B<DEB_BUILD_OPTIONS> e B<DEB_BUILD_MAINT_OPTIONS> com o modificador ‘B<+>’ e ‘B<->’.  Seguido a sintaxe geral destas variáveis (descritas em L<dpkg-buildpackage(1)>), múltiplas áreas de característica podem ser especificadas separadas por espaços, onde cada uma obtém especificadores de característica como parâmetros obrigatórios após um sinal de igual (‘B<=>’).  Os especificadores de característica são separados por vírgulas e analisados da esquerda para a direita. onde as definições dentro do mesmo especificador de característica sobrepõem as anteriores, mesmo que os especificadores de característica estejam divididos entre várias definições de área de característica separadas por espaços para a mesma área.

note: type: textblock
en: For example, to enable the B<hardening> “pie” feature and disable the “fortify” feature you can do this in B<debian/rules>:
pt: Por exemplo, para activar a característica B<hardening> “pie” e desactivar a característica “fortify” você pode fazer isto no B<debian/rules>:

note: type: textblock
en: The special feature B<all> (valid in any area) can be used to enable or disable all area features at the same time.  Thus disabling everything in the B<hardening> area and enabling only “format” and “fortify” can be achieved with:
pt: A funcionalidade especial B<all> (válida em qualquer área) pode ser usada para activar ou desactivar todas as funcionalidades de área ao mesmo tempo. Assim desactivar tudo na área B<hardening> e activar apenas apenas “format” e “fortify” pode ser obtido com:

note: type: textblock
en: Multiple feature areas can be set:
pt: Podem ser definidas múltiplas áreas de característica:

note: type: textblock
en: The override behavior applies as much to the B<all> special feature, as to specific features, which should allow for composition.  Thus to enable “lfs” in the B<abi> area, and only “pie” and “fortify” in the B<hardening> area, but “format” only when CONDITION is defined, this could be done with:
pt: O comportamento de sobreposição aplica-se tanto à funcionalidade especial B<all>, como a funcionalidades específicas, as quais devem permitir para composição. Assim para activar “lfs” na área B<abi>, e apenas “pie” e “fortify” na área B<hardening>, mas “format” apenas quando CONDITION estiver definida, isto pode ser feito com:

note: type: textblock
en: Several compile-time options (detailed below) can be used to enable features that can change the ABI of a package, but cannot be enabled by default due to backwards compatibility reasons unless coordinated or checked individually.
pt: Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para activar funcionalidades que podem modificar o ABI dum pacote, mas não podem estar activas por predefinição devido a razões de compatibilidade com versões anteriores, a menos que sejam coordenadas ou verificadas individualmente.

note: type: textblock
en: This setting (since dpkg 1.22.0; disabled by default) enables Large File Support on 32-bit architectures where their ABI does not include LFS by default, by adding B<-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64> to B<CPPFLAGS>.
pt: Esta definição (desde dpkg 1.22.00; desactivada por predefinição) activa Suporte Ficheiros Longos em arquitecturas de 32-bit onde o seu ABI não inclui LFS (Large File Support) por predefinição, ao adicionar B<-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64> a B<CPPFLAGS>.

note: type: textblock
en: When this feature is enabled it will override the value from the same feature in the B<future> feature area.
pt: Quando esta funcionalidade é activa irá sobrepor o valor da mesma funcionalidade na área de funcionalidades B<future>.

note: type: textblock
en: If the setting is enabled explicitly then it gets enabled on all architectures including i386 but not hurd-i386 nor kfreebsd-i386 (where the kernel does not have time64 interfaces), ignoring the binary backwards compatibility default.
pt: Se a definição for explicitamente activada então fica activada em todas as arquitecturas incluindo i386 mas não hurd-i386 nem kfreebsd-i386 (onde o kernel não tem interfaces time64), ignorando a compatibilidade predefinida de versões binárias antigas.

note: type: textblock
en: It is also enabled by default by gcc on the armel, armhf, hppa, m68k, mips, mipsel, powerpc and sh4 Debian architectures, where disabling the feature will add instead B<-U_LARGEFILE_SOURCE -U_FILE_OFFSET_BITS -U_TIME_BITS> to B<CPPFLAGS>.
pt: É também activada por predefinição pelo gcc nas arquitecturas Debian armel, armhf, hppa, m68k, mips, mipsel, powerpc e sh4, onde desactivar a funcionalidade irá adicionar então B<-U_LARGEFILE_SOURCE -U_FILE_OFFSET_BITS -U_TIME_BITS> a B<CPPFLAGS>.

note: type: textblock
en: Several compile-time options (detailed below) can be used to enable features that should be enabled by default, but cannot due to backwards compatibility reasons.
pt: Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para activar funcionalidades que deveria estar activadas por predefinição, mas não podem estar por razões de compatibilidade com versões anteriores.

note: type: textblock
en: This setting (since dpkg 1.19.0; disabled by default) is now an alias for the B<lfs> feature in the B<abi> area, use that instead.  The feature from the B<abi> area overrides this setting.
pt: Esta definição (desde dpkg 1.19.0; desactivada por predefinição) é agora um nome alternativo para a funcionalidade B<lfs> na área B<abi>, use esta em vez da anterior. A funcionalidade da ária B<abi> sobrepõe esta definição.

note: type: textblock
en: Several compile-time options (detailed below) can be used to help detect problems in the source code or build system.
pt: Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a detectar no código fonte ou no sistema de compilação.

note: type: textblock
en: This setting (since dpkg 1.17.4; disabled by default) adds any warning option that reliably detects problematic source code.  The warnings are fatal.  The only currently supported flags are B<CFLAGS> and B<CXXFLAGS> with flags set to B<-Werror=array-bounds>, B<-Werror=clobbered>, B<-Werror=implicit-function-declaration> and B<-Werror=volatile-register-var>.
pt: Esta definição (desde dpkg 1.17.4; desactivada por predefinição) adiciona qualquer opção de aviso de detecção de fiabilidade problemática no código fonte. Os avisos são fatais. As únicas bandeiras presentemente suportadas são B<CFLAGS> e B<CXXFLAGS> com bandeiras definidas para B<-Werror=array-bounds>, B<-Werror=clobbered>, B<-Werror=implicit-function-declaration> e B<-Werror=volatile-register-var>.

note: type: textblock
en: This feature handles B<-Werror=implicit-function-declaration> via the B<bug-implicit-func> feature, if that has not been specified.
pt: Esta característica manuseia B<-Werror=implicit-function-declaration> via característica B<bug-implicit-func>, se tal não foi especificado.

note: type: textblock
en: This setting (since dpkg 1.17.14; disabled by default) adds dummy canary options to the build flags, so that the build logs can be checked for how the build flags propagate and to allow finding any omission of normal build flag settings.  The only currently supported flags are B<CPPFLAGS>, B<CFLAGS>, B<OBJCFLAGS>, B<CXXFLAGS> and B<OBJCXXFLAGS> with flags set to B<-D__DEB_CANARY_>I<flag>_I<random-id>B<__>, and B<LDFLAGS> set to B<-Wl,-z,deb-canary->I<random-id>.
pt: Esta definição (desde dpkg 1.17.14; desactivada por predefinição) adiciona opções canary fantoches às bandeiras de compilação, para que os relatórios de compilação possam ser verificados em como as bandeiras de compilação se propagam e para permitir encontrar qualquer omissão de definições normais de bandeiras de compilação. As únicas bandeiras actualmente suportadas são B<CPPFLAGS>, B<CFLAGS>, B<OBJCFLAGS>, B<CXXFLAGS> e B<OBJCXXFLAGS> com bandeiras definidas para B<-D__DEB_CANARY_>I<flag>_I<random-id>B<__>, e B<LDFLAGS> definida para B<-Wl,-z,deb-canary->I<random-id>.

note: type: textblock
en: Several compile-time options (detailed below) can be used to help optimize a resulting binary (since dpkg 1.21.0).  B<Note>: enabling B<all> these options can result in unreproducible binary artifacts.
pt: Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a optimizar um binário resultante (desde dpkg 1.21.0). B<Nota>: ativador B<todas> estas opções pode resultar em artefactos binários não reproduzíveis.

note: type: textblock
en: This setting (since dpkg 1.21.0; disabled by default) enables Link Time Optimization by adding B<-flto=auto -ffat-lto-objects> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS>, B<FCFLAGS> and B<LDFLAGS>.
pt: Esta definição (desde dpkg 1.21.0; desactivada por predefinição) activa Link Time Optimization ao adicionar B<-flto=auto -ffat-lto-objects> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS>, B<FCFLAGS> e B<LDFLAGS>.

note: type: textblock
en: Several compile-time options (detailed below) can be used to help sanitize a resulting binary against memory corruptions, memory leaks, use after free, threading data races and undefined behavior bugs.  B<Note>: these options should B<not> be used for production builds as they can reduce reliability for conformant code, reduce security or even functionality.
pt: Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a higienizar um binário resultante contra corrupções de memória, fugas de memória, utilização após livre, segmentação de dados e bugs de comportamento indefinido.  B<Nota>: estas opções B<não> devem ser usadas para compilações de produção pois elas podem reduzir a confiança na conformidade do código, reduzir a segurança ou mesmo a funcionalidade.

note: type: textblock
en: This setting (since dpkg 1.18.0; disabled by default) adds B<-fsanitize=address> to B<LDFLAGS> and B<-fsanitize=address -fno-omit-frame-pointer> to B<CFLAGS> and B<CXXFLAGS>.
pt: Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona B<-fsanitize=address> a B<LDFLAGS> e B<-fsanitize=address -fno-omit-frame-pointer> a B<CFLAGS> e B<CXXFLAGS>.

note: type: textblock
en: This setting (since dpkg 1.18.0; disabled by default) adds B<-fsanitize=thread> to B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>.
pt: Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona B<-fsanitize=thread> a B<CFLAGS>, B<CXXFLAGS> e B<LDFLAGS>.

note: type: textblock
en: This setting (since dpkg 1.18.0; disabled by default) adds B<-fsanitize=leak> to B<LDFLAGS>.  It gets automatically disabled if either the B<address> or the B<thread> features are enabled, as they imply it.
pt: Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona B<-fsanitize=leak> a B<LDFLAGS>. Fica automaticamente desactivada se as funcionalidades B<address> ou B<thread> estiverem activas, pois elas já implicam isto.

note: type: textblock
en: This setting (since dpkg 1.18.0; disabled by default) adds B<-fsanitize=undefined> to B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>.
pt: Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona B<-fsanitize=undefined> a B<CFLAGS>, B<CXXFLAGS> e B<LDFLAGS>.

note: type: =head2
en: hardening
pt: endurecimento

note: type: textblock
en: Several compile-time options (detailed below) can be used to help harden a resulting binary against memory corruption attacks, or provide additional warning messages during compilation.  Except as noted below, these are enabled by default for architectures that support them.
pt: Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a endurecer um binário resultante contra ataques de corrupção de memória, ou disponibilizar mensagens de aviso adicionais durante a compilação. Excepto como notado em baixo, estas estão activadas por predefinição para as arquitecturas que as suportam.

note: type: textblock
en: This setting (since dpkg 1.16.1; enabled by default) adds B<-Wformat -Werror=format-security> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS> and B<OBJCXXFLAGS>.  This will warn about improper format string uses, and will fail when format functions are used in a way that represent possible security problems.  At present, this warns about calls to B<printf> and B<scanf> functions where the format string is not a string literal and there are no format arguments, as in B<printf(foo);> instead of B<printf("%s", foo);> This may be a security hole if the format string came from untrusted input and contains ‘%n’.
pt: Esta definição (desde dpkg 1.16.1; activada por predefinição) adiciona B<-Wformat -Werror=format-security> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS> e B<OBJCXXFLAGS>.  Isto irá avisar sobre uso de strings de formato impróprias, e irá falhar quando funções de formato forem usadas em modo que representem possíveis problemas de segurança. Presentemente, isto avisa sobre chamadas a funções B<printf> e B<scanf> onde a string de formato não é uma string literal e não existem argumentos de formato, como em B<printf(foo);> em vez de B<printf("%s", foo);> Isto pode ser um buraco de segurança se a string de formato vier de uma entrada não confiável e conter ‘%n’.

note: type: textblock
en: This setting (since dpkg 1.16.1; enabled by default) adds B<-D_FORTIFY_SOURCE=2> to B<CPPFLAGS>.  During code generation the compiler knows a great deal of information about buffer sizes (where possible), and attempts to replace insecure unlimited length buffer function calls with length-limited ones.  This is especially useful for old, crufty code.  Additionally, format strings in writable memory that contain ‘%n’ are blocked.  If an application depends on such a format string, it will need to be worked around.
pt: Esta definição (desde dpkg 1.16.1; activada por predefinição) adiciona B<-D_FORTIFY_SOURCE=2> a B<CPPFLAGS>. Durante a geração de código o compilador sabe muita informação sobre tamanhos de buffer (onde possível), e tenta substituir chamadas de função buffer de comprimento ilimitadas e inseguras por umas limitadas em comprimento. Isto é especialmente útil para código antigo, desnecessariamente complicado. Adicionalmente, as strings de formato em memória gravável que contêm ‘%n’ são bloqueadas. Se uma aplicação depender de tal string de formato, isso terá que ser contornado.

note: type: textblock
en: Note that for this option to have any effect, the source must also be compiled with B<-O1> or higher.  If the environment variable B<DEB_BUILD_OPTIONS> contains I<noopt>, then B<fortify> support will be disabled, due to new warnings being issued by glibc 2.16 and later.
pt: Note que para esta opção ter algum efeito, a fonte tem de também ser compilada com B<-O1> ou superior. Se a variável de ambiente B<DEB_BUILD_OPTIONS> conter I<noopt>, então o suporte a B<fortify> será desactivado, devido a novos avisos serem emitidos pelo glibc 2.16 e posterior.

note: type: textblock
en: This setting (since dpkg 1.16.1; enabled by default if stackprotectorstrong is not in use) adds B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS>.  This adds safety checks against stack overwrites.  This renders many potential code injection attacks into aborting situations.  In the best case this turns code injection vulnerabilities into denial of service or into non-issues (depending on the application).
pt: Esta definição (desde dpkg 1.16.1; activada por predefinição se stackprotectorstrong não estiver em uso) adiciona B<-fstack-protector--param=ssp-buffer-size=4> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS>. Isto adiciona verificações de segurança contra sobreposições de empilhamento. Isto renderiza muitos potenciais ataques de injeções de código em situações de abortar. No melhor caso, isto transforma vulnerabilidades de injeção de código em negação de serviço ou em não-problemas (dependendo da aplicação).

note: type: textblock
en: This feature requires linking against glibc (or another provider of B<__stack_chk_fail>), so needs to be disabled when building with B<-nostdlib> or B<-ffreestanding> or similar.
pt: Esta funcionalidade requer ligação (link) a glibc (ou outro fornecedor de B<__stack_chk_fail>), portanto precisa de ser desactivada quando se compila com B<-nostdlib> ou B<-ffreestanding> ou semelhante.

note: type: textblock
en: This setting (since dpkg 1.17.11; enabled by default) adds B<-fstack-protector-strong> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS>.  This is a stronger variant of B<stackprotector>, but without significant performance penalties.
pt: Esta definição (desde dpkg 1.17.11; activada por predefinição) adiciona B<-fstack-protector-strong> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS>. Esta é uma variante mais forte de B<stackprotector>, mas sem penalidades de performance significativas.

note: type: textblock
en: Disabling B<stackprotector> will also disable this setting.
pt: Desactivar B<stackprotector> irá também desactivar esta definição.

note: type: textblock
en: This feature has the same requirements as B<stackprotector>, and in addition also requires gcc 4.9 and later.
pt: Esta funcionalidade tem os mesmos requerimentos que B<stackprotector>, e adicionalmente também requer gcc 4.9 e posterior.

note: type: textblock
en: This setting (since dpkg 1.22.0; enabled by default) adds B<-fstack-clash-protection> on B<amd64>, B<arm64>, B<armhf> and B<armel> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS>.  This adds code to prevent stack clash style attacks.
pt: Esta definição (desde dpkg 1.22.00; activada por predefinição) adiciona B<-fstack-clash-protection> a B<amd64>, B<arm64>, B<armhf> e B<armel> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS>. Isto adiciona código para prevenir ataques do estilo stack clash.

note: type: textblock
en: This setting (since dpkg 1.22.0; enabled by default) adds B<-fcf-protection> on B<amd64> and B<-mbranch-protection=standard> on B<arm64> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS>.  This adds branch protection to indirect calls, jumps and returns to check whether these are valid at run-time.
pt: Esta definição (desde dpkg 1.22.00; activada por predefinição) adiciona B<-fcf-protection> em B<amd64> e B<-mbranch-protection=standard> em B<arm64> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS>. Isto adiciona proteção de ramo a chamadas, saltos e retornos indiretos para verificar se estes são válidos durante a execução.

note: type: textblock
en: This setting (since dpkg 1.16.1; enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>.  During program load, several ELF memory sections need to be written to by the linker.  This flags the loader to turn these sections read-only before turning over control to the program.  Most notably this prevents GOT overwrite attacks.  If this option is disabled, B<bindnow> will become disabled as well.
pt: Esta definição (desde dpkg 1.16.1; activada por predefinição) adiciona B<-Wl,-z,relro> a B<LDFLAGS>. Durante o carregamento do programa, várias secções de memória ELF precisam de ser escritas pelo vinculador. Isto sinaliza ao carregador para tornar estas secções só-leitura antes de entregar o controlo ao programa. Mais notavelmente isto previne ataques de sobrescrita GOT. Se esta opção for desactivada, B<bindnow> irá ficar também desactivado.

note: type: textblock
en: This setting (since dpkg 1.16.1; disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>.  During program load, all dynamic symbols are resolved, allowing for the entire PLT to be marked read-only (due to B<relro> above).  The option cannot become enabled if B<relro> is not enabled.
pt: Esta definição (desde dpkg 1.16.1; desactivada por predefinição) adiciona B<-Wl,-z,now> a B<LDFLAGS>. Durante o carregamento do programa, todos os símbolos dinâmicos são resolvidos, permitindo que todo o PLT seja marcado só-leitura (devido ao B<relro> em cima). A opção pode ser activada se B<relro> não for activado.

note: type: textblock
en: This setting (since dpkg 1.16.1; with no global default since dpkg 1.18.23, as it is enabled by default now by gcc on the amd64, arm64, armel, armhf, hurd-i386, i386, kfreebsd-amd64, kfreebsd-i386, mips, mipsel, mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc and sparc64 Debian architectures) adds the required options to enable or disable PIE via gcc specs files, if needed, depending on whether gcc injects on that architecture the flags by itself or not.  When the setting is enabled and gcc injects the flags, it adds nothing.  When the setting is enabled and gcc does not inject the flags, it adds B<-fPIE> (via I<%PKGDATADIR%/pie-compiler.specs>) to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS>, and B<-fPIE -pie> (via I<%PKGDATADIR%/pie-link.specs>) to B<LDFLAGS>.  When the setting is disabled and gcc injects the flags, it adds B<-fno-PIE> (via I<%PKGDATADIR%/no-pie-compile.specs>) to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS>, and B<-fno-PIE -no-pie> (via I<%PKGDATADIR%/no-pie-link.specs>) to B<LDFLAGS>.
pt: Esta definição (desde dpkg 1.16.1; sem uma predefinição global desde dpkg 1.18.23, pois é agora activa por predefinição pelo gcc nas arquitecturas Debian amd64, arm64, armel, armhf, hurd-i386, i386, kfreebsd-amd64, kfreebsd-i386, mips, mipsel, mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc e sparc64) adiciona as opções requeridas para activar ou desactivar PIE via ficheiros de especificações do gcc, Se necessário, dependendo de se o gcc injeta nessa arquitectura as bandeiras por ele próprio ou não. Quando a definição está activa e o gcc injeta as bandeiras, não adiciona nada. Quando a definição está activa e o gcc não injeta as bandeiras, adiciona B<-fPIE> (via I<%PKGDATADIR%/pie-compiler.specs>) a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS>, e B<-fPIE -pie> (via I<%PKGDATADIR%/pie-link.specs>) a B<LDFLAGS>. Quando a definição está desactivada e o gcc injeta as bandeiras, adiciona B<-fno-PIE> (via I<%PKGDATADIR%/no-pie-compile.specs>) a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS>, e B<-fno-PIE -no-pie> (via I<%PKGDATADIR%/no-pie-link.specs>) a B<LDFLAGS>.

note: type: textblock
en: Position Independent Executable (PIE) is needed to take advantage of Address Space Layout Randomization (ASLR), supported by some kernel versions.  While ASLR can already be enforced for data areas in the stack and heap (brk and mmap), the code areas must be compiled as position-independent.  Shared libraries already do this (B<-fPIC>), so they gain ASLR automatically, but binary .text regions need to be built as PIE to gain ASLR.  When this happens, ROP (Return Oriented Programming) attacks are much harder since there are no static locations to bounce off of during a memory corruption attack.
pt: Position Independent Executable (PIE) é necessário para tirar vantagem de Address Space Layout Randomization (ASLR), suportado por algumas versões de kernel. Enquanto ASLR já pode ser aplicada para áreas de dados na stack e heap (brk e mmap), as áreas de código têm de ser compiladas como independente-de-posição. As bibliotecas partilhadas já fazem isto (B<-fPIC>), assim elas ganham ASLR automaticamente, mas as regiões de texto binários precisam de ser compiladas como PIE para ganhar ASLR. Quando isto acontece, os ataques ROP (Return Oriented Programming) são mais difíceis pois não são localizações estáticas para ressaltar durante um ataque de corrupção de memória.

note: type: textblock
en: PIE is not compatible with B<-fPIC>, so in general care must be taken when building shared objects.  But because the PIE flags emitted get injected via gcc specs files, it should always be safe to unconditionally set them regardless of the object type being compiled or linked.
pt: PIE não é compatível com B<-fPIC>, assim em geral é preciso cuidado ao compilar objectos partilhados. Mas porque as bandeiras PIE emitidas são injetadas via ficheiros specs de gcc, deverá ser sempre seguro defini-las incondicionalmente independentemente do tipo de objecto a ser compilado ou ligado em link.

note: type: textblock
en: Static libraries can be used by programs or other shared libraries.  Depending on the flags used to compile all the objects within a static library, these libraries will be usable by different sets of objects:
pt: Bibliotecas estáticas pode ser usadas por programas ou outras bibliotecas partilhadas. Dependendo das bandeiras usadas para compilar todos os objectos dentro de uma biblioteca estática, estas bibliotecas serão utilizáveis por conjuntos diferentes de objectos:

note: type: textblock
en: Cannot be linked into a PIE program, nor a shared library.
pt: Não pode ser vinculado a um programa PIE, não é uma biblioteca partilhada.

note: type: textblock
en: Can be linked into any program, but not a shared library (recommended).
pt: Pode ser vinculado a qualquer programa, mas não a uma biblioteca partilhada (recomendado).

note: type: textblock
en: Can be linked into any program and shared library.
pt: Pode ser vinculado a qualquer programa e biblioteca partilhada.

note: type: textblock
en: If there is a need to set these flags manually, bypassing the gcc specs injection, there are several things to take into account.  Unconditionally and explicitly passing B<-fPIE>, B<-fpie> or B<-pie> to a build-system using libtool is safe as these flags will get stripped when building shared libraries.  Otherwise on projects that build both programs and shared libraries you might need to make sure that when building the shared libraries B<-fPIC> is always passed last (so that it overrides any previous B<-PIE>) to compilation flags such as B<CFLAGS>, and B<-shared> is passed last (so that it overrides any previous B<-pie>) to linking flags such as B<LDFLAGS>.  B<Note>: This should not be needed with the default gcc specs machinery.
pt: Se existir a necessidade de definir estas bandeiras manualmente, fazendo bypass à injeção de spec gcc, há varias coisas a ter em conta. Passar incondicionalmente e explicitamente B<-fPIE>, B<-fpie> ou B<-pie> a um sistema de compilação usando libtool é seguro pois estas bandeiras irão ser despojadas quando se compila bibliotecas partilhadas. Caso contrário em projetos que compilam ambos programas e bibliotecas partilhadas você pode precisar de certificar que quando compila as bibliotecas partilhadas, B<-fPIC> seja sempre passado em último (para que sobreponha qualquer B<-PIE> anterior) às bandeiras de compilação tais como B<CFLAGS>, e B<-shared> é passado em último (para que sobreponha qualquer B<-pie> anterior) para ligar em link bandeiras tais como B<LDFLAGS>. B<Nota>: Isto não deve ser necessário com a maquinaria de specs gcc predefinida.

note: type: textblock
en: Additionally, since PIE is implemented via a general register, some register starved architectures (but not including i386 anymore since optimizations implemented in gcc E<gt>= 5) can see performance losses of up to 15% in very text-segment-heavy application workloads; most workloads see less than 1%.  Architectures with more general registers (e.g. amd64)  do not see as high a worst-case penalty.
pt: Adicionalmente, como PIE é implementado via registo geral, algumas arquitecturas com falta de registo (mas não incluindo mais a i386 desde as optimizações implementadas no gcc E<gt>= 5) podem ver perdas de performance até aos 15% em grandes cargas de aplicações de segmentos de texto pesados; a maioria das cargas vêm menos de 1%. Arquitecturas com registos mais gerais (ex. amd64) não vêm mais alto que uma penalidade de pior caso.

note: type: textblock
en: The compile-time options detailed below can be used to help improve build reproducibility or provide additional warning messages during compilation.  Except as noted below, these are enabled by default for architectures that support them.
pt: As opções de tempo de compilação detalhadas em baixo  podem ser usadas para ajudar a melhorar a reprodutibilidade de compilação ou fornecer mensagens de aviso adicionais durante a compilação. Excepto como notado em baixo, estas estão activadas por predefinição para as arquitecturas que as suportam.

note: type: textblock
en: This setting (since dpkg 1.17.14; enabled by default) adds B<-Wdate-time> to B<CPPFLAGS>.  This will cause warnings when the B<__TIME__>, B<__DATE__> and B<__TIMESTAMP__> macros are used.
pt: Esta definição (desde dpkg 1.17.14; activada por predefinição) adiciona B<-Wdate-time> a B<CPPFLAGS>. Isto irá causar avisos quando as macros B<__TIME__>, B<__DATE__> e B<__TIMESTAMP__> são usadas.

note: type: textblock
en: This setting (since dpkg 1.19.1; enabled by default) adds B<-ffile-prefix-map=>I<BUILDPATH>B<=.> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS> where B<BUILDPATH> is set to the top-level directory of the package being built.  This has the effect of removing the build path from any generated file.
pt: Esta definição (desde dpkg 1.19.1; activada por predefinição) adiciona B<-ffile-prefix-map=>I<BUILDPATH>B<=.> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS> quando B<BUILDPATH> está definido para o directório de nível de topo do pacote a ser compilado. Isto tem o efeito de remover o caminho de compilação de qualquer ficheiro gerado.

note: type: textblock
en: If both B<fixdebugpath> and B<fixfilepath> are set, this option takes precedence, because it is a superset of the former.
pt: Se ambas B<fixdebugpath> e B<fixfilepath> forem definidas, esta opção toma precedência, porque é um superconjunto do anterior.

note: type: textblock
en: B<Note>: If the build process captures the build flags into the resulting built objects, that will make the package unreproducible.  And while disabling this option might make some of the objects reproducible again this would also require disabling B<fixdebugpath>, which might make any generated debug symbols objects unreproducible.  The ideal fix is to stop capturing build flags.
pt: B<Nota>: Se o processo de compilação capturar as bandeiras de compilação para os objectos de compilação resultantes, isso irá tornar o pacote não-reproduzível. E ao desactivar esta opção poderá tornar alguns dos objectos reproduzíveis de novo isto irá também requerer desactivar B<fixdebugpath>, o que poderá tornar quaisquer símbolos de depuração gerados não-reproduzíveis. A correção ideal é parar de capturar bandeiras de compilação.

note: type: textblock
en: This setting (since dpkg 1.18.5; enabled by default) adds B<-fdebug-prefix-map=>I<BUILDPATH>B<=.> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> and B<FCFLAGS> where B<BUILDPATH> is set to the top-level directory of the package being built.  This has the effect of removing the build path from any generated debug symbols.
pt: Esta definição (desde dpkg 1.18.5; activada por predefinição) adiciona B<-fdebug-prefix-map=>I<BUILDPATH>B<=.> a B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<FFLAGS> e B<FCFLAGS> quando B<BUILDPATH> está definido para o directório de nível de topo do pacote a ser compilado. Isto tem o efeito de remover o caminho de compilação de qualquer símbolo de depuração gerado.

note: type: textblock
en: B<Note>: This feature has similar reproducible properties as B<fixfilepath>.
pt: B<Nota>: Esta funcionalidade tem propriedades de reprodução semelhantes a B<fixfilepath>.

note: type: textblock
en: There are 2 sets of environment variables doing the same operations, the first one (DEB_I<flag>_I<op>) should never be used within B<debian/rules>.  It's meant for any user that wants to rebuild the source package with different build flags.  The second set (DEB_I<flag>_MAINT_I<op>) should only be used in B<debian/rules> by package maintainers to change the resulting build flags.
pt: Existem 2 conjuntos de variáveis de ambiente a fazer as mesmas operações, O primeiro (DEB_I<flag>_I<op>) nunca deve ser usada dentro de B<debian/rules>. Destina-se a qualquer utilizador que queria recompilar o pacote fonte com bandeiras de compilação diferentes. O segundo conjunto (DEB_I<flag>_MAINT_I<op>) só deve ser usado em B<debian/rules> pelos maintainers de pacotes para alterar as bandeiras de compilação resultantes.

note: type: =item
en: B<DEB_>I<flag>B<_MAINT_SET> (since dpkg 1.16.1)
pt: B<DEB_>I<flag>B<_MAINT_SET> (desde dpkg 1.16.1)

note: type: textblock
en: This variable can be used to force the value returned for the given I<flag>.
pt: Esta variável pode ser usada para forçar o valor retornado para a <flag> fornecida.

note: type: =item
en: B<DEB_>I<flag>B<_STRIP> (since dpkg 1.16.1)
pt: B<DEB_>I<flag>B<_STRIP> (desde dpkg 1.16.1)

note: type: =item
en: B<DEB_>I<flag>B<_MAINT_STRIP> (since dpkg 1.16.1)
pt: B<DEB_>I<flag>B<_MAINT_STRIP> (desde dpkg 1.16.1)

note: type: textblock
en: This variable can be used to provide a space separated list of options that will be stripped from the set of flags returned for the given I<flag>.
pt: Esta variável pode ser usada para disponibilizar uma lista separada por espaços das opções que irão ser despojadas do conjunto de flags retornado para a I<flag> fornecida.

note: type: =item
en: B<DEB_>I<flag>B<_MAINT_APPEND> (since dpkg 1.16.1)
pt: B<DEB_>I<flag>B<_MAINT_APPEND> (desde dpkg 1.16.1)

note: type: textblock
en: This variable can be used to append supplementary options to the value returned for the given I<flag>.
pt: Esta variável pode ser usada para acrescentar opções suplementares ao valor retornado para a I<flag> fornecida.

note: type: =item
en: B<DEB_>I<flag>B<_PREPEND> (since dpkg 1.16.1)
pt: B<DEB_>I<flag>B<_PREPEND> (desde dpkg 1.16.1)

note: type: =item
en: B<DEB_>I<flag>B<_MAINT_PREPEND> (since dpkg 1.16.1)
pt: B<DEB_>I<flag>B<_MAINT_PREPEND> (desde dpkg 1.16.1)

note: type: textblock
en: This variable can be used to prepend supplementary options to the value returned for the given I<flag>.
pt: Esta variável pode ser usada para adicionar opções suplementares ao inicio do valor retornado  para a I<flag> fornecida.

note: type: =item
en: B<DEB_BUILD_MAINT_OPTIONS> (since dpkg 1.16.1)
pt: B<DEB_BUILD_MAINT_OPTIONS> (desde dpkg 1.16.1)

note: type: textblock
en: These variables can be used by a user or maintainer to disable/enable various area features that affect build flags.  The B<DEB_BUILD_MAINT_OPTIONS> variable overrides any setting in the B<DEB_BUILD_OPTIONS> feature areas.  See the L</FEATURE AREAS> section for details.
pt: Estas variáveis podem ser usadas por um utilizador ou maintainer para desactivar/activar várias funcionalidades de área que afectam bandeiras de compilação. A variável B<DEB_BUILD_MAINT_OPTIONS> sobrepõe qualquer definição nas áreas de funcionalidade de B<DEB_BUILD_OPTIONS>. Veja a secção L</ÁREAS DE CARACTERÍSTICAS> para detalhes.

note: type: textblock
en: This setting defines the current vendor.  If not set, it will discover the current vendor by reading B<%PKGCONFDIR%/origins/default>.
pt: Esta definição define o fornecedor actual. Se não definida, irá descobrir o fornecedor actual ao ler B<%PKGCONFDIR%/origins/default>.

note: type: textblock
en: This variable sets the build path (since dpkg 1.18.8) to use in features such as B<fixdebugpath> so that they can be controlled by the caller.  This variable is currently Debian and derivatives-specific.
pt: Esta variável define o caminho de compilação (desde dpkg 1.18.8) a usar em funcionalidades como B<fixdebugpath> para que possam ser controladas pelo chamador. Esta variável é actualmente específica de Debian e derivados.

note: type: =head2
en: Configuration files
pt: Ficheiros de configuração

note: type: textblock
en: System wide configuration file.
pt: Ficheiro de configuração geral do sistema.

note: type: =item
en: B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or
pt: B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> ou

note: type: textblock
en: User configuration file.
pt: Ficheiro de configuração do utilizador.

note: type: textblock
en: Makefile snippet that will load (and optionally export) all flags supported by B<dpkg-buildflags> into variables (since dpkg 1.16.1).
pt: trecho do Makefile que irá carregar (e opcionalmente exportar) todas as bandeiras suportadas pelo B<dpkg-buildflags> em variáveis (desde dpkg 1.16.1).

note: type: textblock
en: To pass build flags to a build command in a Makefile:
pt: Para passar flags de compilação a um comando de compilação dentro de um Makefile:

note: type: textblock
en: To set build flags in a shell script or shell fragment, B<eval> can be used to interpret the output and to export the flags in the environment:
pt: Para definir bandeiras de compilação num script de shell ou num fragmento de shell, por ser usado o B<eval> para interpretar o resultado e para exportar as bandeiras no ambiente:

note: type: textblock
en: or to set the positional parameters to pass to a command:
pt: ou para definir os parâmetros posicionais a passar a um comando:

note: type: textblock
en: You should call B<dpkg-buildflags> or include B<buildflags.mk> from the B<debian/rules> file to obtain the needed build flags to pass to the build system.  Note that older versions of B<dpkg-buildpackage> (before dpkg 1.16.1)  exported these flags automatically.  However, you should not rely on this, since this breaks manual invocation of B<debian/rules>.
pt: Você deve chamar B<dpkg-buildflags> ou incluir B<buildflags.mk> do ficheiro B<debian/rules> para obter as bandeiras de compilação necessárias para passar ao sistema de compilação. Note que versões antigas do B<dpkg-buildpackage> (antes do dpkg 1.16.1) exportavam estas bandeiras automaticamente. No entanto, você não deve confiar nisto, pois isto quebra a invocação manual de B<debian/rules>.

note: type: textblock
en: For packages with autoconf-like build systems, you can pass the relevant options to configure or L<make(1)> directly, as shown above.
pt: Para pacotes com sistemas de compilação tipo autoconf, você pode passar as opções relevantes ao configure ou L<make(1)> diretamente, como mostrado em cima.

note: type: textblock
en: For other build systems, or when you need more fine-grained control about which flags are passed where, you can use B<--get>.  Or you can include B<buildflags.mk> instead, which takes care of calling B<dpkg-buildflags> and storing the build flags in make variables.
pt: Para outros sistemas de compilação, ou quando precisa de um controle mais afinado acerca de quais bandeiras são passadas para onde, você pode usar B<--get>. Ou você pode incluir B<buildflags.mk> em vez disto, o que toma conta de chamar B<dpkg-buildflags> e guardar as bandeiras de compilação em variáveis do make.

note: type: textblock
en: If you want to export all buildflags into the environment (where they can be picked up by your build system):
pt: Se você quiser exportar todas as bandeiras de compilação para o ambiente (onde elas pode ser colhidas pelo seu sistema de compilação):

note: type: textblock
en: For some extra control over what is exported, you can manually export the variables (as none are exported by default):
pt: Para algum controle extra sobre o que é exportado, você pode exportar manualmente as variáveis (pois nenhuma é exportada por predefinição).

note: type: textblock
en: And you can of course pass the flags to commands manually:
pt: E claro que você pode passar as bandeiras aos comandos manualmente:

note: type: textblock
en: dpkg-buildpackage - build binary or source packages from sources
pt: dpkg-buildpackage - compila pacotes binários ou fonte a partir de fontes

note: type: textblock
en: B<dpkg-buildpackage> is a program that automates the process of building a Debian package.  It consists of the following steps:
pt: B<dpkg-buildpackage> é um programa que automatiza os processos de compilar um pacote Debian. Consiste nos seguintes passos:

note: type: textblock
en: It runs the B<preinit> hook before reading any source file.  It prepares the build environment by setting various environment variables (see B<ENVIRONMENT>), runs the B<init> hook, and calls B<dpkg-source --before-build> (unless B<-T> or B<--target> has been used).
pt: Corre o hook B<preinit> antes de ler qualquer ficheiro fonte. Prepara o ambiente de compilação ao definir várias variáveis de ambiente. (veja B<ENVIRONMENT>), corre o hook B<init>, e chama B<dpkg-source --before-build> (a menos que B<-T> ou B<--target> sejam usados).

note: type: textblock
en: It checks that the build-dependencies and build-conflicts are satisfied (unless B<-d> or B<--no-check-builddeps> is specified).
pt: Verifica se as dependências de compilação e os conflitos de compilação estão satisfeitos (a menos que B<-d> ou B<--no-check-builddeps> seja especificado).

note: type: textblock
en: If one or more specific targets have been selected with the B<-T> or B<--target> option, it calls those targets and stops here.  Otherwise it runs the B<preclean> hook and calls B<fakeroot debian/rules clean> to clean the build-tree (unless B<-nc> or B<--no-pre-clean> is specified).
pt: Se um ou mais alvos específicos foram seleccionado com a opção B<-T> ou B<--target>, chama esses alvos e pára aqui. Caso contrário corre o hook B<preclean> e chama B<fakeroot debian/rules clean> para limpar a árvore de compilação (a menos que B<-nc> ou B<--no-pre-clean> seja especificado).

note: type: textblock
en: It runs the B<source> hook and calls B<dpkg-source -b> to generate the source package (if a B<source> build has been requested with B<--build> or equivalent options).
pt: Corre o hook B<source> e chama B<dpkg-source -b> para gerar o pacote fonte. (se foi requerida uma compilação B<source> com B<--build> ou com opções equivalentes).

note: type: textblock
en: It runs the B<build> hook and calls B<debian/rules> I<build-target>, then runs the B<binary> hook followed by B<fakeroot debian/rules> I<binary-target> (unless a source-only build has been requested with B<--build=source> or equivalent options).  Note that I<build-target> and I<binary-target> are either B<build> and B<binary> (default case, or if an B<any> and B<all> build has been requested with B<--build> or equivalent options), or B<build-arch> and B<binary-arch> (if an B<any> and not B<all> build has been requested with B<--build> or equivalent options), or B<build-indep> and B<binary-indep> (if an B<all> and not B<any> build has been requested with B<--build> or equivalent options).
pt: Corre o hook B<build> e chama B<debian/rules> I<build-target>, depois corre o hook B<binary> seguido de B<fakeroot debian/rules> I<binary-target> (a menos que tenha sido requerido uma compilação apenas-fonte com B<--build=source> ou opções equivalentes). Note que I<build-target> e I<binary-target> são ou B<build> e B<binary> (caso predefinido, ou se uma compilação B<any> e B<all> foi requerida com B<--build> ou opções equivalentes), ou B<build-arch> e B<binary-arch> (se uma compilação B<any> e não B<all> foi requerida com B<--build> ou opções equivalentes), ou B<build-indep> e B<binary-indep> (se uma compilação B<all> e não B<any> foi requerida com B<--build> ou opções equivalentes).

note: type: textblock
en: It runs the B<buildinfo> hook and calls B<dpkg-genbuildinfo> to generate a B<.buildinfo> file.  Several B<dpkg-buildpackage> options are forwarded to B<dpkg-genbuildinfo>.
pt: Corre o hook B<buildinfo>, e chama B<dpkg-genbuildinfo> para gerar um ficheiro B<.buildinfo>. Várias opções de B<dpkg-buildpackage> são reencaminhadas para o B<dpkg-genbuildinfo>.

note: type: textblock
en: It runs the B<changes> hook and calls B<dpkg-genchanges> to generate a B<.changes> file.  The name of the B<.changes> file will depend on the type of build and will be as specific as necessary but not more; the name will be:
pt: Corre o hook B<changes> e chama B<dpkg-genchanges> para gerar um ficheiro B<.changes>. O nome do ficheiro B<.changes> irá depender do tipo de compilação e será tão específico quanto necessário mas não mais; o nome irá ser:

note: type: textblock
en: Many B<dpkg-buildpackage> options are forwarded to B<dpkg-genchanges>.
pt: Muitas opções do B<dpkg-buildpackage> são reencaminhadas para B<dpkg-genchanges>.

note: type: textblock
en: It runs the B<postclean> hook and if B<-tc> or B<--post-clean> is specified, it will call B<fakeroot debian/rules clean> again.
pt: Corre o hook B<postclean> e se B<-tc> ou B<--post-clean> for especificado, irá chamar B<fakeroot debian/rules clean> outra vez.

note: type: textblock
en: It calls B<dpkg-source --after-build>.
pt: Chama B<dpkg-source --after-build>.

note: type: textblock
en: It runs the B<check> hook and calls a package checker for the B<.changes> file (if a command is specified in B<DEB_CHECK_COMMAND> or with B<--check-command>).
pt: Corre o hook B<check> e chama um verificados de pacote para o ficheiro B<.changes> (se um comando for especificado em B<DEB_CHECK_COMMAND> ou com B<--check-command>).

note: type: textblock
en: It runs the B<sign> hook and signs using the OpenPGP backend (as long as it is not an UNRELEASED build, or B<--no-sign> is specified) to sign the B<.dsc> file (if any, unless B<-us> or B<--unsigned-source> is specified), the B<.buildinfo> file (unless B<-ui>, B<--unsigned-buildinfo>, B<-uc> or B<--unsigned-changes> is specified) and the B<.changes> file (unless B<-uc> or B<--unsigned-changes> is specified).
pt: Corre o hook B<sign> e assina usando o backend OpenPGP (desde que não seja uma compilação NÃO-LANÇADA, ou se B<--no-sign> for especificado) para assinar o ficheiro B<.dsc> (se algum, a menos que B<-us> ou B<--unsigned-source> sejam especificados), o ficheiro B<.buildinfo> (a menos que B<-ui>, B<--unsigned-buildinfo>, B<-uc> ou B<--unsigned-changes> sejam especificados) e os ficheiros B<.changes> (a menos que B<-uc> ou B<--unsigned-changes> sejam especificados).

note: type: textblock
en: It runs the B<done> hook.
pt: Corre o hook B<done>.

note: type: textblock
en: All long options can be specified both on the command line and in the B<dpkg-buildpackage> system and user configuration files.  Each line in the configuration file is either an option (exactly the same as the command line option but without leading hyphens) or a comment (if it starts with a ‘B<#>’).
pt: Todas as opções longas podem ser especificadas em ambos linha de comandos e no sistema  B<dpkg-buildpackage> e nos ficheiros de configuração do utilizador. Cada linha no ficheiro de configuração é ou uma opção (exatamente igual a uma opção de linha de comandos mas sem os hífens iniciais) ou um comentário (se começar com ‘B<#>’).

note: type: textblock
en: Specifies the build I<type> from a comma-separated list of components (since dpkg 1.18.5).  All the specified components get combined to select the single build type to use, which implies a single build run with a single F<.changes> file generated.  Passed to B<dpkg-genchanges>.
pt: Especifica o I<type> de compilação a partir de uma lista separada por vírgulas de componentes (desde dpkg 1.18.5). Todos os componentes especificados são combinados para selecionar o único tipo de compilação a usar, o que implica uma única execução de compilação com um único ficheiro F<changes> gerado.  Passado para B<dpkg-genchanges>.

note: type: textblock
en: The allowed values are:
pt: Os valores permitidos são:

note: type: textblock
en: Builds the source package.
pt: Compila o pacote fonte.

note: type: textblock
en: B<Note>: When using this value standalone and if what you want is simply to (re-)build the source package from a clean source tree, using B<dpkg-source> directly is always a better option as it does not require any build dependencies to be installed which are otherwise needed to be able to call the B<clean> target.
pt: B<Nota>: Quando se usa este valor autónomo e se o que você quer é simplesmente (re-)compilar o pacote fonte a partir de uma árvore fonte limpa, usar B<dpkg-source> directamente é sempre uma melhor opção pois não requer que sejam instaladas quaisquer dependências de compilação as quais, caso contrário, são precisas para ser capaz de chamar o alvo B<clean>.

note: type: textblock
en: Builds the architecture specific binary packages.
pt: Compila os pacotes binários específicos de arquitectura.

note: type: textblock
en: Builds the architecture independent binary packages.
pt: Compila os pacotes binários independentes de arquitectura.

note: type: textblock
en: Builds the architecture specific and independent binary packages.  This is an alias for B<any,all>.
pt: Compila os pacotes binários independentes e específicos de arquitectura. Isto é um alias para B<any,all>.

note: type: textblock
en: Builds everything.  This is an alias for B<source,any,all>, and the same as the default case when no build option is specified.
pt: Compila tudo. Isto é um alias para B<source,any,all>, e o mesmo que o caso  predefinido quando não é especificada nenhuma opção de compilação.

note: type: textblock
en: Equivalent to B<--build=source,all> (since dpkg 1.17.11).
pt: Equivalente a B<--build=source,all> (desde dpkg 1.17.11).

note: type: textblock
en: Equivalent to B<--build=source,any> (since dpkg 1.17.11).
pt: Equivalente a B<--build=source,any> (desde dpkg 1.17.11).

note: type: textblock
en: Equivalent to B<--build=binary> or B<--build=any,all>.
pt: Equivalente a B<--build=binary> ou B<--build=any,all>.

note: type: textblock
en: Equivalent to B<--build=any>.
pt: Equivalente a B<--build=any>.

note: type: textblock
en: Equivalent to B<--build=all>.
pt: Equivalente a B<--build=all>.

note: type: textblock
en: Equivalent to B<--build=source>.
pt: Equivalente a B<--build=source>.

note: type: textblock
en: Equivalent to B<--build=full>, B<--build=source,binary> or B<--build=source,any,all> (since dpkg 1.15.8).
pt: Equivalente a B<--build=full>, B<--build=source,binary> ou B<--build=source,any,all> (desde dpkg 1.15.8).

note: type: textblock
en: Calls B<debian/rules> I<target> once per target specified, after having setup the build environment (except for calling B<dpkg-source --before-build>), and stops the package build process here (since dpkg 1.15.0, long option since dpkg 1.18.8, multi-target support since dpkg 1.18.16).  If B<--as-root> is also given, then the command is executed as root (see B<--root-command>).  Note that known targets that are required to be run as root do not need this option (i.e. the B<clean>, B<binary>, B<binary-arch> and B<binary-indep> targets).
pt: Chama B<debian/rules> I<target> uma vez por cada alvo especificado, após ter configurado o ambiente de compilação (excepto para chamar B<dpkg-source --before-build>), e pára o processo de compilação do pacote aqui (desde dpkg 1.15.0, opção longa desde dpkg 1.18.8, suporte a multi-alvo desde dpkg 1.18.16).  Se B<--as-root> for também fornecido, então o comando é executado como root (veja B<--root-command>).  Note que alvos conhecidos que são obrigados a correr como root não precisam desta opção (isto é, os alvos B<clean>, B<binary>, B<binary-arch> e B<binary-indep>).

note: type: textblock
en: Only meaningful together with B<--target> (since dpkg 1.15.0).  Requires that the target be run with root rights.
pt: Apenas significativo junto com B<--target> (desde dpkg 1.15.0). Requer que o alvo seja corrido com direitos de root.

note: type: textblock
en: Passed unchanged to B<dpkg-genchanges>.  See its manual page.
pt: Passado sem alterações ao B<dpkg-genchanges>. Veja o seu manual.

note: type: =item
en: B<--source-by=>I<maintainer-address> (since dpkg 1.21.10)
pt: B<--source-by=>I<maintainer-address> (desde dpkg 1.21.10)

note: type: textblock
en: Pass as B<-m> to B<dpkg-genchanges>.  See its manual page.
pt: Passa como B<-m> ao B<dpkg-genchanges>. Veja o seu manual.

note: type: =item
en: B<--changed-by=>I<maintainer-address> (since dpkg 1.21.10)
pt: B<--changed-by=>I<maintainer-address> (desde dpkg 1.21.10)

note: type: textblock
en: Pass as B<-e> to B<dpkg-genchanges>.  See its manual page.
pt: Passa como B<-e> ao B<dpkg-genchanges>. Veja o seu manual.

note: type: textblock
en: Specify the Debian architecture we build for (long option since dpkg 1.17.17).  The architecture of the machine we build on is determined automatically, and is also the default for the host machine.
pt: Especifica a arquitectura Debian para qual compilamos (opção longa desde dpkg 1.17.17). A arquitectura da máquina onde compilamos é determinada automaticamente, e é também a predefinida para a máquina anfitriã.

note: type: textblock
en: Specify the GNU system type we build for (long option since dpkg 1.17.17).  It can be used in place of B<--host-arch> or as a complement to override the default GNU system type of the host Debian architecture.
pt: Especifica o tipo de sistema GNU para qual compilamos (opção longa desde dpkg 1.17.17). Pode ser usado no lugar de B<--host-arch> ou como um complemento para sobrepor o tipo de sistema GNU predefinido da arquitectura Debian anfitriã.

note: type: textblock
en: Specify the Debian architecture the binaries built will build for (since dpkg 1.17.17).  The default value is the host machine.
pt: Especifica a arquitectura Debian para que os binários são compilados (desde dpkg 1.17.17). O valor predefinido é o da máquina anfitriã.

note: type: textblock
en: Specify the GNU system type the binaries built will build for (since dpkg 1.17.17).  It can be used in place of B<--target-arch> or as a complement to override the default GNU system type of the target Debian architecture.
pt: Especifica o tipo de sistema GNU para que os binários são compilados (desde dpkg 1.17.17). Pode ser usado no lugar de B<--target-arch> ou como um complemento para sobrepor o tipo de sistema GNU predefinido da arquitectura Debian do alvo.

note: type: textblock
en: Specify the profile(s) we build, as a comma-separated list (since dpkg 1.17.2, long option since dpkg 1.18.8).  The default behavior is to build for no specific profile.  Also sets them (as a space separated list) as the B<DEB_BUILD_PROFILES> environment variable which allows, for example, B<debian/rules> files to use this information for conditional builds.
pt: Especifica os perfil(es) que compilamos, como uma lista separada por vírgulas (desde dpkg 1.17.2, opção longa desde dpkg 1.18.8). O comportamento predefinido é compilar para nenhum perfil específico. Também os define (como uma lista separada por espaços) como a variável de ambiente B<DEB_BUILD_PROFILES> o que permite, por exemplo, ficheiros B<debian/rules> usarem esta informação para compilações condicionais.

note: type: textblock
en: Specifies the number of jobs allowed to be run simultaneously (since dpkg 1.14.7, long option since dpkg 1.18.8).  The number of jobs matching the number of online processors if B<auto> is specified (since dpkg 1.17.10), or unlimited number if I<jobs> is not specified.  The default behavior is B<auto> (since dpkg 1.18.11) in non-forced mode (since dpkg 1.21.10), and as such it is always safer to use with any package including those that are not parallel-build safe.  Setting the number of jobs to B<1> will restore serial execution.
pt: Especifica se o número de trabalhos permitidos para serem corridos em simultâneo (desde dpkg 1.14.7, opção longa desde dpkg 1.18.8).  O número de trabalhos correspondente ao número de processadores online se B<auto> for especificado (desde dpkg 1.17.10), ou número ilimitado se I<jobs> não for especificado. O comportamento predefinido é B<auto> (desde dpkg 1.18.11) em modo não-forçado (desde dpkg 1.21.10), e como tal é sempre mais seguro usar com qualquer pacote incluindo aqueles que não seguros para compilação paralela. Definir o número de trabalhos para B<1> irá restaurar a execução em série.

note: type: textblock
en: Will add B<parallel=>I<jobs> or B<parallel> to the B<DEB_BUILD_OPTIONS> environment variable which allows debian/rules files to opt-in to use this information for their own purposes.  The I<jobs> value will override the B<parallel=>I<jobs> or B<parallel> option in the B<DEB_BUILD_OPTIONS> environment variable.  Note that the B<auto> value will get replaced by the actual number of currently active processors, and as such will not get propagated to any child process.  If the number of online processors cannot be inferred then the code will fallback to using serial execution (since dpkg 1.18.15), although this should only happen on exotic and unsupported systems.
pt: Irá adicionar B<parallel=>I<jobs> ou B<parallel> à variável de ambiente B<DEB_BUILD_OPTIONS> que permite a ficheiros debian/rules optarem por usar esta informação para os seus próprios objectivos. O valor B<jobs> irá sobrepor a opção B<parallel=>I<jobs> ou B<parallel> na variável de ambiente B<DEB_BUILD_OPTIONS>. Note que o valor B<auto> irá ser substituído pelo número real de processadores actuais activos, e como tal, não será propagado para nenhum processo filho. Se o número de processadores online não poder ser deduzido, então o código ira cair para o uso de execução em série (desde dpkg 1.18.15), no entanto isto apenas deverá acontecer em sistemas exóticos e não suportados.

note: type: textblock
en: This option (since dpkg 1.18.2, long option since dpkg 1.18.8) is equivalent to the B<-j> above.
pt: Esta opção (desde dpkg 1.18.2, opção longa desde dpkg 1.18.8) é equivalente a B<-j> em cima.

note: type: textblock
en: Since the behavior for B<-j> changed in dpkg 1.21.10 to the opt-in mode, you can use this option instead if you need to guarantee semantics across dpkg release series.
pt: Como o comportamento do B<-j> alterou no dpkg 1.21.10 para o modo opt-in, você pode usar esta opção se precisar de garantir semânticas entre séries de lançamento do dpkg.

note: type: textblock
en: This option (since dpkg 1.21.10) is equivalent to the B<--jobs> option except that it will enable forced parallel mode, by adding the B<make> B<-j> option with the computed number of parallel jobs to the B<MAKEFLAGS> environment variable.
pt: Esta opção (desde dpkg 1.21.10) é equivalente à opção B<--jobs> excepto que irá activar o modo paralelo forçado, ao adicionar a opção B<make> B<-j> com o número computado de trabalhos em paralelo para a variável de ambiente B<MAKEFLAGS>.

note: type: textblock
en: This should cause all subsequent make invocations to inherit the option, thus forcing the parallel setting on the packaging (and possibly the upstream build system if that uses L<make(1)>) regardless of their support for parallel builds, which might cause build failures.
pt: Isto deverá causar que todas as invocações make subsequentes herdam a opção assim forçando a definição paralela no empacotamento (e possivelmente o sistema de compilação do autor se isso usar L<make(1)>) independentemente do seu suporte para compilações paralelas, o que pode causar falhas na compilação.

note: type: textblock
en: B<Note>: Any Makefile that is not parallel-safe should be considered to be buggy.  These should either be made parallel-safe, or marked as not being safe with the L<make(1)> B<.NOTPARALLEL> target.
pt: B<Nota>: Qualquer Makefile que não seja seguro-paralelo deve ser considerado defeituoso. Estes devem ou tornados seguro-paralelo, ou marcados como não seguros com o alvo L<make(1)> B<.NOTPARALLEL>.

note: type: textblock
en: Check build dependencies and conflicts; abort if unsatisfied (long option since dpkg 1.18.8).  This is the default behavior.
pt: Verifica dependências e conflitos de compilação; aborta se não satisfeitos (opção longa desde dpkg 1.18.8). Este é o comportamento predefinido.

note: type: textblock
en: Do not check build dependencies and conflicts (long option since dpkg 1.18.8).
pt: Não verifica dependências e conflitos de compilação (opção longa desde dpkg 1.18.8).

note: type: textblock
en: Do not check built-in build dependencies and conflicts (since dpkg 1.18.2).  These are the distribution specific implicit build dependencies usually required in a build environment, the so called Build-Essential package set.
pt: Não verifica dependências de compilação embutidas e conflitos (desde dpkg 1.18.2). Estas as dependências de compilação implícitas e específicas da distribuição requeridas num ambiente de compilação, o chamado conjunto de pacotes Build-Essential.

note: type: textblock
en: Do not honor the B<Rules-Requires-Root> field, falling back to its legacy default value (since dpkg 1.19.1).
pt: Não respeita o campo B<Rules-Requires-Root>, caindo para o seu valor de predefinição antiga (desde dpkg 1.19.1).

note: type: textblock
en: Do not clean the source tree before building (long option since dpkg 1.18.8).  Implies B<-b> if nothing else has been selected among B<-F>, B<-g>, B<-G>, B<-B>, B<-A> or B<-S>.  Implies B<-d> with B<-S> (since dpkg 1.18.0).
pt: Não limpa a árvore fonte antes de compilar (opção longa desde dpkg 1.18.8). Implica B<-b> se nada mais foi seleccionado entre B<-F>, B<-g>, B<-G>, B<-B>, B<-A> ou B<-S>. Implica B<-d> com B<-S> (desde dpkg 1.18.0).

note: type: textblock
en: Clean the source tree before building (since dpkg 1.18.8).  This is the default behavior.
pt: Limpa a árvore fonte antes de compilar (desde dpkg 1.18.8). Este é o comportamento predefinido.

note: type: textblock
en: Clean the source tree (using I<gain-root-command> B<debian/rules clean>)  after the package has been built (long option since dpkg 1.18.8).
pt: Limpa a árvore fonte (usando I<gain-root-command> B<debian/rules clean>) após o pacote ter sido compilado (opção longa desde dpkg 1.18.8).

note: type: textblock
en: Do not clean the source tree after the package has been built (since dpkg 1.19.1).  This is the default behavior.
pt: Não limpa a árvore fonte após o pacote ter sido compilado (desde dpkg 1.19.1). Este é o comportamento predefinido.

note: type: textblock
en: Sanitize the build environment (since dpkg 1.20.0).  This will reset or remove environment variables, umask, and any other process attributes that might otherwise adversely affect the build of packages.  Because the official entry point to build packages is B<debian/rules>, packages cannot rely on these settings being in place, and thus should work even when they are not.  What to sanitize is vendor specific.
pt: Higieniza o ambiente de compilação (desde dpkg 1.20.0). Isto irá repor ou remover variáveis de ambiente, umask, e quaisquer outros atributos de processo que poderiam caso contrário afectar adversamente a compilação dos pacotes. Porque o ponto de entrada oficial para compilar pacotes é B<debian/rules>, os pacotes não podem confiar que estas definições estejam no lugar, e assim devem funcionar mesmo quando elas não estão. O que há a higienizar é específico do fornecedor.

note: type: textblock
en: When B<dpkg-buildpackage> needs to execute part of the build process as root, it prefixes the command it executes with I<gain-root-command> if one has been specified (long option since dpkg 1.18.8).  Otherwise, if none has been specified, B<fakeroot> will be used by default, if the command is present.  I<gain-root-command> should start with the name of a program on the B<PATH> and will get as arguments the name of the real command to run and the arguments it should take.  I<gain-root-command> can include parameters (they must be space-separated) but no shell metacharacters.  I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or B<really>.  B<su> is not suitable, since it can only invoke the user's shell with B<-c> instead of passing arguments individually to the command to be run.
pt: Quando o B<dpkg-buildpackage> precisa de executar parte do processo de compilação como root, prefixa o comando que executa com I<gain-root-command> se foi especificado um (opção longa desde dpkg 1.18.8). Caso contrário, se nenhum foi especificado, será usado por predefinição o B<fakeroot>, se o comando estiver presente. I<gain-root-command> deverá começar com o nome de um programa presente na B<PATH> e receberá como argumentos o nome do comando real a correr e os argumentos que este deve receber. O I<gain-root-command> pode incluir parâmetros (têm se ser separados por espaços) mas não meta-caracteres da shell. O I<gain-root-command>pode ser tipicamente B<fakeroot>, B<sudo>, B<super> ou B<really>. O B<su> não é apropriado, pois ele só pode invocar a shell do utilizador com B<-c> em vez de passar argumentos individualmente aos comandos que corre.

note: type: textblock
en: Building a Debian package usually involves invoking B<debian/rules> as a command with several standard parameters (since dpkg 1.14.17, long option since dpkg 1.18.8).  With this option it's possible to use another program invocation to build the package (it can include space separated parameters).  Alternatively it can be used to execute the standard rules file with another make program (for example by using B</usr/local/bin/make -f debian/rules> as I<rules-file>).
pt: Compilar um pacote Debian geralmente involve invocar B<debian/rules> como um comando com vários parâmetros standard (desde dpkg 1.14.17, opção longa desde dpkg 1.18.8). Com esta opção é possível usar outra invocação de programa para compilar o pacote (pode incluir parâmetros separados por espaços). Em alternativa pode ser usado para executar o ficheiro de regras standard com outro programa make (por exemplo ao usar B</usr/local/bin/make -f debian/rules> como I<rules-file>).

note: type: textblock
en: Command used to check the B<.changes> file itself and any artifact built referenced in the file (since dpkg 1.17.6).  The command should take the B<.changes> pathname as an argument.  This command will usually be B<lintian>.
pt: Comando usado para verificar o próprio ficheiro B<.changes> e qualquer artefacto de compilação referenciado no ficheiro (desde dpkg 1.17.6). O comando deve receber o nome de caminho de B<.changes> como um argumento. Este comando é geralmente o B<lintian>.

note: type: textblock
en: Pass option I<opt> to the I<check-command> specified with B<DEB_CHECK_COMMAND> or B<--check-command> (since dpkg 1.17.6).  Can be used multiple times.
pt: Passa a opção I<opção> ao I<comando-de-verificação> especificado com B<DEB_CHECK_COMMAND> ou B<--check-command> (desde dpkg 1.17.6). Pode ser usado várias vezes.

note: type: textblock
en: Set the specified shell code I<hook-command> as the hook I<hook-name>, which will run at the times specified in the run steps (since dpkg 1.17.6).  The hooks will always be executed even if the following action is not performed (except for the B<binary> hook).  All the hooks will run in the unpacked source directory.
pt: Define o código shell especificado I<hook-command> como o hook I<hook-name>, o qual vai correr nos tempos especificados nos passos de execução (desde dpkg 1.17.6). Os hooks irão sempre ser executados mesmo que a acção seguinte não seja executada (excepto para o hook B<binary>). Todos os hooks irão correr no directório fonte desempacotado.

note: type: textblock
en: Some hooks can receive addition information through environment variables (since dpkg 1.22.0).  All hooks get the hook name in the B<DPKG_BUILDPACKAGE_HOOK_NAME> environment variable (since dpkg 1.22.0).
pt: Alguns hooks podem receber informação adicional através de variáveis de ambiente (desde dpkg 1.22.0). Todos os hooks obtêm o nome de hook na variável de ambiente B<DPKG_BUILDPACKAGE_HOOK_NAME> (desde dpkg 1.22.0).

note: type: textblock
en: B<Note>: Hooks can affect the build process, and cause build failures if their commands fail, so watch out for unintended consequences.
pt: B<Nota>: Os hooks podem afectar o processo de compilação, e causar falhas ao compilar se os seus comandos falharem,  portanto esteja atento a consequências indesejadas.

note: type: textblock
en: The current I<hook-name> supported are:
pt: Os I<nome-de-hook> actualmente suportados são:

note: type: textblock
en: Gets B<DPKG_BUILDPACKAGE_HOOK_SOURCE_OPTIONS> with the space-separated lists of options that will passed to the B<dpkg-source> call.
pt: Obtém B<DPKG_BUILDPACKAGE_HOOK_SOURCE_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada B<dpkg-source>.

note: type: textblock
en: Gets B<DPKG_BUILDPACKAGE_HOOK_BUILD_TARGET> with the name of the B<debian/rules> build target called, but only if called.
pt: Obtém B<DPKG_BUILDPACKAGE_HOOK_BUILD_TARGET> com o nome do alvo de compilação B<debian/rules> chamado, mas apenas se chamado.

note: type: textblock
en: Gets B<DPKG_BUILDPACKAGE_HOOK_BINARY_TARGET> with the name of the B<debian/rules> binary target called, but only if called.
pt: Obtém B<DPKG_BUILDPACKAGE_HOOK_BINARY_TARGET> com o nome de alvo binário B<debian/rules> chamado, mas apenas se chamado.

note: type: textblock
en: Gets B<DPKG_BUILDPACKAGE_HOOK_BUILDINFO_OPTIONS> with the space-separated lists of options that will passed to the B<dpkg-genbuildinfo> call.
pt: Obtém B<DPKG_BUILDPACKAGE_HOOK_BUILDINFO_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada B<dpkg-genbuildinfo>.

note: type: textblock
en: Gets B<DPKG_BUILDPACKAGE_HOOK_CHANGES_OPTIONS> with the space-separated lists of options that will passed to the B<dpkg-genchanges> call.
pt: Obtém B<DPKG_BUILDPACKAGE_HOOK_CHANGES_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada B<dpkg-genchanges>.

note: type: textblock
en: Gets B<DPKG_BUILDPACKAGE_HOOK_CHECK_OPTIONS> with the space-separated lists of options that will passed to the check command call.
pt: Obtém B<DPKG_BUILDPACKAGE_HOOK_CHECK_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada do comando de verificação.

note: type: textblock
en: The I<hook-command> supports the following substitution format string, which will get applied to it before execution:
pt: O I<comando-hook> suporta as seguintes strings de formato de substituição, que lhes serão aplicadas antes da execução.

note: type: textblock
en: A single % character.
pt: Um único caracteres %.

note: type: textblock
en: A boolean value (0 or 1), representing whether the following action is being performed.
pt: Um valor booleano (0 ou 1), que representa se a seguinte acção foi executada.

note: type: textblock
en: The source package name.
pt: O nome do pacote fonte.

note: type: textblock
en: The source package version.
pt: A versão do pacote fonte

note: type: textblock
en: The source package version (without the epoch).
pt: A versão do pacote fonte (sem a época).

note: type: textblock
en: The upstream version.
pt: A versão do autor.

note: type: textblock
en: Set the I<filename> for the generated B<.buildinfo> file (since dpkg 1.21.0).
pt: Define o I<nome-ficheiro> para o ficheiro B<.buildinfo> gerado (desde dpkg 1.21.0).

note: type: textblock
en: Pass option I<opt> to B<dpkg-genbuildinfo> (since dpkg 1.18.11).  Can be used multiple times.
pt: Passa a opção I<opt> ao B<dpkg-genbuildinfo> (desde dpkg 1.18.11).  Pode ser usado várias vezes.

note: type: textblock
en: Specify an OpenPGP backend interface to use when invoking the I<sign-command> (since dpkg 1.21.10).
pt: Especifica uma interface backend OpenPGP a usar quando se invoca o I<sign-command> (desde dpkg 1.21.10).

note: type: textblock
en: The default is B<auto>, where the best current backend available will be used.  The specific OpenPGP backends supported in order of preference are:
pt: A predefinição é B<auto>, onde o melhor backend actual disponível irá ser usado. Os backends OpenPGP específicos suportados em ordem de preferência são:

note: type: textblock
en: (any conforming Stateless OpenPGP implementation)
pt: (qualquer implementação em conformidade com Stateless OpenPGP)

note: type: textblock
en: (from Sequoia-PGP)
pt: (de Sequoia-PGP)

note: type: textblock
en: (from GnuPG)
pt: (de GnuPG)

note: type: textblock
en: When B<dpkg-buildpackage> needs to execute an OpenPGP backend command to sign a source control (B<.dsc>) file, a B<.buildinfo> file or a B<.changes> file it will run I<sign-command> (searching the B<PATH> if necessary) instead of the default or auto-detected backend command (long option since dpkg 1.18.8).  I<sign-command> will get all the backend specific arguments according to the B<--sign-backend> selected.  I<sign-command> should not contain spaces or any other shell metacharacters.
pt: Quando B<dpkg-buildpackage> precisa de executar comando backend OpenPGP para assinar um ficheiro de controle de fonte (B<.dsc>), um ficheiro B<.buildinfo> ou um ficheiro B<.changes> irá correr I<sign-command> (procurando na B<PATH> se necessário) em vez do predefinido ou auto-detectado comando backend (opção longa desde dpkg 1.18.8). O I<sign-command> irá obter todos os argumentos específicos de backend de acordo com o B<--sign-backend> selecionado. I<sign-command> não deve conter espaços ou outros meta-caracteres de shell.

note: type: textblock
en: Specify an OpenPGP key-ID (either a fingerprint or a user-ID) for the secret key to use when signing packages (B<--sign-key> since dpkg 1.18.8, B<--sign-keyid> since dpkg 1.21.10).
pt: Especifica um ID-chave OpenPGP (seja uma impressão digital ou um ID de utilizador) para a chave secreta a usar ao assinar pacotes (B<--sign-key> desde dpkg 1.18.8, B<--sign-keyid> desde dpkg 1.21.10).

note: type: textblock
en: Specify an OpenPGP I<key-file> containing the secret key to use when signing packages (since dpkg 1.21.10).
pt: Especifica um I<key-file> OpenPGP que contem a chave secreta usada quando assinar pacotes (desde dpkg 1.21.10).

note: type: textblock
en: B<Note>: For security reasons the I<key-file> is best kept locked with a password.
pt: B<Nota>: Por razões de segurança é melhor o I<key-file> ser mantido bloqueado com uma palavra passe.

note: type: textblock
en: Do not sign the source package (long option since dpkg 1.18.8).
pt: Não assina o pacote fonte (opção longa desde dpkg 1.18.8).

note: type: textblock
en: Do not sign the B<.buildinfo> file (since dpkg 1.18.19).
pt: Não assina o ficheiro B<.buildinfo> (desde dpkg 1.18.19).

note: type: textblock
en: Do not sign the B<.buildinfo> and B<.changes> files (long option since dpkg 1.18.8).
pt: Não assina os ficheiros B<.buildinfo> e B<.changes> (opção longa desde dpkg 1.18.8).

note: type: textblock
en: Do not sign any file, this includes the source package, the B<.buildinfo> file and the B<.changes> file (since dpkg 1.18.20).
pt: Não assina nenhum ficheiro, isto inclui o pacote fonte, o ficheiro B<.buildinfo> e o ficheiro B<.changes> (desde dpkg 1.18.20).

note: type: textblock
en: Force the signing of the resulting files (since dpkg 1.17.0), regardless of B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, B<--unsigned-changes> or other internal heuristics.
pt: Força o assinar dos ficheiros resultantes (desde dpkg 1.17.0), independentemente de B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, B<--unsigned-changes> ou de outras heurísticas internas.

note: type: textblock
en: Passed unchanged to B<dpkg-source>.  See its manual page.
pt: Passado sem alterações ao B<dpkg-source>. Veja o seu manual.

note: type: textblock
en: Pass option I<opt> to B<dpkg-source> (since dpkg 1.15.6).  Can be used multiple times.
pt: Passa a opção I<opção> ao B<dpkg-source> (desde dpkg 1.15.6. Pode ser usado várias vezes.

note: type: textblock
en: Set the I<filename> for the generated B<.changes> file (since dpkg 1.21.0).
pt: Define o I<nome-ficheiro> para o ficheiro B<.changes> gerado (desde dpkg 1.21.0).

note: type: textblock
en: Pass option I<opt> to B<dpkg-genchanges> (since dpkg 1.15.6).  Can be used multiple times.
pt: Passa a opção I<opção> ao B<dpkg-genchanges> (desde dpkg 1.15.6).  Pode ser usado várias vezes.

note: type: textblock
en: Change the location of the B<dpkg> database (since dpkg 1.14.0).  The default location is I<%ADMINDIR%>.
pt: Altera a localização da base de dados do B<dpkg> (desde dpkg 1.14.0). A localização predefinida é I<%ADMINDIR%>.

note: type: =head2
en: External environment
pt: Ambiente externo

note: type: textblock
en: If set, it will be used as the command to check the B<.changes> file (since dpkg 1.17.6).  Overridden by the B<--check-command> option.
pt: Se definido, será usado como o comando para verificar o ficheiro B<.changes> (desde dpkg 1.17.6). Sobreposto pela opção B<--check-command>.

note: type: textblock
en: If set, it will be used to sign the B<.changes>, B<.buildinfo> and B<.dsc> files (since dpkg 1.17.2).  Overridden by the B<--sign-key> option.
pt: Se definido, será usado para assinar os ficheiros B<.changes>, B<.buildinfo> e B<.dsc> (desde dpkg 1.17.2). Sobreposto pela opção B<--sign-key>.

note: type: textblock
en: If set, it will be used to sign the B<.changes>, B<.buildinfo> and B<.dsc> files (since dpkg 1.21.10).  Overridden by the B<--sign-keyfile> option.
pt: Se definido, será usado para assinar os ficheiros B<.changes>, B<.buildinfo> e B<.dsc> (desde dpkg 1.21.10). Sobreposto pela opção B<--sign-keyfile>.

note: type: textblock
en: If set, it will contain a space-separated list of options that affect the behavior of some dpkg tools involved in package building, and might affect the package build process if the code in F<debian/rules> honors them.  These options can have parameters specified immediately after an equal sign (‘B<=>‘).  For options that support multiple parameters, these will not be separated by spaces, as these are reserved to separate options.
pt: Se definido, irá conter uma lista de opções separadas por espaços que afectam o comportamento de algumas ferramentas do dpkg envolvidas na compilação de pacote, e pode afectar o processo de compilação se o código em I<debian/rules> as honrar. Estas opções podem ter parâmetros especificados imediatamente após um sinal de igual (‘B<=>‘).  Para opções que suportem múltiplos parâmetros, estes não serão separadas por espaços, pois estes estão reservados para opções separadas.

note: type: textblock
en: The following are the options known and supported by dpkg tools, other options honored by F<debian/rules> might be defined by distribution specific policies.
pt: O seguinte são opções conhecidas e suportadas pelas ferramentas do dpkg, outras opções honradas por F<debian/rules> podem ser definidas por políticas específicas da distribuição.

note: type: textblock
en: The F<debian/rules> in the packaging might use this option to set up the build process to use I<N> parallel jobs.  It is overridden by the B<--jobs> and B<--jobs-force> options.
pt: O F<debian/rules> no empacotamento pode usar esta opção para definir o processo de compilação a usar I<N> trabalhos em paralelo. É sobreposto pelas opções B<--jobs> e B<--jobs-force>.

note: type: textblock
en: B<dpkg-buildpackage> will ignore the B<DEB_CHECK_COMMAND> variable.  The F<debian/rules> in the packaging is not expected to run test suites during the build.
pt: B<dpkg-buildpackage> irá ignorar a variável B<DEB_CHECK_COMMAND>. Não é esperado que o F<debian/rules> no empacotamento corra suites de teste durante a compilação.

note: type: textblock
en: If F<debian/rules> calls B<dpkg-buildflags> to set up the build flags, those will be set to not enable any optimizations.
pt: Se F<debian/rules> chamar B<dpkg-buildflags> para definir as bandeiras de compilação, essas serão definidas para não activar nenhumas optimizações.

note: type: textblock
en: The F<debian/rules> in the packaging should ensure that objects do not get the debugging information stripped.  If F<debian/rules> includes the B<mk/buildtools.mk> make fragment the B<STRIP> make variable will respect this option.
pt: O F<debian/rules> no empacotamento deve assegurar que os objectos não ficam com a sua informação de depuração removida. Se F<debian/rules> incluir o fragmento de make B<mk/buildtools.mk> a variável de make B<STRIP> irá respeitar esta opção.

note: type: textblock
en: B<dpkg-buildpackage> will append the B<--no-print-directory> L<make(1)> flag to the B<MAKEFLAGS> environment variable.  The F<debian/rules> in the packaging should reduce verbosity, while not being completely quiet.
pt: B<dpkg-buildpackage> irá acrescentar a bandeira B<--no-print-directory> L<make(1)> à variável de ambiente B<MAKEFLAGS>. O F<debian/rules> no empacotamento deve reduzir nos detalhes, não sendo completamente silencioso.

note: type: textblock
en: These are feature areas that control build flag features.  See L<dpkg-buildflags(1)> for further details.
pt: Estas são áreas de característica que controlam as características da bandeira de compilação. Veja L<dpkg-buildflags(1)> para mais detalhes.

note: type: textblock
en: If set, it will be used as the active build profile(s) for the package being built (since dpkg 1.17.2).  It is a space separated list of profile names.  Overridden by the B<-P> option.
pt: Se definido, será usado como perfil(es) de compilação activos para o pacote a ser compilado (desde dpkg 1.17.2). É uma lista separada por espaços de nomes de perfis. Sobreposto pela opção B<-P>.

note: type: =head2
en: Internal environment
pt: Ambiente interno

note: type: textblock
en: Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should not rely on their presence and should instead use the respective interface to retrieve the needed values, because that file is the main entry point to build packages and running it standalone should be supported.
pt: Mesmo que B<dpkg-buildpackage> exporte algumas variáveis, o B<debian/rules> não deve confiar na sua presença e deve em vez disso usar a interface respectiva para obter os valore que precisa, porque esse ficheiro é o ponto de entrada principal para compilar pacotes e deve ser suportado poder fazê-lo sozinho.

note: type: textblock
en: B<dpkg-architecture> is called with the B<-a> and B<-t> parameters forwarded.  Any variable that is output by its B<-s> option is integrated in the build environment.
pt: B<dpkg-architecture> é chamado com os parâmetros B<-a> e B<-t> reencaminhados. Qualquer variável  que seja resultante da sua opção B<-s> é integrada no ambiente de compilação.

note: type: textblock
en: This variable is set to the value obtained from the B<Rules-Requires-Root> field, the dpkg-build-api level or from the command-line.  When set, it will be a valid value for the B<Rules-Requires-Root> field.  It is used to notify B<debian/rules> whether the B<rootless-builds.txt> specification is supported.
pt: Esta variável é definida para o valor obtido a partir do campo B<Rules-Requires-Root>, o nível dpkg-build-api ou a partir da linha de comandos. Quando definida, será um valor válido para o campo B<Rules-Requires-Root>. É usada para notificar B<debian/rules> se a especificação B<rootless-builds.txt> é suportada.

note: type: textblock
en: This variable is set to I<gain-root-command> when the field B<Rules-Requires-Root> is set to a value different to B<no> and B<binary-targets>.
pt: Esta variável é definida para I<gain-root-command> quando o campo B<Rules-Requires-Root> é definido para um valor diferente de B<no> e B<binary-targets>.

note: type: textblock
en: This variable is set to the Unix timestamp since the epoch of the latest entry in I<debian/changelog>, if it is not already defined.
pt: Esta variável é definida à marca temporal de Unix desde a época da última entrada em I<debian/changelog>, se não estiver já definida.

note: type: textblock
en: System wide configuration file
pt: Ficheiro de configuração geral do sistema

note: type: =item
en: I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> or
pt: I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> ou

note: type: =head2
en: Compiler flags are no longer exported
pt: As bandeiras de compilador já não são exportadas

note: type: textblock
en: Between dpkg 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with values as returned by B<dpkg-buildflags>.  This is no longer the case.
pt: Entre dpkg 1.14.17 e 1.16.1, B<dpkg-buildpackage> exportava as bandeiras de compilador (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> e B<LDFLAGS>) com valores como retornados por B<dpkg-buildflags>. Isto já não acontece.

note: type: =head2
en: Default build targets
pt: Metas de compilação predefinidas

note: type: textblock
en: B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets since dpkg 1.16.2.  Those targets are thus mandatory.  But to avoid breakages of existing packages, and ease the transition, if the source package does not build both architecture independent and dependent binary packages (since dpkg 1.18.8) it will fallback to use the B<build> target if B<make -f debian/rules -qn> I<build-target> returns 2 as exit code.
pt: B<dpkg-buildpackage> está  a usar os alvos B<build-arch> e B<build-indep> desde dpkg 1.16.2. Esses alvos são assim obrigatórios. Mas para evitar ruturas de pacotes existentes, e facilitar a transição, se o pacote fonte não compilar ambos pacotes binários independentes e dependentes da arquitectura (desde dpkg 1.18.8) irá regressar ao uso de alvo B<build> se B<make -f debian/rules -qn> I<build-target> retornar 2 como código de saída.

note: type: =head1
en: SECURITY
pt: SEGURANÇA

note: type: textblock
en: Building binary or source packages should only be performed over trusted source data.
pt: A compilação de pacotes binário ou fonte só deve ser executada sobre dados de fonte de confiança.

note: type: textblock
en: It should be possible to specify spaces and shell metacharacters and initial arguments for I<gain-root-command> and I<sign-command>.
pt: Deverá ser possível especificar espaços e meta-caracteres de shell e argumentos iniciais para I<gain-root-command> e I<sign-command>.

note: type: textblock
en: dpkg-buildtree - helper for build tree operations during package builds
pt: dpkg-buildtree - ajudante para operações na árvore de compilação durante compilação de pacotes

note: type: textblock
en: B<dpkg-buildtree> [I<option>...] [I<command>]
pt: B<dpkg-buildtree> [I<opção>...] [I<comando>]

note: type: textblock
en: B<dpkg-buildtree> is a tool to perform common operations on the build tree for a source package.
pt: B<dpkg-buildtree> é uma ferramenta para executar operações comuns na árvore de compilação para um pacote fonte.

note: type: textblock
en: This program was introduced in dpkg 1.22.3.
pt: Este programa foi introduzido no dpkg 1.22.3.

note: type: textblock
en: Removes all artifacts generated during a build by the various dpkg tools, and pathnames used or controlled by dpkg tools that are safe to clean.  These files are used to track state between package build runs, and are in many cases internal implementation details the packager should not be concerned about, or are staging directories containing build artifacts.
pt: Remove todos os artefactos gerados durante uma compilação pelas várias ferramentas do dpkg, e os nomes de caminho usados ou controlados pelas ferramentas do dpkg que são seguras de se limpar. Estes ficheiros são usados para acompanhar o estado entre execuções de compilação do pacote, e são em muitos casos detalhes de implementação interna com que o empacotador não se deve preocupar, ou são directórios de estágios contendo artefactos de compilação.

note: type: =head2
en: Cleaned files
pt: Ficheiros limpos

note: type: textblock
en: Files generated by L<dpkg-distaddfile(1)>.
pt: Ficheiros gerados pelo L<dpkg-distaddfile(1)>.

note: type: textblock
en: Files generated by L<dpkg-shlibdeps(1)>.
pt: Ficheiros gerados pelo L<dpkg-shlibdeps(1)>.

note: type: textblock
en: Staging directory containing the contents to be used when creating a package.  Both L<dpkg-gencontrol(1)> and L<dpkg-gensymbols(1)> generate files within.
pt: Directório de estágio que contém os conteúdos a ser usados quando se cria um pacote. Ambos L<dpkg-gencontrol(1)> e L<dpkg-gensymbols(1)> ficheiros gerados dentro.

note: type: textblock
en: You can call B<dpkg-buildtree clean> from the F<debian/rules> B<clean> target, after having performed other necessary cleanups.
pt: Você pode chamar B<dpkg-buildtree clean> a partir de F<debian/rules> alvo B<clean>, após ter executado outras limpezas necessárias.

note: type: textblock
en: For example for an autoconf-like build system:
pt: Por exemplo para um sistema de compilação tipo-autoconf:

note: type: textblock
en: dpkg-checkbuilddeps - check build dependencies and conflicts
pt: dpkg-checkbuilddeps - verifica dependências e conflitos de compilação

note: type: textblock
en: This program checks the installed packages in the system against the build dependencies and build conflicts listed in the control file.  If any are not met, it displays them and exits with a nonzero return code.
pt: Este programa verifica os pacotes instalados no sistema pelas dependências de compilação e conflitos de compilação listados no ficheiro de controle. Se algo não estiver satisfeito, mostra-o e termina com um código de retorno não-zero.

note: type: textblock
en: By default, B<debian/control> is read, but an alternate control filename may be specified on the command line.
pt: Por predefinição, é lido B<debian/control>, mas pode ser especificado um nome de ficheiro alternativo de controle na linha de comandos.

note: type: textblock
en: Ignore B<Build-Depends-Arch> and B<Build-Conflicts-Arch> lines (since dpkg 1.16.4).  Use when only arch-indep packages will be built, or combine with B<-B> when only a source package is to be built.
pt: Ignora as linhas B<Build-Depends-Arch> e B<Build-Conflicts-Arch> (desde dpkg 1.16.4). Use apenas quando são compilados pacotes independentes da arquitectura, ou combine com B<-B> quando apenas está para ser compilado um pacote fonte.

note: type: textblock
en: Ignore B<Build-Depends-Indep> and B<Build-Conflicts-Indep> lines.  Use when only arch-dep packages will be built, or combine with B<-A> when only a source package is to be built.
pt: Ignora as linhas B<Build-Depends-Indep> e B<Build-Conflicts-Indep> Use apenas quando são compilados pacotes dependentes da arquitectura, ou combine com B<-A> quando apenas está para ser compilado um pacote fonte.

note: type: textblock
en: Ignore built-in build depends and conflicts (since dpkg 1.18.2).  These are implicit dependencies that are usually required on a specific distribution, the so called Build-Essential package set.
pt: Ignora dependências de compilação embutidas e conflitos (desde dpkg 1.18.2). Estas são dependências implícitas que são normalmente requeridas numa distribuição específica, o chamado conjunto de pacotes Build-Essential.

note: type: textblock
en: Use the given build dependencies/conflicts instead of those contained in the I<debian/control> file (since dpkg 1.14.17).
pt: Usa as dependências/conflitos de compilação fornecidos em vez daqueles contidos no ficheiro I<debian/control> (desde dpkg 1.14.17).

note: type: textblock
en: Check build dependencies/conflicts assuming that the package described in the control file is to be built for the given host architecture instead of the architecture of the current system (since dpkg 1.16.2).
pt: Verifica dependências/conflitos de compilação assumindo que o pacote descrito no ficheiro de controle é para ser compilado para a arquitectura de máquina fornecida em vez da arquitectura do sistema actual (desde dpkg 1.16.2).

note: type: textblock
en: Check build dependencies/conflicts assuming that the package described in the control file is to be built for the given build profile(s)  (since dpkg 1.17.2).  The argument is a comma-separated list of profile names.
pt: Verifica dependências/conflitos de compilação assumindo que o pacote descrito no ficheiro de controle +e para ser compilado para perfiles de compilação dados (desde dpkg 1.17.2). O argumento é uma lista de nomes de perfiles separados por vírgulas.

note: type: textblock
en: If set, it will be used as the active build profile(s) for the package being built.  It is a space separated list of profile names.  Overridden by the B<-P> option.
pt: Se definido, será usado como perfil(es) de compilação activos para o pacote a ser compilado. É uma lista separada por espaços de nomes de perfis. Sobreposto pela opção B<-P>.

note: type: textblock
en: dpkg-deb - Debian package archive (.deb) manipulation tool
pt: dpkg-deb - ferramenta de manipulação de arquivos de pacote Debian (.deb)

note: type: textblock
en: B<dpkg-deb> packs, unpacks and provides information about Debian archives.
pt: B<dpkg-deb> empacota, desempacota e fornece informação acerca de arquivos Debian.

note: type: textblock
en: Use B<dpkg> to install and remove packages from your system.
pt: Use o B<dpkg> para instalar e remover pacotes do seu sistema.

note: type: textblock
en: You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you want to pass to B<dpkg-deb>.  B<dpkg> will spot that you wanted B<dpkg-deb> and run it for you.
pt: Você também pode invocar o B<dpkg-deb> ao chamar o B<dpkg> com quaisquer opções que deseje passar ao B<dpkg-deb>. O B<dpkg> vai perceber que você quer o B<dpkg-deb> e corre-o por si.

note: type: textblock
en: For most commands taking an input archive argument, the archive can be read from standard input if the archive name is given as a single minus character («B<->»); otherwise lack of support will be documented in their respective command description.
pt: Para a maioria dos comandos que recebem uma entrada de argumento de arquivo, o arquivo pode ser lido a partir da entrada standard se o nome de arquivo for dado por um único caractere de menos («B<->»); caso contrário a falta de suporte será documentada na sua descrição respectiva ao comando.

note: type: textblock
en: Creates a debian archive from the filesystem tree stored in I<binary-directory>.  I<binary-directory> must have a B<DEBIAN> subdirectory, which contains the control information files such as the control file itself.  This directory will I<not> appear in the binary package's filesystem archive, but instead the files in it will be put in the binary package's control information area.
pt: Cria um arquivo debian para a árvore de sistema de ficheiros armazenada em I<binary-directory>. I<binary-directory> tem de ter um sub-directório B<DEBIAN>, o qual contém os ficheiros de informação de controlo tais como o próprio ficheiro control. Este directório I<não> irá aparecer no arquivo de sistema de ficheiros do pacote binários, mas em vez disso os ficheiros nele serão postos na área de informação de controlo do pacote binário.

note: type: textblock
en: Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and parse it.  It will check the file for syntax errors and other problems, and display the name of the binary package being built.  B<dpkg-deb> will also check the permissions of the maintainer scripts and other files found in the B<DEBIAN> control information directory.
pt: A menos que você especifique B<--nocheck>, B<dpkg-deb> irá ler B<DEBIAN/control> e analisa-lo. Irá verificar o ficheiro por erros de sintaxe e outros problemas, e mostrar o nome do pacote binário a ser compilado. B<dpkg-deb> irá também verificar as permissões dos scripts do maintainer e outros ficheiros encontrados no directório de informação de controlo B<DEBIAN>.

note: type: textblock
en: If no I<archive> is specified then B<dpkg-deb> will write the package into the file I<binary-directory>B<.deb>.
pt: Se não for especificado nenhum I<archive> então o B<dpkg-deb> irá escrever o pacote no ficheiro I<binary-directory>B<.deb>.

note: type: textblock
en: If the archive to be created already exists it will be overwritten.
pt: Se o arquivo a ser criado já existir, ele será sobrescrito.

note: type: textblock
en: If the second argument is a directory then B<dpkg-deb> will write to the file I<directory>B</>I<package>B<_>I<version>B<_>I<arch>B<.deb.> When a target directory is specified, rather than a file, the B<--nocheck> option may not be used (since B<dpkg-deb> needs to read and parse the package control file to determine which filename to use).
pt: Se o segundo argumento for um directório então B<dpkg-deb> irá escrever para o ficheiro I<directory>B</>I<package>B<_>I<version>B<_>I<arch>B<.deb.> Quando é especificado um directório alvo, em vez de um ficheiro, a opção B<--nocheck> pode não ser usada (pois B<dpkg-deb> precisa de ler e analisar o ficheiro de controle do pacote para determinar qual o nome de ficheiro a suar).

note: type: textblock
en: Provides information about a binary package archive.
pt: Fornece informação acerca de um arquivo de pacote binário.

note: type: textblock
en: If no I<control-file-name>s are specified then it will print a summary of the contents of the package as well as its control file.
pt: Se nenhum I<control-file-name> for especificado então irá escrever um sumário do conteúdo do pacote assim como e seu ficheiro de controlo.

note: type: textblock
en: If any I<control-file-name>s are specified then B<dpkg-deb> will print them in the order they were specified; if any of the components weren't present it will print an error message to stderr about each one and exit with status 2.
pt: Se alguns I<control-file-name>s forem especificados então B<dpkg-deb> irá escreve-los pela ordem que forma especificados; se qualquer dos componentes não estiver presente, irá escrever uma mensagem de erro no stderr acerca de cada um e terminar com estados 2.

note: type: textblock
en: Provides information about a binary package archive in the format specified by the B<--showformat> argument.  The default format displays the package's name and version on one line, separated by a tabulator.
pt: Fornece informação acerca do arquivo de um pacote binário no formato especificado pelo argumento B<--showformat>. O formato predefinido mostra o nome do pacote e a versão em uma linha, separados por um tabulador.

note: type: textblock
en: Extracts control file information from a binary package archive.
pt: Extrai informação de ficheiro de controle de um arquivo de pacote binário.

note: type: textblock
en: If no I<control-field-name>s are specified then it will print the whole control file.
pt: Se nenhum I<control-field-name> for especificado então irá escrever o ficheiro de controle completo.

note: type: textblock
en: If any are specified then B<dpkg-deb> will print their contents, in the order in which they appear in the control file.  If more than one I<control-field-name> is specified then B<dpkg-deb> will precede each with its field name (and a colon and space).
pt: Se algum for especificado então B<dpkg-deb> irá escrever o seu conteúdo, na ordem que eles aparecem no ficheiro de controle. Se for especificado mais do que um I<control-field-name> então B<dpkg-deb> irá preceder cada um com o seu nome de campo (e dois pontos e espaço).

note: type: textblock
en: No errors are reported for fields requested but not found.
pt: Não são reportados erros para campos requisitados mas não encontrados.

note: type: textblock
en: Lists the contents of the filesystem tree archive portion of the package archive.  It is currently produced in the format generated by B<tar>'s verbose listing.
pt: Lista o conteúdo da porção de arquivo da árvore do sistema de ficheiros do arquivo pacote. É presentemente produzido no formato gerado pela listagem detalhada do B<tar>.

note: type: textblock
en: Extracts the filesystem tree from a package archive into the specified directory.
pt: Extrai a árvore do sistema de ficheiros a partir do arquivo de pacote para o directório especificado.

note: type: textblock
en: Note that extracting a package to the root directory will I<not> result in a correct installation! Use B<dpkg> to install packages.
pt: Note que extrair um pacote para o directório raiz I<não> irá resultar numa instalação correcta! Use o B<dpkg> para instalar pacotes.

note: type: textblock
en: I<directory> (but not its parents) will be created if necessary, and its permissions modified to match the contents of the package.
pt: I<directory> (mas não os seus parentes) será criada se necessário, e as suas permissões modificadas para corresponder ao conteúdo do pacote.

note: type: textblock
en: Is like B<--extract> (B<-x>)  with B<--verbose> (B<-v>)  which prints a listing of the files extracted as it goes.
pt: É como B<--extract> (B<-x>)  com B<--verbose> (B<-v>)  o que escreve uma listagem dos ficheiros extraídos ao avançar.

note: type: textblock
en: Extracts the filesystem tree from a package archive into a specified directory, and the control information files into a B<DEBIAN> subdirectory of the specified directory (since dpkg 1.16.1).
pt: Extrai a árvore do sistema de ficheiros de um arquivo pacote para um directório especificado, e os ficheiros de informação de controlo para um sub-directório B<DEBIAN> do directório especificado (desde dpkg 1.16.1).

note: type: textblock
en: The target directory (but not its parents) will be created if necessary.
pt: O directório alvo (mas não os seus parentes) será criado se necessário.

note: type: textblock
en: The input archive is not (currently) processed sequentially, so reading it from standard input («B<->») is B<not> supported.
pt: O arquivo de entrada não é (actualmente) processado sequencialmente, portanto lê-lo a partir da entrada standard («B<->») B<não> é suportado.

note: type: textblock
en: Extracts the control data from a binary package and sends it to standard output in B<tar> format (since dpkg 1.17.14).  Together with L<tar(1)> this can be used to extract a particular control file from a package archive.  The input archive will always be processed sequentially.
pt: Extrai os dados de controlo de um pacote binário e envia-os para a saída standard em formato B<tar> (desde dpkg 1.17.14). Juntamente com L<tar(1)> isto pode ser usado para extrair um ficheiro de controlo particular de um arquivo pacote. O arquivo de entrada será sempre processado sequencialmente.

note: type: textblock
en: Extracts the filesystem tree data from a binary package and sends it to standard output in B<tar> format.  Together with L<tar(1)> this can be used to extract a particular file from a package archive.  The input archive will always be processed sequentially.
pt: Extrai os dados de árvore de sistema de ficheiros de um pacote binário e envia-os para a saída standard em formato B<tar>. Juntamente com L<tar(1)> isto pode ser usado para extrair um ficheiro particular de um arquivo pacote. O arquivo de entrada será sempre processado sequencialmente.

note: type: textblock
en: Extracts the control information files from a package archive into the specified directory.
pt: Extrai ficheiros de informação de controlo a partir de uma arquivo de pacote para o directório especificado.

note: type: textblock
en: If no directory is specified then a subdirectory B<DEBIAN> in the current directory is used.
pt: Se nenhum directório for especificado, então é usado um sub-directório B<DEBIAN> no directório actual.

note: type: textblock
en: This option is used to specify the format of the output B<--show> will produce.  The format is a string that will be output for each package listed.
pt: esta opção é usada para especificar o formato dos resultados que B<--show> irá produzir. O formato é uma string que será escrita para cada pacote listado.

note: type: textblock
en: The string may reference any status field using the “${I<field-name>}” form, a list of the valid fields can be easily produced using B<-I> on the same package.  A complete explanation of the formatting options (including escape sequences and field tabbing) can be found in the explanation of the B<--showformat> option in L<dpkg-query(1)>.
pt: A string pode referenciar qualquer campo de estado usado o formato “${I<field-name>}”, uma lista dos campos válidos pode ser produzida facilmente usando B<-I> no mesmo pacote. Uma explicação completa das opções de formatação (incluindo sequências de escape e tabulação de campos) pode ser encontrada na explicação da opção B<--showformat> em L<dpkg-query(1)>.

note: type: textblock
en: The default for this field is “${Package}\t${Version}\n”.
pt: A predefinição para este campo é “${Package}\t${Version}\n”.

note: type: textblock
en: Specify which compression level to use on the compressor backend, when building a package (default is 9 for gzip, 6 for xz, 3 for zstd).  The accepted values are compressor specific.  For gzip, from 0-9 with 0 being mapped to compressor none.  For xz from 0-9.  For zstd from 0-22, with levels from 20 to 22 enabling its ultra mode.  Before dpkg 1.16.2 level 0 was equivalent to compressor none for all compressors.
pt: Especifica que nível de compressão usar no backend compressor, quando compila um pacote (a predefinição é 9 para gzip, 6 para xz, 3 para zstd). Os valores aceites são específicos do compressor. Para gzip de 0-9 com 0 a ser mapeado para nenhuma compressão. Para xz de 0-9. Para zstd de 0-22, com os níveis de 20 a 22 a ativarem o seu modo ultra. Antes do dpkg 1.16.2 o nível 0 era equivalente a nenhuma compressão para todos os compressores.

note: type: textblock
en: Specify which compression strategy to use on the compressor backend, when building a package (since dpkg 1.16.2).  Allowed values are B<none> (since dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> and B<fixed> for gzip (since dpkg 1.17.0) and B<extreme> for xz.
pt: Especifica qual a estratégia de compressão usar no backend compressor, quando compila um pacote (desde dpkg 1.16.2). Valores permitidos são B<none> (desde dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> e B<fixed> para gzip (desde dpkg 1.17.0) e B<extreme> para xz.

note: type: textblock
en: Specify which compression type to use when building a package.  Allowed values are B<gzip>, B<xz> (since dpkg 1.15.6), B<zstd> (since dpkg 1.21.18)  and B<none> (default is B<%DEB_DEFAULT_COMPRESSOR%>).
pt: Especifica qual tipo de compressão usar quando compila um pacote. Valores permitidos são B<gzip>, B<xz> (desde dpkg 1.15.6), B<zstd> (desde dpkg 1.21.18) e B<none> (a predefinição é B<%DEB_DEFAULT_COMPRESSOR%>).

note: type: textblock
en: Specify that the same compression parameters should be used for all archive members (i.e. B<control.tar> and B<data.tar>; since dpkg 1.17.6).  Otherwise only the B<data.tar> member will use those parameters.  The only supported compression types allowed to be uniformly used are B<none>, B<gzip>, B<xz> and B<zstd>.  The B<--no-uniform-compression> option disables uniform compression (since dpkg 1.19.0).  Uniform compression is the default (since dpkg 1.19.0).
pt: Especifica que os mesmos parâmetros de compressão devem ser usados para todos os membros do arquivo (isto é, B<control.tar> e B<data.tar>; desde dpkg 1.17.6). Caso contrário apenas o membro B<data.tar> irá usar estes parâmetros. Os únicos tipos de compressão suportados e permitidos para uso uniformizado são B<none>, B<gzip>, B<xz> e B<zstd>.  A opção B<--no-uniform-compression> desactiva a compressão uniforme (desde dpkg 1.19.0). Compressão uniforme é a predefinição (desde dpkg 1.19.0).

note: type: textblock
en: Sets the maximum number of threads allowed for compressors that support multi-threaded operations (since dpkg 1.21.9).
pt: Define o número máximo de tópicos permitidos para compressores que suportam operações multi-tópico (desde dpkg 1.21.9).

note: type: textblock
en: Set the owner and group for each entry in the filesystem tree data to root with id 0 (since dpkg 1.19.0).
pt: Define os dados de dono e grupo para cada entrada na árvore do sistema de ficheiros para root com id 0 (desde dpkg 1.19.0).

note: type: textblock
en: B<Note>: This option can be useful for rootless builds (see I<rootless-builds.txt>), but should B<not> be used when the entries have an owner or group that is not root.  Support for these will be added later in the form of a meta manifest.
pt: B<Nota>: Esta opção pode ser útil para compilações sem-root (veja I<rootless-builds.txt>), mas B<não> deve ser usada quando as entradas têm um dono ou um grupo que não seja o root. O suporte para estes irá ser adicionado mais tarde no formato de um meta manifesto.

note: type: textblock
en: Set the archive format version used when building (since dpkg 1.17.0).  Allowed values are B<2.0> for the new format, and B<0.939000> for the old one (default is B<2.0>).
pt: Define a versão de formato de arquivo usado quando compila (desde dpkg 1.17.0). Valores permitidos são B<2.0> para o novo formato, e B<0.939000> para o antigo (a predefinição é B<2.0>).

note: type: textblock
en: The old archive format is less easily parsed by non-Debian tools and is now obsolete; its only use is when building packages to be parsed by versions of dpkg older than 0.93.76 (September 1995), which was released as i386 a.out only.
pt: O formato de arquivo antigo é menos facilmente analisado por ferramentas não-Debian e está agora obsoleto; o seu único uso é quando se compila pacotes para serem analisados por versões do dpkg anteriores a 0.93.76 (Setembro 1995), o qual foi um lançamento apenas para i386.

note: type: textblock
en: Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an archive.  You can build any archive you want, no matter how broken, this way.
pt: Inibe as verificações usuais de B<dpkg-deb --build> no conteúdo proposto de um arquivo. Deste modo, você pode compilar qualquer arquivo que queira, não interessa o quanto estragado.

note: type: textblock
en: Enables verbose output (since dpkg 1.16.1).  This currently only affects B<--extract> making it behave like B<--vextract>.
pt: Activa resultados detalhados (desde dpkg 1.16.1). Isto actualmente apenas afecta B<--extract> fazendo-o comportar-se como B<--vextract>.

note: type: textblock
en: Enables debugging output.  This is not very interesting.
pt: Activa resultados de depuração. Isto não é muito interessante.

note: type: =head1
en: EXIT STATUS
pt: ESTADO À SAÍDA

note: type: textblock
en: The requested action was successfully performed.
pt: A acção requisitada foi executada com sucesso.

note: type: textblock
en: Fatal or unrecoverable error due to invalid command-line usage, or interactions with the system, such as accesses to the database, memory allocations, etc.
pt: Erro fatal ou irrecuperável devido a utilização de linha de comandos inválida, ou interações com o sistema, tais como acesso à base de dados, alocações de memória, etc.

note: type: textblock
en: The B<--threads-max> option overrides this value.
pt: A opção B<--threads-max> sobrepõe este valor.

note: type: textblock
en: Sets the compressor type to use (since dpkg 1.21.10).
pt: Define o tipo de compressão a usar (desde dpkg 1.21.10).

note: type: textblock
en: The B<-Z> option overrides this value.
pt: A opção B<-Z> sobrepõe este valor.

note: type: textblock
en: Sets the compressor level to use (since dpkg 1.21.10).
pt: Define o nível de compressão a usar (desde dpkg 1.21.10).

note: type: textblock
en: The B<-z> option overrides this value.
pt: A opção B<-z> sobrepõe este valor.

note: type: textblock
en: If set, B<dpkg-deb> will use it as the directory in which to create temporary files and directories.
pt: Se definido, B<dpkg-deb> irá usa-lo como o directório onde criar ficheiros e directórios temporários.

note: type: textblock
en: If set, it will be used as the timestamp (as seconds since the epoch) in the L<deb(5)>'s L<ar(5)> container and used to clamp the mtime in the L<tar(5)> file entries.
pt: Se definido, será usado como marca temporal (em segundos desde a época) no contentor L<ar(5)> de L<deb(5)> e usado para engatar o mtime nas entradas do ficheiro L<tar(5)>.

note: type: textblock
en: Do not attempt to use just B<dpkg-deb> to install software! You must use B<dpkg> proper to ensure that all the files are correctly placed and the package's scripts run and its status and contents recorded.
pt: Não tente usar o B<dpkg-deb> para instalar software! Você deve usar o B<dpkg> apropriado para assegurar que todos os ficheiros são colocados correctamente e os scripts do pacote correm e que os seus estados e conteúdos são gravados.

note: type: textblock
en: Examining untrusted package archives or extracting them into staging directories should be considered a security boundary, and any breakage of that boundary stemming from these operations should be considered a security vulnerability.  But handling untrusted package archives should not be done lightly, as the surface area includes any compression library supported, in addition to the archive formats and control files themselves.  Performing these operations over untrusted data as root is strongly discouraged.
pt: Examinar arquivos de pacotes não-confiáveis ou extraí-los para directórios estagiários deve ser considerado um limite à segurança, e qualquer violação desse limite derivando dessas operações deve ser considerada uma vulnerabilidade na segurança. Mas manusear arquivos de pacotes não-confiáveis não deve ser feito com facilitismos, pois a área de superfície inclui qualquer biblioteca de compressão suportada, em adição aos formatos de arquivo e aos próprios ficheiros de controle. Executar essas operações sobre dados não-confiáveis como root é fortemente desaconselhado.

note: type: textblock
en: Building package archives should only be performed over trusted data.
pt: A compilação de arquivos de pacotes só deve ser executada sobre dados de confiança.

note: type: textblock
en: B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing.
pt: B<dpkg-deb -I> I<pacote1>B<.deb> I<pacote2>B<.deb> faz a coisa errada.

note: type: textblock
en: There is no authentication on B<.deb> files; in fact, there isn't even a straightforward checksum.  (Higher level tools like APT support authenticating B<.deb> packages retrieved from a given repository, and most packages nowadays provide an md5sum control file generated by debian/rules.  Though this is not directly supported by the lower level tools.)
pt: Não há autenticação nos ficheiros B<.deb>; de facto, nem sequer há um sumário de verificação sincero. (Ferramentas de alto nível como o APT suportam autenticação de pacote B<.deb> obtida a partir de um dado repositório, e a maioria dos pacotes hoje em dia fornecem um ficheiro de controle md5sum gerado por debian/rules. Apesar de isto não ser suportado directamente pelas ferramentas de baixo nível.)

note: type: textblock
en: dpkg-distaddfile - add entries to debian/files
pt: dpkg-distaddfile - adiciona entradas a debian/files

note: type: textblock
en: B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>.
pt: B<dpkg-distaddfile> adiciona uma entrada para um ficheiro nomeado em B<debian/files>.

note: type: textblock
en: It takes three non-option arguments, the filename and the section and priority for the B<.changes> file.
pt: Requer três argumentos não-opção, o nome do ficheiro, a secção e a prioridade para o ficheiro B<.changes>.

note: type: textblock
en: The filename should be specified relative to the directory where B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than being a pathname relative to the current directory when B<dpkg-distaddfile> is run.
pt: O nome do ficheiro deve ser especificado relativamente ao directório onde B<dpkg-genchanges> espera ir encontrar os ficheiros, geralmente B<..>, em vez de ser um nome de caminho relativo ao directório actual quando o B<dpkg-distaddfile> é corrido.

note: type: textblock
en: Read or write the list of files to be uploaded here, rather than using B<debian/files>.
pt: Lê ou escreve a lista de ficheiros a ser enviada para aqui, em vez de usar B<debian/files>.

note: type: textblock
en: The list of generated files which are part of the upload being prepared.  B<dpkg-distaddfile> can be used to add additional files.
pt: A lista de ficheiros gerados que fazem parte do envio a ser preparado. Pode ser usado B<dpkg-distaddfile> para adicionar ficheiros adicionais.

note: type: textblock
en: dpkg-divert - override a package's version of a file
pt: dpkg-divert - sobrepõe a versão de pacote de um ficheiro

note: type: textblock
en: B<dpkg-divert> is the utility used to set up and update the list of diversions.
pt: B<dpkg-divert> é o utilitário usado para definir e actualizar a lista de desvios.

note: type: textblock
en: File I<diversions> are a way of forcing L<dpkg(1)> not to install a file into its location, but to a I<diverted> location.  Diversions can be used through the package maintainer scripts to move a file away when it causes a conflict.  System administrators can also use it to override some package's configuration file, or whenever some files (which aren't marked as “conffiles”) need to be preserved by B<dpkg>, when installing a newer version of a package which contains those files.
pt: I<diversions> de ficheiros são um modo de forçar o L<dpkg(1)> a não instalar um ficheiro na sua localização, mas numa localização I<desviada>. Estes desvios podem ser usados através dos scripts de maintainer de pacote para afastar um ficheiro quando este causa um conflito. Os administradores de sistemas também o podem usar para sobrepor ficheiros de configuração de alguns pacotes, ou sempre que alguns ficheiros (que não sejam marcados como “conffiles”) precisam de ser conservados pelo B<dpkg>, quando instala uma versão mais recente do pacote que contém esses ficheiros.

note: type: textblock
en: Add a diversion for I<file>.  The file is currently not renamed, see B<--rename>.
pt: Adiciona um desvio para I<file>. Este ficheiro é actualmente não renomeado, veja B<--rename>.

note: type: textblock
en: Remove a diversion for I<file>.  The file is currently not renamed, see B<--rename>.
pt: Remove um desvio para I<file>. Este ficheiro é actualmente não renomeado, veja B<--rename>.

note: type: textblock
en: List all diversions, or ones matching I<glob-pattern>.
pt: Lista todos os desvios, ou os que correspondem a I<glob-pattern>.

note: type: textblock
en: Print the name of the package that diverts I<file> (since dpkg 1.15.0).  Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not diverted.
pt: Escreve o nome do pacote que desvia I<file> (desde dpkg 1.15.0).  Escreve LOCAL se I<file> é desviado localmente e nada se I<file> não é desviado.

note: type: textblock
en: Print the real name for a diverted file.
pt: Escreve o nome real para um ficheiro desviado.

note: type: textblock
en: Set the administrative directory to I<directory>.  Defaults to «I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set.
pt: Define o directório administrativo para I<directory>. A predefinição é «I<%ADMINDIR%>» se B<DPKG_ADMINDIR> não estiver definido.

note: type: textblock
en: Set the installation directory, which refers to the directory where packages get installed (since dpkg 1.19.2).  Defaults to «I</>» if B<DPKG_ROOT> has not been set.
pt: Define o directório de instalação, o que se refere ao directório onde os pacotes são instalados (desde dpkg 1.19.2). A predefinição é «I</>» se B<DPKG_ROOT> não estiver definido.

note: type: textblock
en: Set the root directory to B<directory>, which sets the installation directory to «I<directory>» and the administrative directory to «I<directory>B<%ADMINDIR%>» (since dpkg 1.19.2)  if B<DPKG_ROOT> has not been set.
pt: Define o directório raiz para B<directory>, o que define o directório de instalação para «I<directory>» e o directório administrativo para «I<directory>B<%ADMINDIR%>» (desde dpkg 1.19.2) se B<DPKG_ROOT> não estiver definido.

note: type: textblock
en: I<divert-to> is the location where the versions of I<file>, as provided by other packages, will be diverted.
pt: I<divert-to> é a localização para onde as versões de I<file>, como fornecido por outros pacotes, serão desviadas.

note: type: textblock
en: Specifies that all packages' versions of this file are diverted.  This means, that there are no exceptions, and whatever package is installed, the file is diverted.  This can be used by an admin to install a locally modified version.
pt: Especifica que todas as versões de pacotes deste ficheiro são desviadas. Isto significa, que não há excepções, e seja em que pacote esteja instalado, o ficheiro é desviado. Isto pode ser usado pro uma administrador para instalar uma versão modificada localmente.

note: type: textblock
en: I<package> is the name of a package whose copy of I<file> will not be diverted.  i.e. I<file> will be diverted for all packages except I<package>.
pt: I<package> é o nome do pacote cuja cópia de I<file> não será desviada. Isto é, I<file> será desviado para todos os pacotes excepto I<package>.

note: type: textblock
en: Quiet mode, i.e. no verbose output.
pt: Modo silencioso, isto é, não há resultados detalhados.

note: type: textblock
en: Actually move the file aside (or back).  B<dpkg-divert> will abort operation in case the destination file already exists.  This is the common behavior used for diversions of files from the non-B<Essential> package set (see B<--no-rename> for more details).
pt: Actualmente mete o ficheiro de lado (ou para trás). B<dpkg-divert> irá abortar a operação no caso do ficheiro de destino já existir. Este é o comportamento comum usado para desvios de ficheiros de um conjunto de pacotes não-B<Essential> (veja B<--no-rename> para mais detalhes).

note: type: textblock
en: Specifies that the file should not be renamed while adding or removing the diversion into the database (since dpkg 1.19.1).  This is intended for diversions of files from the B<Essential> package set, where the temporary disappearance of the original file is not acceptable, as it can render the system non-functional.  This is the default behavior, but that will change in the dpkg 1.20.x cycle.
pt: Especifica que o ficheiro não deve ser renomeado enquanto se adiciona ou remove o desvio na base de dados (desde dpkg 1.19.1). Isto destina-se a desvios de ficheiros do conjunto de pacotes B<Essential>, onde o desaparecimento temporário do ficheiro original não é aceitável, pois pode tornar o sistema não-funcional. Este é o comportamento predefinido, mas isso irá mudar no ciclo dpkg 1.20.x.

note: type: textblock
en: Test mode, i.e. don't actually perform any changes, just demonstrate.
pt: Modo de teste, isto é, não faz realmente nenhumas alterações, apenas uma demonstração.

note: type: textblock
en: If set and the B<--instdir> or B<--root> options have not been specified, it will be used as the filesystem root directory (since dpkg 1.19.2).
pt: Se definido e as opções B<--instdir> ou B<--root> não foram especificadas, será usado como o directório raiz do sistema de ficheiros (desde dpkg 1.19.2).

note: type: textblock
en: If set and the B<--admindir> or B<--root> options have not been specified, it will be used as the B<dpkg> data directory.
pt: Se definido e as opções B<--admindir> ou B<--root> não foram especificadas, será usado como o directório de dados do B<dpkg>.

note: type: textblock
en: If set and the B<--local> and B<--package> options have not been specified, B<dpkg-divert> will use it as the package name.
pt: Se definido e as opções B<--local> e B<--package> não foram especificadas, B<dpkg-divert> irá usa-lo como o nome do pacote.

note: type: textblock
en: Sets the debug mask (since dpkg 1.21.10) from an octal value.  The currently accepted flags are described in the B<dpkg --debug> option, but not all these flags might have an effect on this program.
pt: Define a máscara de depuração (desde dpkg 1.21.10) a partir dum valor octal. As bandeiras presentemente aceites estão descritas na opção B<dpkg --debug>, mas nem todas estas bandeiras podem ter um efeito neste programa.

note: type: textblock
en: File which contains the current list of diversions of the system.  It is located in the B<dpkg> administration directory, along with other files important to B<dpkg>, such as I<status> or I<available>.
pt: Ficheiro que contém a lista actual das divergências do sistema. Está localizado no directório de administração do B<dpkg>, juntamente com outros ficheiros importantes para o B<dpkg>, tais como <estado> ou I<disponível>.

note: type: textblock
en: B<Note>: B<dpkg-divert> preserves the old copy of this file, with extension I<-old>, before replacing it with the new one.
pt: B<Nota>: O B<dpkg-divert> preserva uma cópia antiga deste ficheiro, com a extensão I<-old>, antes do o substituir pelo novo.

note: type: textblock
en: When adding, default is B<--local> and B<--divert> I<original>B<.distrib>.  When removing, B<--package> or B<--local> and B<--divert> must match if specified.
pt: Quando adiciona, a predefinição é B<--local> e B<--divert> I<original>B<.distrib>. Quando remove, B<--package> ou B<--local> e B<--divert> tem de corresponder se for especificado.

note: type: textblock
en: Directories can't be diverted with B<dpkg-divert>.
pt: Os directórios não podem ser desviados com B<dpkg-divert>.

note: type: textblock
en: Care should be taken when diverting shared libraries, L<ldconfig(8)> creates a symbolic link based on the DT_SONAME field embedded in the library.  Because B<ldconfig> does not honor diverts (only B<dpkg> does), the symlink may end up pointing at the diverted library, if a diverted library has the same SONAME as the undiverted one.
pt: Deve tomar-se cuidado ao desviar bibliotecas partilhadas, L<ldconfig(8)> cria um link simbólico baseado no campo DT_SONAME embebido na biblioteca. Devido a B<ldconfig> não honrar desvios (apenas B<dpkg> o faz), o link simbólico pode acabar a apontar para a biblioteca desviada, se uma biblioteca desviada tiver o mesmo SONAME que a não desviada.

note: type: textblock
en: To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, i.e. directs all packages providing I</usr/bin/example> to install it as I</usr/bin/example.foo>, performing the rename if required:
pt: Para desviar todas as cópias de um I</usr/bin/example> para I</usr/bin/example.foo>, isto é, direciona todos os pacotes que fornecem I</usr/bin/example> para o instalar como I</usr/bin/example.foo>, executando a mudança de nome caso necessário:

note: type: textblock
en: To remove that diversion:
pt: Para remover esse desvio:

note: type: textblock
en: To divert any package trying to install I</usr/bin/example> to I</usr/bin/example.foo>, except your own I<wibble> package:
pt: Para desviar qualquer pacote que tente instalar I</usr/bin/example> para I</usr/bin/example.foo>, excepto o seu próprio pacote I<wibble>:

note: type: textblock
en: dpkg-fsys-usrunmess - undoes the merged-/usr-via-aliased-dirs mess
pt: dpkg-fsys-usrunmess - desfaz a confusão merged-/usr-via-aliased-dirs

note: type: textblock
en: B<dpkg-fsys-usrunmess> is a tool to fix up filesystems that have been installed anew with recent installers with unfortunate defaults or migrated to the broken merged /usr via aliased directories layout, which is B<not> supported by dpkg.  See the dpkg FAQ.
pt: B<dpkg-fsys-usrunmess> é uma ferramenta para corrigir sistemas de ficheiros que foram instalados de novo com instaladores recentes de predefinições infelizes ou migrados para um /usr danificado via directórios de disposição de nomes alternativos, o qual B<não> é suportado pelo dpkg. Veja a FAQ do dpkg.

note: type: textblock
en: B<Note>: In Debian its tech-ctte has decreed that on the release after bookworm the non-usrmerged layout is not going to be supported, and thus some of its maintainers might not fix issues or intentionally remove non-usrmerged support, so you will need decide and pick your poison.
pt: B<Nota>: Em Debian o seu tech-ctte decretou que num lançamento após o bookworm a disposição não-usrmerged não irá ser suportada, e assim alguns dos seus maintainers podem não corrigir problemas ou intencionalmente remover o suporta não-usrmerged, assim você tem de decidir e escolher o seu veneno.

note: type: textblock
en: The program will perform the following overall actions:
pt: Este programa irá executar as seguintes acções gerais:

note: type: textblock
en: Check whether the system needs to be switched, otherwise do nothing,
pt: Verifica se o sistema precisa de ser comutado, caso contrário não faz nada.

note: type: textblock
en: Check for dpkg database consistency and otherwise abort.
pt: Verifica a consistência da base de dados do dpkg e caso contrário aborta.

note: type: textblock
en: Generate and install a regression prevention package, if requested on the command-line or otherwise on the prompt.
pt: Gera e instala um pacote de prevenção de regressão, se pedido na linha de comandos ou caso contrário na solicitação.

note: type: textblock
en: Get the list of files and alternatives that need to be restored.
pt: Obtém a lista de ficheiros e alternativas que precisam ser restaurados.

note: type: textblock
en: Look for untracked kernel modules files that need to be moved too.
pt: Procura ficheiros de módulos de kernel não vigiados que possam precisar se ser movidos também.

note: type: textblock
en: Create a shadow hierarchy under F</.usrunmess>, by creating the directories symlinks or hardlinking or copying the files as needed.
pt: Cria uma hierarquia sombra sob F</.usrunmess>, ao criar os links simbólicos de directórios ou por ligações rijas ou copiando os ficheiros como necessário.

note: type: textblock
en: Prompt for confirmation before proceeding, if requested on the command-line.
pt: Pede confirmação antes de proceder, se requerido na linha de comandos.

note: type: textblock
en: Lock the dpkg database.
pt: Tranca a base de dados do dpkg.

note: type: textblock
en: Mark all packages as half-configured to force running maintainer scripts that might need to recreate files.
pt: Marca todos os pacotes como meio instalados para forçar o correr dos scripts de maintainer que podem precisar de recriar ficheiros.

note: type: textblock
en: Replace the aliased directories with the shadow ones, by creating a backup of the old symlinked directories and renaming the shadow ones over.
pt: Substitui os directórios de nomes alternativos pelos sombra, ao criar uma cópia de salvaguarda dos antigos directórios de links simbólicos e renomeando os sombra sobre os outros.

note: type: textblock
en: Relabel MAC information for directories and symlinks if necessary.
pt: Re-etiqueta a informação MAC para directórios e links simbólicos se necessário.

note: type: textblock
en: Remove backup symlinks.
pt: Remove links simbólicos de salvaguarda.

note: type: textblock
en: Remove old moved objects, but defer directory removal.
pt: Remove os objectos movidos antigos, mas adia a remoção de directórios.

note: type: textblock
en: Remove old deferred directories that are not referenced by dpkg-query.
pt: Remove directórios adiados antigos que não estão referidos pelo dpkg-query.

note: type: textblock
en: Remove shadow root directory.
pt: Remove o directório raiz sombra.

note: type: textblock
en: Register a B<policy-rc.d> to disallow service actions, which means that services might need to be restarted afterwards, ideally via a reboot.
pt: Regista um B<policy-rc.d> para proibir acções de serviço, o que significa que os serviços podem precisar de serem reiniciados após isto, idealmente com um reiniciar da máquina.

note: type: textblock
en: Reconfigure all packages.
pt: Reconfigura todos os pacotes.

note: type: textblock
en: Unregister the B<policy-rc.d> and restore the alternatives state.
pt: Retira o registo de B<policy-rc.d> e restaura o estado das alternativas.

note: type: textblock
en: B<Note>: When running the program from some shells such as L<bash(1)> or L<zsh(1)>, after executing it, you might need to request the shell to forget all remembered executable locations with for example C<hash -r>.
pt: B<Nota>: Quando se corre o programa a partir de alguma shells tais como L<bash(1)> ou L<zsh(1)>, após o executar, você pode precisar de requisitar à shell para esquecer todas as localizações de executáveis lembradas com por exemplo C<hash -r>.

note: type: textblock
en: B<Note>: Some directories might linger after the migration in case they contain untracked files.  A list is printed once the script has finished for further investigation.
pt: B<Nota>: Alguns directórios podem demorar após a migração no caso de conterem ficheiros não acompanhados. É escrita uma lista assim que o script terminar para investigação posterior.

note: type: textblock
en: B<Warning>: Note that this operation has the potential to render the system unusable or broken in case of a sudden crash or reboot, unexpected state of the system, or possible bugs in the script.  Be prepared with recovery media and consider doing backups beforehand.
pt: B<Aviso>: Note que esta operação tem o potencial de tornar o sistema não utilizável ou quebrado em caso de uma pagarem súbita ou reinicio do sistema. estado inesperado do sistema, ou possíveis bugs no script. Esteja preparado com meio de recuperação e considere fazer cópias de salvaguarda antes.

note: type: textblock
en: This program was introduced in dpkg 1.20.6.
pt: Este programa foi introduzido no dpkg 1.20.6.

note: type: textblock
en: Prompt at the time of no return, so that the debug output or the shadow hierarchy can be evaluated before proceeding.
pt: Pergunta no ponto de não retorno, para que os resultados de depuração da hierarquia sombra possam ser avaliados antes de proceder.

note: type: textblock
en: Enables or disables generating and installing a regression prevention package into the system.  If no option has been specified, the action to take will be prompted.
pt: Activa ou desactiva a a geração e instalação de um pacote de prevenção de regressão no sistema. Se nenhuma opção for fornecida, será solicitada qual a acção a tomar.

note: type: textblock
en: The generated package contains the B<Protected> field set to B<yes> to protect against accidental removal of the package.
pt: O pacote gerado contém o campo B<Protected> definido para B<yes> para proteção contra remoção acidental do pacote.

note: type: textblock
en: This option enables the dry-run mode, where no destructive action takes place, only the preparatory part.
pt: Esta opção activa o modo dry-run, onde não há acções destrutivas, apenas a parte de preparação.

note: type: textblock
en: This setting defines whether to enable dry-run mode.
pt: Esta definição define se se deve activar o modo dry-run.

note: type: textblock
en: dpkg-genbuildinfo - generate Debian .buildinfo files
pt: dpkg-genbuildinfo - gera ficheiros .buildinfo de Debian

note: type: textblock
en: B<dpkg-genbuildinfo> reads information from an unpacked and built Debian source tree and from the files it has generated and generates a Debian control file describing the build environment and the build artifacts (B<.buildinfo> file).
pt: B<dpkg-genbuildinfo> lê informação a partir de uma árvore fonte Debian compilada e desempacotada e dos ficheiros que gerou, e gera um ficheiro de controle Debian que descreve o ambiente de compilação e os artefactos de compilação (ficheiro B<.buildinfo>).

note: type: textblock
en: This program was introduced in dpkg 1.18.11.
pt: Este programa foi introduzido no dpkg 1.18.11.

note: type: textblock
en: Specifies the build I<type> from a comma-separated list of components.
pt: Especifica o I<type> de compilação a partir de uma lista de componente separados por vírgulas.

note: type: textblock
en: Generate build information including unqualified build dependencies (B<Build-Depends>) and architecture specific build dependencies (B<Build-Depends-Arch>).
pt: Gera informação de compilação incluindo dependências de compilação não qualificadas (B<Build-Depends>) e dependências de compilação específicas da arquitectura (B<Build-Depends-Arch>).

note: type: textblock
en: Generate build information including unqualified build dependencies (B<Build-Depends>) and architecture independent build dependencies (B<Build-Depends-Indep>).
pt: Gera informação de compilação incluindo dependências de compilação não qualificadas (B<Build-Depends>) e dependências de compilação independentes da arquitectura (B<Build-Depends-Indep>).

note: type: textblock
en: Effectively ignored; generate build information with just the unqualified build dependencies (B<Build-Depends>).
pt: Efectivamente ignorado; gera informação de compilação com apenas as dependências de compilação não qualificadas (B<Build-Depends>).

note: type: textblock
en: Generate build information with all three types of build dependencies.  This is an alias for B<any,all>.
pt: Gera informação de compilação com todos os três tipos de dependências de compilação. Isto é um alias para B<any,all>.

note: type: textblock
en: Generate build information with all three types of build dependencies.  This is an alias for B<any,all,source>, and the same as the default case when no build option is specified.
pt: Gera informação de compilação com todos os três tipos de dependências de compilação. Isto é um alias para B<any,all,source>, e o mesmo que o caso predefinido quando não é especificada nenhuma opção de compilação.

note: type: textblock
en: Specifies the main source control file to read information from.  The default is B<debian/control>.
pt: Especifica o ficheiro de controle fonte principal de onde ler informação. A predefinição é B<debian/control>.

note: type: textblock
en: Specifies the changelog file to read information from.  The default is B<debian/changelog>.
pt: Especifica o ficheiro de registo de alterações de onde ler informação. A predefinição é B<debian/changelog>.

note: type: textblock
en: Specifies where is the list of files that have been produced by the build, rather than using B<debian/files>.
pt: Especifica onde está a lista de ficheiros que foram produzidos pela compilação em vez de se usar B<debian/files>.

note: type: textblock
en: Specifies the format of the changelog.  See L<dpkg-parsechangelog(1)> for information about alternative formats.
pt: Especifica o formato do registo de alterações. Veja L<dpkg-parsechangelog(1)> para informação acerca dos formatos alternativos.

note: type: textblock
en: Print the buildinfo file to standard output (or I<filename> if specified)  rather than to I<dir>B</>I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo> (where I<dir> is B<..> by default or I<upload-files-dir> if B<-u> was used).
pt: Escreve o ficheiro buildinfo na saída standard (ou I<filename> se especificado) em vez de I<dir>B</>I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo> (onde I<dir> é B<..> por predefinição ou I<upload-files-dir> se for usado B<-u>).

note: type: textblock
en: Look for the files to be uploaded in I<upload-files-dir> rather than B<..> (B<dpkg-genbuildinfo> needs to find these files so that it can include their sizes and checksums in the B<.buildinfo> file).
pt: Procura pelos ficheiros a serem enviados em I<upload-files-dir> em vez de B<..> (B<dpkg-genbuildinfo> precisa de encontrar estes ficheiros para que possa incluir os seus tamanhos e somatórios de verificação no ficheiro B<.buildinfo>).

note: type: textblock
en: By default, the B<Build-Kernel-Version> field will not be written out.
pt: Por predefinição, o campo B<Build-Kernel-Version> não será escrito.

note: type: textblock
en: Specify this option (since dpkg 1.19.0) to always write a B<Build-Kernel-Version> field when generating the B<.buildinfo>.
pt: Especifica que esta opção (desde dpkg 1.19.0) deve sempre escrever um campo B<Build-Kernel-Version> quando gera o B<.buildinfo>.

note: type: textblock
en: By default, the B<Build-Path> field will only be written if the current directory starts with an allowed pattern.
pt: Por predefinição, o campo B<Build-Path> só será escrito se o directório actual começar com um padrão autorizado.

note: type: textblock
en: On Debian and derivatives the pattern matches on B</build/> at the start of the pathname.
pt: Em Debian e derivados, o padrão corresponde a B</build/> no inicio do nome de caminho.

note: type: textblock
en: Specify this option to always write a B<Build-Path> field when generating the B<.buildinfo>.
pt: Especifica que esta opção deve sempre escrever um campo B<Build-Path> quando gera o B<.buildinfo>.

note: type: textblock
en: Change the location of the B<dpkg> database.  The default location is I</var/lib/dpkg>.
pt: Altera a localização da base de dados do B<dpkg>. A localização predefinida é I</var/lib/dpkg>.

note: type: textblock
en: B<dpkg-genbuildinfo> might produce informative messages on standard error.  B<-q> suppresses these messages.
pt: B<dpkg-genbuildinfo> pode produzir mensagens informativas no erro standard. B<-q> suprime essas mensagens.

note: type: textblock
en: This variable can be used to enable or disable various features that affect the information included in the .buildinfo file, via the B<buildinfo> option (since dpkg 1.18.19).  This option contains a comma-separated list of features, prefixed with the ‘B<+>’ or ‘B<->’ modifiers, to denote whether to enable or disable them.  The special feature “B<all>” can be used to enable or disable all other features.  The feature “B<path>” controls whether to unconditionally include the B<Build-Path> field.
pt: Esta variável pode ser usada para activar e desactivar várias funcionalidades que afectam a informação incluída no ficheiro .buildinfo, via opção B<buildinfo> (desde dpkg 1.18.19). Esta opção contém uma lista separada por vírgulas de funcionalidades, prefixadas com os modificadores ‘B<+>’ ou ‘B<->’, para denotar se se os deve activar ou desactivar. A funcionalidade especial “B<all>” pode ser usada para activar ou desactivar todas as outras funcionalidades. A funcionalidade "B<path>” controla se se deve incluir incondicionalmente o campo B<Build-Path>.

note: type: textblock
en: The list of generated files.  B<dpkg-genbuildinfo> reads the data here when producing a B<.buildinfo> file.
pt: A lista de ficheiros gerados.  B<dpkg-genbuildinfo> lê os dados aqui quando produz um ficheiro B<.buildinfo>.

note: type: textblock
en: dpkg-genchanges - generate Debian .changes files
pt: dpkg-genchanges - gera ficheiros .changes Debian

note: type: textblock
en: B<dpkg-genchanges> reads information from an unpacked and built Debian source tree and from the files it has generated and generates a Debian upload control file (B<.changes> file).
pt: B<dpkg-genchanges> lê informação a partir de uma árvore fonte de compilação Debian desempacotada e dos ficheiros que ela gerou e gera um ficheiro de controle de envio Debian (o ficheiro B<.changes>).

note: type: textblock
en: Specifies the build I<type> from a comma-separated list of components (since dpkg 1.18.5).
pt: Especifica o I<type> de compilação a partir de uma lista de componentes separados por vírgulas (desde dpkg 1.18.5).

note: type: textblock
en: Upload the source package.
pt: Envia o pacote fonte (Upload).

note: type: textblock
en: Upload the architecture specific binary packages.
pt: Envia os pacotes binários específicos de arquitectura.

note: type: textblock
en: Upload the architecture independent binary packages.
pt: Envia os pacotes binários independentes de arquitectura.

note: type: textblock
en: Upload the architecture specific and independent binary packages.  This is an alias for B<any,all>.
pt: Envia os pacotes binários independentes e específicos de arquitectura. Isto é uma alias para B<any,all>.

note: type: textblock
en: Upload everything.  This is alias for B<source,any,all>, and the same as the default case when no build option is specified.
pt: Envia tudo. Isto é um alias para B<source,any,all>, e o mesmo que o caso  predefinido quando não é especificada nenhuma opção de compilação.

note: type: textblock
en: The B<-s>I<x> options control whether the original source archive is included in the upload if any source is being generated (i.e.  B<-b> or B<-B> haven't been used).
pt: As opções B<-s>I<x> controlam se o arquivo fonte original é incluído no envio se alguma fonte estiver a ser gerada (isto é, B<-b> or B<-B> não foram usados).

note: type: textblock
en: By default, or if specified, the original source will be included only if the upstream version number (the version without epoch and without Debian revision) differs from the upstream version number of the previous changelog entry.
pt: Por predefinição, ou se especificado, a fonte original será incluída apenas se o número da versão do autor (a versão sem a época e sem a revisão Debian) diferir do número da versão de autor da entrada anterior no changelog.

note: type: textblock
en: Forces the inclusion of the original source.
pt: Força a inclusão da fonte original.

note: type: textblock
en: Forces the exclusion of the original source and includes only the diff.
pt: Força a exclusão da fonte original e inclui só o diff.

note: type: textblock
en: Causes changelog information from all versions strictly later than I<version> to be used.
pt: Faz com que a informação do changelog de todas as versões seja estritamente posterior do que a I<version> a ser usada.

note: type: textblock
en: Read the description of the changes from the file I<changes-description> rather than using the information from the source tree's changelog file.
pt: Lê a descrição das alterações a partir do ficheiro I<changes-description> em vez de usar a informação do ficheiro changelog da árvore fonte.

note: type: textblock
en: Use I<maintainer-address> as the name and email address of the maintainer for this package, rather than using the information from the source tree's control file.
pt: Usa I<maintainer-address> como o nome e endereço de email do maintainer deste pacote, em vez de usar a informação do ficheiro de controle da árvore fonte.

note: type: textblock
en: Use I<maintainer-address> as the name and email address of the maintainer for this upload, rather than using the information from the source tree's changelog.
pt: Usa I<maintainer-address> como o nome e endereço de email do maintainer deste pacote, em vez de usar a informação do changelog da árvore fonte.

note: type: textblock
en: Set an output substitution variable.  See L<deb-substvars(5)> for a discussion of output substitution.
pt: Define uma variável de substituição de saída. Veja L<deb-substvars(5)> para uma discussão sobre substituição da saída.

note: type: textblock
en: Read substitution variables in I<substvars-file>; the default is B<debian/substvars>.  No variable substitution is done on any of the fields that are output, except for the contents extracted from each binary package B<Description> field (since dpkg 1.19.0), however the special variable I<Format> will override the field of the same name.  This option can be used multiple times to read substitution variables from multiple files (since dpkg 1.15.6).
pt: Lê variáveis de substituição em I<substvars-file>; a predefinição é B<debian/substvars>.  Nenhuma substituição de variável é feita em nenhum dos campos resultantes, excepto para o conteúdo extraído do campo B<Description> de cada pacote binário (desde dpkg 1.19.0), no entanto, a variável especial I<Format> irá sobrepor o campo com o mesmo nome. Esta opção pode ser usada várias vezes para ler varáveis de substituição de vários ficheiros (desde dpkg 1.15.6).

note: type: textblock
en: Override or add an output control file field.
pt: Sobrepõe ou adiciona um campo de ficheiro de controle de resultado.

note: type: textblock
en: Remove an output control file field.
pt: Remove um campo de ficheiro de controle de resultado.

note: type: textblock
en: Read the list of files to be uploaded here, rather than using B<debian/files>.
pt: Lê a lista de ficheiros a serem enviados aqui, em vez de usar B<debian/files>.

note: type: textblock
en: Look for the files to be uploaded in I<upload-files-dir> rather than B<..> (B<dpkg-genchanges> needs to find these files so that it can include their sizes and checksums in the B<.changes> file).
pt: Procura pelos ficheiros a serem enviados em I<upload-files-dir> em vez de B<..> (B<dpkg-genchanges> precisa de encontrar estes ficheiros para que possa incluir os seus tamanhos e somatórios de verificação no ficheiro B<.changes>).

note: type: textblock
en: Usually B<dpkg-genchanges> will produce informative messages on standard error, for example about how many of the package's source files are being uploaded.  B<-q> suppresses these messages.
pt: Geralmente B<dpkg-genchanges> irá produzir mensagens informativas no erro standard, por exemplo acerca de quantos dos ficheiros fonte do pacote estão a ser enviados. B<-q> suprime essas mensagens.

note: type: textblock
en: Print the changes file to standard output (the default) or to I<filename> if specified (since dpkg 1.18.5).
pt: Escreve o ficheiro de alterações na saída standard (o predefinido) ou para I<filename> se especificado (desde dpkg 1.18.5).

note: type: textblock
en: The list of generated files which are part of the upload being prepared.  B<dpkg-genchanges> reads the data here when producing a B<.changes> file.
pt: A lista de ficheiros gerados que são parte do envio (upload) que está a ser preparado. O B<dpkg-genchanges> lê os dados aqui quando produz um ficheiro B<.changes>.

note: type: textblock
en: dpkg-gencontrol - generate Debian control files
pt: dpkg-gencontrol - gera ficheiros de controle Debian

note: type: textblock
en: B<dpkg-gencontrol> reads information from an unpacked Debian source tree and generates a binary package control file (which defaults to debian/tmp/DEBIAN/control); during this process it will simplify the relation fields.
pt: B<dpkg-gencontrol> lê informação a partir duma árvore fonte Debian desempacotada e gera um ficheiro de controle de pacote binário (que por predefinição é debian/tmp/DEBIAN/control); durante este processo irá simplificar so campos de relação.

note: type: textblock
en: Thus B<Pre-Depends>, B<Depends>, B<Recommends> and B<Suggests> are simplified in this order by removing dependencies which are known to be true according to the stronger dependencies already parsed.  It will also remove any self-dependency (in fact it will remove any dependency which evaluates to true given the current version of the package as installed).  Logically it keeps the intersection of multiple dependencies on the same package.  The order of dependencies is preserved as best as possible: if any dependency must be discarded due to another dependency appearing further in the field, the superseding dependency will take the place of the discarded one.
pt: Portanto B<Pre-Depends>, B<Depends>, B<Recommends> e B<Suggests> são simplificados nesta ordem ao se remover dependências que se sabe serem verdadeiras de acordo com as dependências mais fortes já analisadas. Irá também remover qualquer auto-dependência (de facto irá remover qualquer dependência que avalia para verdadeira dado a versão actual do pacote como instalado). Logicamente mantém a intersecção de múltiplas dependências no mesmo pacote. A ordem de dependências é preservada o melhor possível. Se qualquer dependência deve ser descartada devido a outra dependência que aparece mais à frente no campo, a dependência substituta irá tomar o  lugar da descartada.

note: type: textblock
en: The other relation fields (B<Enhances>, B<Conflicts>, B<Breaks>, B<Replaces> and B<Provides>)  are also simplified individually by computing the union of the various dependencies when a package is listed multiple times in the field.
pt: Os outros campos de relação (B<Enhances>, B<Conflicts>, B<Breaks>, B<Replaces> e B<Provides>) são também simplificados individualmente  ao computar a união de várias dependências quando um pacote é listado várias vezes no campo.

note: type: textblock
en: B<dpkg-gencontrol> also adds an entry for the binary package to B<debian/files>.
pt: B<dpkg-gencontrol> também adiciona uma entrada para o pacote binário em B<debian/files>.

note: type: textblock
en: Sets the version number of the binary package which will be generated.
pt: Define o número de versão do pacote binário que será gerado.

note: type: textblock
en: Set an output substitution variable.  See L<deb-substvars(5)> for discussion of output substitution.
pt: Define uma variável de substituição de resultado. Veja L<deb-substvars(5)> para discussão sobre substituição de resultado.

note: type: textblock
en: Read substitution variables in I<substvars-file>; the default is B<debian/substvars>.  This option can be used multiple times to read substitution variables from multiple files (since dpkg 1.15.6).
pt: Lê variáveis de substituição em I<substvars-file>; a predefinição é B<debian/substvars>. Esta opção pode ser usada várias vezes para ler variáveis de substituição a partir de vários ficheiros (desde dpkg 1.15.6).

note: type: textblock
en: Generate information for the binary package I<package>.  If the source control file lists only one binary package then this option may be omitted; otherwise it is essential to select which binary package's information to generate.
pt: Gera informação para o pacote binário I<package>. Se o ficheiro de controle fonte listar apenas um pacote binário então esta opção pode ser omitida; caso contrário é essencial para seleccionar que informação de quais pacotes binário gerar.

note: type: textblock
en: Assume the filename of the package will be I<filename> instead of the normal package_version_arch.deb filename.
pt: Assume que o nome do ficheiro do pacote será I<filename> em vez do nome de ficheiro normal pacote_versão_arquitectura.deb.

note: type: textblock
en: These options are ignored for compatibility with older versions of the dpkg build scripts but are now deprecated.  Previously they were used to tell B<dpkg-gencontrol> to include the Section and Priority fields in the control file.  This is now the default behavior.  If you want to get the old behavior you can use the B<-U> option to delete the fields from the control file.
pt: Estas opções são ignoradas para compatibilidade com versões mais antigas dos scripts de compilação do dpkg, mas estão agora descontinuadas. Anteriormente eram usadas para dizer ao B<dpkg-gencontrol> para incluir os campos Section e Priority no ficheiro de controle. Este agora é o comportamento predefinido. Se você deseja obter o comportamento antigo, você pode usar a opção B<-U> para apagar os campos do ficheiro de controle.

note: type: textblock
en: Scan I<package-build-dir> instead of B<debian/tmp>.  This value is used to find the default value of the B<Installed-Size> substitution variable and control file field, and for the default location of the output file.
pt: Sonda I<package-build-dir> em vez de B<debian/tmp>. Este valor é usado para encontrar o valor predefinido da variável  de substituição B<Installed-Size> e o campo de ficheiro de controlo, e para a localização predefinida do ficheiro de saída.

note: type: textblock
en: Print the control file to standard output (or I<filename> if specified, since dpkg 1.17.2), rather than to B<debian/tmp/DEBIAN/control> (or I<package-build-dir>B</DEBIAN/control> if B<-P> was used).
pt: Escreve o ficheiro de controle na saída standard (ou I<filename> se especificado, (desde dpkg 1.17.2), em vez de para B<debian/tmp/DEBIAN/control> (ou I<package-build-dir>B</DEBIAN/control> se B<-P> foi usado).

note: type: textblock
en: The main source control information file, giving version-independent information about the source package and the binary packages it can produce.
pt: O ficheiro de informação de controle de fonte principal, que fornece informação independente da versão acerca do pacote fonte e dos pacotes binários que pode gerar.

note: type: textblock
en: The list of generated files which are part of the upload being prepared.  B<dpkg-gencontrol> adds the presumed filenames of binary packages whose control files it generates here.
pt: A lista de ficheiros gerados que fazem parte do envio a ser preparado. B<dpkg-gencontrol> adiciona os nomes de ficheiros presumidos de pacotes binários cujos ficheiros de controlo gera aqui.

note: type: textblock
en: dpkg-gensymbols - generate symbols files (shared library dependency information)
pt: dpkg-gensymbols - gera ficheiros symbols (informação de dependência de biblioteca partilhada)

note: type: textblock
en: B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) looking for libraries and generates a I<symbols> file describing them.  This file, if non-empty, is then installed in the DEBIAN subdirectory of the build tree so that it ends up included in the control information of the package.
pt: B<dpkg-gensymbols> sonda uma árvore de compilação temporária (debian/tmp por predefinição) à procura de bibliotecas e gera um ficheiro I<symbols> a descreve-los. Este ficheiro, se não vazio, é depois instalado no sub-directório DEBIAN da árvore de compilação para que seja incluído na informação de controle do pacote.

note: type: textblock
en: When generating those files, it uses as input some symbols files provided by the maintainer.  It looks for the following files (and uses the first that is found):
pt: Quando gera esses ficheiros, usa como entrada alguns ficheiros de símbolos disponibilizados pelo maintainer. Procura os seguintes ficheiros (e usa o primeiro que encontra):

note: type: textblock
en: The main interest of those files is to provide the minimal version associated to each symbol provided by the libraries.  Usually it corresponds to the first version of that package that provided the symbol, but it can be manually incremented by the maintainer if the ABI of the symbol is extended without breaking backwards compatibility.  It's the responsibility of the maintainer to keep those files up-to-date and accurate, but B<dpkg-gensymbols> helps with that.
pt: O principal interesse desse ficheiros é disponibilizar a versão mínima associada a cada símbolo fornecido pelas bibliotecas. Geralmente isso corresponde à primeira versão do pacote que forneceu o símbolo, mas pode ser incrementada pelo maintainer se o ABI do símbolo é extensível sem se quebrar a compatibilidade com versões anteriores. É da responsabilidade do maintainer manter esses ficheiros actualizados e precisos, mas o B<dpkg-gensymbols> ajuda com isso.

note: type: textblock
en: When the generated symbols files differ from the maintainer supplied one, B<dpkg-gensymbols> will print a diff between the two versions.  Furthermore if the difference is too significant, it will even fail (you can customize how much difference you can tolerate, see the B<-c> option).
pt: Quando os ficheiros de símbolos gerados diferem daqueles fornecidos pelo maintainer, B<dpkg-gensymbols> irá escrever um diff entre as duas versões. Mais ainda, se a diferença for muito significante, irá mesmo falhar (você pode personalizar quanta diferença pode ser tolerada, veja a opção B<-c>).

note: type: textblock
en: This program was introduced in dpkg 1.14.8.
pt: Este programa foi introduzido no dpkg 1.14.8.

note: type: =head1
en: MAINTAINING SYMBOLS FILES
pt: MANTENDO FICHEIROS DE SÍMBOLOS

note: type: textblock
en: The base interchange format of the symbols file is described in L<deb-symbols(5)>, which is used by the symbols files included in binary packages.  These are generated from template symbols files with a format based on the former, described in L<deb-src-symbols(5)> and included in source packages.
pt: O formato de intercâmbio base do ficheiro de símbolos é descrito em L<deb-symbols(5)>, o qual é usado pelos ficheiros symbols incluídos em pacotes binários. Estes são gerados a partir de ficheiros se símbolos modelo com um formato baseado no anterior, descrito em L<deb-src-symbols(5)> e incluído em pacotes fonte.

note: type: textblock
en: The symbols files are really useful only if they reflect the evolution of the package through several releases.  Thus the maintainer has to update them every time that a new symbol is added so that its associated minimal version matches reality.
pt: Os ficheiros de símbolos são apenas úteis se refletirem a evolução do pacote entre vários lançamentos. Assim o maintainer tem de os actualizar todas as vezes que é adicionado um novo símbolo para que a sua versão mínima associada corresponda à realidade.

note: type: textblock
en: The diffs contained in the build logs can be used as a starting point, but the maintainer, additionally, has to make sure that the behaviour of those symbols has not changed in a way that would make anything using those symbols and linking against the new version, stop working with the old version.
pt: Os diffs contidos nos logs de compilação podem ser usados com ponto de partida, mas o maintainer, adicionalmente, tem de certificar que o comportamento desses símbolos não alterou num modo que faça com que tudo o que usa esses símbolos e em link para a nova versão, deixem de funcionar com a versão antiga.

note: type: textblock
en: In most cases, the diff applies directly to the debian/I<package>.symbols file.  That said, further tweaks are usually needed: it's recommended for example to drop the Debian revision from the minimal version so that backports with a lower version number but the same upstream version still satisfy the generated dependencies.  If the Debian revision can't be dropped because the symbol really got added by the Debian specific change, then one should suffix the version with ‘B<~>’.
pt: Na maioria dos casos, o diff aplica-se directamente ao ficheiro debian/I<package>.symbols. Dito isso, geralmente são necessários mais ajustes: é recomendado, por exemplo, soltar a revisão Debian da versão mínima para que backports com um número de versão inferior mas a mesma versão de autor consigam ainda satisfazer as dependências geradas. Se uma revisão Debian não pode ser largada porque o símbolo foi realmente adicionado pela alteração específica de Debian, então deve-se acrescentar um sufixo à versão com ‘B<~>’.

note: type: textblock
en: Before applying any patch to the symbols file, the maintainer should double-check that it's sane.  Public symbols are not supposed to disappear, so the patch should ideally only add new lines.
pt: Antes de aplicar qualquer patch ao ficheiro symbols, o maintainer deve re-verificar que esta é saudável. Não é suposto símbolos públicos desaparecerem, assim a patch deve idealmente apenas adicionar novas linhas.

note: type: textblock
en: Note that you can put comments in symbols files.
pt: Note que você pode meter comentários em ficheiros de símbolos.

note: type: textblock
en: Do not forget to check if old symbol versions need to be increased.  There is no way B<dpkg-gensymbols> can warn about this.  Blindly applying the diff or assuming there is nothing to change if there is no diff, without checking for such changes, can lead to packages with loose dependencies that claim they can work with older packages they cannot work with.  This will introduce hard to find bugs with (partial)  upgrades.
pt: Não se esqueça de verificar se versões antigas de símbolos precisam de ser aumentadas. Não há maneira de B<dpkg-gensymbols> poder avisar sobre isto. Aplica o diff às cegas ou assumir que não há nada para mudar se não existir um diff, sem verificar por tais mudanças, pode levar a pacotes com dependências soltas, que afirmam poder trabalhar com pacotes mais antigos com que já não podem trabalhar. Isto irá introduzir dificuldades de encontrar bugs com actualizações (parciais).

note: type: =head2
en: Good library management
pt: Boa gestão de biblioteca

note: type: textblock
en: A well-maintained library has the following features:
pt: Uma biblioteca bem mantida tem as seguintes características:

note: type: textblock
en: its API is stable (public symbols are never dropped, only new public symbols are added) and changes in incompatible ways only when the SONAME changes;
pt: A sua API é estável (símbolos públicos nunca são largados, apenas símbolos públicos novos são adicionados) e alterações em modos incompatíveis sempre apenas quando o SONAME muda;

note: type: textblock
en: ideally, it uses symbol versioning to achieve ABI stability despite internal changes and API extension;
pt: idealmente, usa a identificação da versão do símbolo para obter estabilidade da ABI apesar de alterações internas e extensão API;

note: type: textblock
en: it doesn't export private symbols (such symbols can be tagged optional as workaround).
pt: não exporta símbolos privados (tais símbolos podem ser etiquetados de opcionais como meio de contornar).

note: type: textblock
en: While maintaining the symbols file, it's easy to notice appearance and disappearance of symbols.  But it's more difficult to catch incompatible API and ABI change.  Thus the maintainer should read thoroughly the upstream changelog looking for cases where the rules of good library management have been broken.  If potential problems are discovered, the upstream author should be notified as an upstream fix is always better than a Debian specific work-around.
pt: Enquanto se mantém o ficheiro symbols, é fácil percebermos o aparecimento e desaparecimento de símbolos. Mas é  mais difícil apanhar alterações de API e ABI incompatíveis. Assim o maintainer deve ler com atenção o registo de alterações do autor procurando casos onde as regras da boa gestão de bibliotecas foram quebradas. Se forem descobertos potenciais problemas, o autor original deve ser notificado pois uma correcção no autor é sempre melhor que um contorno especifico em Debian.

note: type: textblock
en: Scan I<package-build-dir> instead of debian/tmp.
pt: Sonda I<package-build-dir> em vez de debian/tmp.

note: type: textblock
en: Define the package name.  Required if more than one binary package is listed in debian/control (or if there's no debian/control file).
pt: Define o nome do pacote. Requerido se mais do que um pacote binário estiver listado em debian/control (ou se não existir o ficheiro debian/control).

note: type: textblock
en: Define the package version.  Defaults to the version extracted from debian/changelog.  Required if called outside of a source package tree.
pt: Define a versão do pacote. Usa por predefinição a versão extraída de debian/changelog. Requerido se chamado fora de uma árvore de pacote fonte.

note: type: textblock
en: Only analyze libraries explicitly listed instead of finding all public libraries.  You can use shell patterns used for pathname expansions (see the L<File::Glob> manual page for details) in I<library-file> to match multiple libraries with a single argument (otherwise you need multiple B<-e>).
pt: Apenas analisa bibliotecas explicitas em vez de procurar todas as bibliotecas públicas. Você pode usar padrões de shell usadas para expansões de nome de caminho (veja o manual L<File::Glob> para detalhes) em I<library-file> para corresponder a múltiplas bibliotecas com um único argumento (caso contrário você precisa de múltiplos B<-e>).

note: type: textblock
en: Prepend I<directory> to the list of directories to search for private shared libraries (since dpkg 1.19.1).  This option can be used multiple times.
pt: Precede I<directory> à lista de directórios a pesquisar por bibliotecas partilhadas privadas (desde dpkg 1.19.1). Esta opção pode ser usada várias vezes.

note: type: textblock
en: B<Note>: Use this option instead of setting B<LD_LIBRARY_PATH>, as that environment variable is used to control the run-time linker and abusing it to set the shared library paths at build-time can be problematic when cross-compiling for example.
pt: B<Nota>: Use esta opção em vez de definir B<LD_LIBRARY_PATH>, pois essa variável de ambiente é usado para controlar o vinculador de tempo-de-execução e abusar dela para definir caminhos de bibliotecas partilhadas durante a compilação pode ser problemático quando, por exemplo, se faz compilações cruzadas.

note: type: textblock
en: Use I<filename> as reference file to generate the symbols file that is integrated in the package itself.
pt: Usa I<nome-ficheiro> como ficheiro de referência para gerar o ficheiro de símbolos que é integrado no próprio pacote.

note: type: textblock
en: Print the generated symbols file to standard output or to I<filename> if specified, rather than to B<debian/tmp/DEBIAN/symbols> (or I<package-build-dir>B</DEBIAN/symbols> if B<-P> was used).  If I<filename> is pre-existing, its contents are used as basis for the generated symbols file.  You can use this feature to update a symbols file so that it matches a newer upstream version of your library.
pt: Escreve o ficheiro de símbolos gerado na saída standard ou em I<filename> se especificado, em vez de B<debian/tmp/DEBIAN/symbols> (ou I<package-build-dir>B</DEBIAN/symbols> se B<-P> foi usado). Se I<filename> é pré-existente, o seu conteúdo é usado como base para o ficheiro de símbolos gerado. Você pode usar esta funcionalidade para actualizar um ficheiro de símbolos para que corresponda à nova versão do autor da sua biblioteca.

note: type: textblock
en: Write the symbol file in template mode rather than the format compatible with L<deb-symbols(5)>.  The main difference is that in the template mode symbol names and tags are written in their original form contrary to the post-processed symbol names with tags stripped in the compatibility mode.  Moreover, some symbols might be omitted when writing a standard L<deb-symbols(5)> file (according to the tag processing rules) while all symbols are always written to the symbol file template.
pt: Escreve o ficheiro de símbolos em modo de modelo em vez do formato compatível com L<deb-symbols(5)>. A principal diferença é que em modo de modelo os nomes dos símbolos e as etiquetas são escritos na sua forma original ao contrário dos nomes de símbolos pós-processados com as etiquetas despidas do modo de compatibilidade. Mais ainda, alguns símbolos podem ser omitidos quando se escreve um ficheiro L<deb-symbols(5)> standard (de acordo com as regras de processamento de etiquetas) enquanto que todos os símbolos são sempre escritos no ficheiro modelo de símbolos.

note: type: textblock
en: Define the checks to do when comparing the generated symbols file with the template file used as starting point.  By default the level is 1.  Increasing levels do more checks and include all checks of lower levels.
pt: Define as verificações a fazer quando se compara o ficheiro de símbolos gerado com o ficheiro modelo usado como ponto de partida. Por predefinição o nível é 1. Aumentar os níveis faz mais verificações e inclui todas as verificações de baixo nível.

note: type: =item
en: Level 0
pt: Nível 0

note: type: textblock
en: Never fails.
pt: Nunca falha.

note: type: =item
en: Level 1
pt: Nível 1

note: type: textblock
en: Fails if some symbols have disappeared.
pt: Falha se alguns símbolos tiverem desaparecido.

note: type: =item
en: Level 2
pt: Nível 2

note: type: textblock
en: Fails if some new symbols have been introduced.
pt: Falha se alguns novo símbolos tiverem sido introduzidos.

note: type: =item
en: Level 3
pt: Nível 3

note: type: textblock
en: Fails if some libraries have disappeared.
pt: Falha se algumas bibliotecas tiverem desaparecido.

note: type: =item
en: Level 4
pt: Nível 4

note: type: textblock
en: Fails if some libraries have been introduced.
pt: Falha se algumas bibliotecas tiverem sido introduzidos.

note: type: textblock
en: This value can be overridden by the environment variable B<DPKG_GENSYMBOLS_CHECK_LEVEL>.
pt: Este valor pode ser sobreposto pela variável de ambiente B<DPKG_GENSYMBOLS_CHECK_LEVEL>.

note: type: textblock
en: Keep quiet and never generate a diff between generated symbols file and the template file used as starting point or show any warnings about new/lost libraries or new/lost symbols.  This option only disables informational output but not the checks themselves (see B<-c> option).
pt: Mantêm-se calado e nunca gera um diff entre o ficheiro de símbolos gerados e o ficheiro modelo usando como ponto de arranque nem mostra nenhuns avisos sobre bibliotecas novas/perdidas nem símbolos novos/perdidos. Esta opção apenas desactiva os resultados informativos mas não os próprios  testes (veja a opção B<-c>).

note: type: textblock
en: Assume I<arch> as host architecture when processing symbol files.  Use this option to generate a symbol file or diff for any architecture provided its binaries are already available.
pt: Assume I<arch> como arquitectura anfitriã quando processa ficheiros de símbolos. Use esta opção para gerar um ficheiro de símbolos ou a diferença para qualquer arquitectura desde que os seus binários já estejam disponíveis.

note: type: textblock
en: Enable debug mode.  Numerous messages are displayed to explain what B<dpkg-gensymbols> does.
pt: Activa o modo de depuração. São mostradas numerosas mensagens para explicar o que o B<dpkg-gensymbols> faz.

note: type: textblock
en: Enable verbose mode.  The generated symbols file contains deprecated symbols as comments.  Furthermore in template mode, pattern symbols are followed by comments listing real symbols that have matched the pattern.
pt: Activa modo detalhado. O ficheiro de símbolos gerado contém símbolos abandonados como comentários. Mais ainda, em modo de modelo, os símbolos de padrões são seguidos de comentários que listam símbolos reais que corresponderam ao padrão.

note: type: textblock
en: Overrides the command check level, even if the B<-c> command-line argument was given (note that this goes against the common convention of command-line arguments having precedence over environment variables).
pt: Sobrepõe o nível de verificação do comando, mesmo se o argumento B<-c> de linha de comandos tenha sido dado (note que isto vai contra a convenção comum de argumentos de linha de comandos a ter a precedência sobre as variáveis de ambiente).

note: type: textblock
en: dpkg-maintscript-helper - works around known dpkg limitations in maintainer scripts
pt: dpkg-maintscript-helper - contorna limitações conhecidas do dpkg em scripts de maintainer.

note: type: =head1
en: COMMANDS AND PARAMETERS
pt: COMANDOS E PARÂMETROS

note: type: textblock
en: This program is designed to be run within maintainer scripts to achieve some tasks that B<dpkg> can't (yet) handle natively either because of design decisions or due to current limitations.
pt: Este programa destina-se a ser corrido dentro de scripts de maintainer para conseguir algumas tarefas que o B<dpkg> (ainda) não pode lidar nativamente seja por limitações de desenho ou devido a limitações actuais,

note: type: textblock
en: Many of those tasks require coordinated actions from several maintainer scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>).  To avoid mistakes the same call simply needs to be put in all scripts and the program will automatically adapt its behavior based on the environment variable B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you have to forward after a double hyphen.
pt: Muitas destas tarefas requerem acções coordenadas dos vários scripts de maintainer (B<preinst>, B<postinst>, B<prerm>, B<postrm>). Para evitar enganos a mesma chamada precisa simplesmente de englobar todos os scripts e o programa irá automaticamente adaptar o seu comportamento baseado na variável de ambiente B<DPKG_MAINTSCRIPT_NAME> e nos argumentos dos scripts do maintainer que você tem de reencaminhar após um duplo hífen.

note: type: =head1
en: COMMON PARAMETERS
pt: PARÂMETROS COMUNS

note: type: textblock
en: Defines the latest version of the package whose upgrade should trigger the operation.  It is important to calculate I<prior-version> correctly so that the operations are correctly performed even if the user rebuilt the package with a local version.  If I<prior-version> is empty or omitted, then the operation is tried on every upgrade (note: it's safer to give the version and have the operation tried only once).
pt: Define a versão mais recente do pacote cuja actualização deverá despoletar a operação. É importante calcular I<prior-version> correctamente para que as operações sejam correctamente executadas mesmo que o utilizador recompile o pacote com uma versão local. Se I<prior-version> estiver vazio ou omitido, então a operação é tentada a cada actualização (nora: é mais seguro fornecer a versão e ter a operação tentada apenas uma vez).

note: type: textblock
en: If the conffile has not been shipped for several versions, and you are now modifying the maintainer scripts to clean up the obsolete file, I<prior-version> should be based on the version of the package that you are now preparing, not the first version of the package that lacked the conffile.  This applies to all other actions in the same way.
pt: Se o conffile não tem sido enviado por várias versões, e você está agora a modificar os scripts do maintainer para limpar o ficheiro obsoleto, I<prior-version> deve ser baseado na versão do pacote que está agora a preparar, e não a primeira versão do pacote onde faltou o conffile. Isto aplica-se a todas as outras acções do mesmo modo.

note: type: textblock
en: For example, for a conffile removed in version B<2.0-1> of a package, I<prior-version> should be set to B<2.0-1~>.  This will cause the conffile to be removed even if the user rebuilt the previous version B<1.0-1> as B<1.0-1local1>.  Or a package switching a path from a symlink (shipped in version B<1.0-1>) to a directory (shipped in version B<2.0-1>), but only performing the actual switch in the maintainer scripts in version B<3.0-1>, should set I<prior-version> to B<3.0-1~>.
pt: Por exemplo, para um conffile removido na versão B<2.0-1> de um pacote, I<prior-version> deve ser definido para B<2.0-1~>. Isto irá fazer com que o conffile seja removido mesmo que o utilizador recompile a versão anterior B<1.0-1> como B<1.0-1local1>. Ou um pacote que mude um caminho de um link simbólico (enviado na versão  B<1.0-1>) para um directório (enviado na versão B<2.0-1>), mas apenas executando a mudança real nos scripts do maintainer na versão B<3.0-1>, deve definir I<prior-version> para B<3.0-1~>.

note: type: textblock
en: The package name owning the pathname(s).  When the package is “Multi-Arch: same” this parameter must include the architecture qualifier, otherwise it should B<not> usually include the architecture qualifier (as it would disallow cross-grades, or switching from being architecture specific to architecture B<all> or vice versa).  If the parameter is empty or omitted, the B<DPKG_MAINTSCRIPT_PACKAGE> and B<DPKG_MAINTSCRIPT_ARCH> environment variables (as set by B<dpkg> when running the maintainer scripts) will be used to generate an arch-qualified package name.
pt: O nome do pacote que possui os nome(s) de caminho(s). Quando o pacote é “Multi-Arch: same” este parâmetros tem de incluir o qualificador de arquitectura, caso contrário B<não> deverá geralmente incluir o qualificador de arquitectura ((pois iria desautorizar cruzamento de graduação, ou comutar de ser específico de arquitectura para arquitectura B<all> ou vice versa). Se o parâmetro estiver vazio ou omitido, as variáveis de ambiente B<DPKG_MAINTSCRIPT_PACKAGE> e B<DPKG_MAINTSCRIPT_ARCH> (definidas pelo B<dpkg> ao correr os scripts do maintainer) serão usadas para gerar um nome de pacote com qualificação de arquitectura.

note: type: textblock
en: All the parameters of the maintainer scripts have to be forwarded to the program after B<-->.
pt: Todos os parâmetros dos scripts do maintainer têm de ser encaminhados ao programa após B<-->.

note: type: =head1
en: CONFFILE RELATED TASKS
pt: TAREFAS RELACIONADAS COM FICHEIROS DE CONFIGURAÇÃO

note: type: textblock
en: When upgrading a package, B<dpkg> will not automatically remove a conffile (a configuration file for which B<dpkg> should preserve user changes) if it is not present in the newer version.  There are two principal reasons for this; the first is that the conffile could've been dropped by accident and the next version could restore it, users wouldn't want their changes thrown away.  The second is to allow packages to transition files from a dpkg-maintained conffile to a file maintained by the package's maintainer scripts, usually with a tool like debconf or ucf.
pt: Ao actualizar um pacote, o B<dpkg> não irá automaticamente remover um conffile (um ficheiro de configuração para o qual B<dpkg> deve preservar as alterações do utilizador) se este não estiver presente na versão mais recente. Existem duas razões principais para isto: a primeira é que o conffile poderia ser abandonado por acidente e a próxima versão poderia restaura-lo., e os utilizadores não querem que as suas alterações sejam deitadas fora. A segunda é para permitir aos pacotes transitarem ficheiros de um conffile mantido pelo dpkg para um ficheiro mantido pelos scripts do maintainer do pacote, geralmente com uma ferramenta como debconf ou ucf.

note: type: textblock
en: This means that if a package is intended to rename or remove a conffile, it must explicitly do so and B<dpkg-maintscript-helper> can be used to implement graceful deletion and moving of conffiles within maintainer scripts.
pt: Isto significa que se um pacote se destina a renomear ou remover um conffile, deve explicitamente fazê-lo e B<dpkg-maintscript-helper> pode ser usado para implementar o apagar e mover elegante de conffiles dentro dos scripts do maintainer.

note: type: =head2
en: Removing a conffile
pt: Remover um ficheiro de configuração

note: type: textblock
en: B<Note>: This can be replaced in most cases by the C<remove-on-upgrade> flag in F<DEBIAN/conffiles> (since dpkg 1.20.6), see L<deb-conffiles(5)>.
pt: B<Nota>: Isto pode ser substituído na maioria dos casos pela bandeira C<remove-on-upgrade> em F<DEBIAN/conffiles> (desde dpkg 1.20.6), veja L<deb-conffiles(5)>.

note: type: textblock
en: If a conffile is completely removed, it should be removed from disk, unless the user has modified it.  If there are local modifications, they should be preserved.  If the package upgrade aborts, the newly obsolete conffile should not disappear.
pt: Se um conffile for completamente removido, deve ser removido do disco, a menos que o utilizador o tenha modificado. Se existirem modificações locais, estas devem ser preservadas. Se a actualização do pacote abortar, o conffile obsoleto mais recente não deve desaparecer.

note: type: textblock
en: All of this is implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
pt: tudo isto é implementado ao colocar o seguinte fragmento de shell nos scripts de maintainer B<preinst>, B<postinst> e B<postrm>:

note: type: textblock
en: I<conffile> is the filename of the conffile to remove.
pt: I<conffile> é o nome de ficheiro do conffile a remover.

note: type: textblock
en: Current implementation: in the B<preinst>, it checks if the conffile was modified and renames it either to I<conffile>B<.dpkg-remove> (if not modified) or to I<conffile>B<.dpkg-backup> (if modified).  In the B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept for reference as it contains user modifications but the former will be removed.  If the package upgrade aborts, the B<postrm> reinstalls the original conffile.  During purge, the B<postrm> will also delete the B<.dpkg-bak> file kept up to now.
pt: Implementação actual: no B<preinst>, verifica se o conffile foi modificado e renomeia-o ou para I<conffile>B<.dpkg-remove> (se não modificado) ou para I<conffile>B<.dpkg-backup> (se modificado). No B<postinst>, o último ficheiro é renomeado para I<conffile>B<.dpkg-bak> e mantido para referência pois contem modificações do utilizador mas o antigo será removido. Se a actualização ao pacote abortar, o B<postrm> reinstala o conffile original. Durante a purga, o B<postrm> irá também apagar o ficheiro B<.dpkg-bak> mantido até à data.

note: type: =head2
en: Renaming a conffile
pt: Renomear um conffile

note: type: textblock
en: If a conffile is moved from one location to another, you need to make sure you move across any changes the user has made.  This may seem a simple change to the B<preinst> script at first, however that will result in the user being prompted by B<dpkg> to approve the conffile edits even though they are not responsible of them.
pt: Se um conffile for movido de uma localização para outra, você precisa de certificar que se move por quaisquer alterações que o utilizador tenha feito. Isto pode parecer uma mudança simples para o script B<preinst> no inicio, no entanto isso vai resultar no utilizador a ser questionado pelo B<dpkg> para aprovar as edições no conffile mesmo este não sendo o responsável por elas.

note: type: textblock
en: Graceful renaming can be implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
pt: O renomear elegante pode ser implementado ao colocar o seguinte fragmente do shell nos scripts de maintainer B<preinst>, B<postinst> e B<postrm>:

note: type: textblock
en: I<old-conffile> and I<new-conffile> are the old and new name of the conffile to rename.
pt: I<old-conffile> e I<new-conffile> sãos os nomes antigo e novo do conffile a renomear.

note: type: textblock
en: Current implementation: the B<preinst> checks if the conffile has been modified, if yes it's left on place otherwise it's renamed to I<old-conffile>B<.dpkg-remove>.  On configuration, the B<postinst> removes I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to I<new-conffile> if I<old-conffile> is still available.  On abort-upgrade/abort-install, the B<postrm> renames I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required.
pt: Implementação actual: o B<preinst> verifica se o conffile foi modificado. Se sim, é deixado no lugar, caso contrário é renomeado para I<old-conffile>B<.dpkg-remove>. Durante a configuração, o B<postinst> remove I<old-conffile>B<.dpkg-remove> e renomeia I<old-conffile> para I<new-conffile> se I<old-conffile> ainda estiver disponível. No abortar-actualização/abortar-instalação, o B<postrm> renomeia I<old-conffile>B<.dpkg-remove> de volta a I<old-conffile> se necessário.

note: type: =head1
en: SYMLINK AND DIRECTORY SWITCHES
pt: LINKS SIMBÓLICOS E SWITCHES DE DIRECTÓRIO

note: type: textblock
en: When upgrading a package, B<dpkg> will not automatically switch a symlink to a directory or vice-versa.  Downgrades are not supported and the path will be left as is.
pt: Ao actualiza um pacote, o B<dpkg> não irá mudar automaticamente de um link simbólico para um directório ou vice-versa. Downgrades (descidas de versão) não são suportados e o caminho irá ser deixado como está.

note: type: textblock
en: B<Note>: The symlinks and directories created during these switches need to be shipped in the new packages, or B<dpkg> will not be able to remove them on purge.
pt: B<Nota>: Os links simbólicos e directórios criados durante esses switches precisam de ser enviados nos novos pacotes, ou o B<dpkg> não será capaz de os remover durante a purga.

note: type: =head2
en: Switching a symlink to directory
pt: Alternar um link simbólico para directório

note: type: textblock
en: If a symlink is switched to a real directory, you need to make sure before unpacking that the symlink is removed.  This may seem a simple change to the B<preinst> script at first, however that will result in some problems in case of admin local customization of the symlink or when downgrading the package.
pt: Se um link simbólico for mudado para um directório real, você precisa de certificar que o link simbólico é removido antes de desempacotar. Isto pode parecer uma mudança simples para o script B<preinst> no inicio, no entanto isso irá resultar em alguns problemas no caso de personalização local administrativa do link simbólico ou quando se retrocede na versão do pacote (downgrade).

note: type: textblock
en: I<pathname> is the absolute name of the old symlink (the path will be a directory at the end of the installation) and I<old-target> is the target name of the former symlink at I<pathname>.  It can either be absolute or relative to the directory containing I<pathname>.
pt: I<pathname> é o nome absoluto do link simbólico antigo (o caminho será um directório no final da instalação) e I<old-target> é o nome do alvo do link simbólico anterior em I<pathname>. Pode ser ou absoluto ou relativo ao directório que contem I<pathname>.

note: type: textblock
en: Current implementation: the B<preinst> checks if the symlink exists and points to I<old-target>, if not then it's left in place, otherwise it's renamed to I<pathname>B<.dpkg-backup>.  On configuration, the B<postinst> removes I<pathname>B<.dpkg-backup> if I<pathname>B<.dpkg-backup> is still a symlink.  On abort-upgrade/abort-install, the B<postrm> renames I<pathname>B<.dpkg-backup> back to I<pathname> if required.
pt: Implementação actual: o B<preinst> verifica se o link simbólico existe e aponta para I<old-target>, se não então deixa-o como estiver, caso contrário é renomeado para I<pathname>B<.dpkg-backup>. Na configuração, o B<postinst> remove I<pathname>B<.dpkg-backup> se I<pathname>B<.dpkg-backup> for ainda um link simbólico. Ao aborta actualização/instalação. o B<postrm> renomeia <pathname>B<.dpkg-backup> de volta para I<pathname> se necessário.

note: type: =head2
en: Switching a directory to symlink
pt: Alternar um directório para link simbólico

note: type: textblock
en: If a real directory is switched to a symlink, you need to make sure before unpacking that the directory is removed.  This may seem a simple change to the B<preinst> script at first, however that will result in some problems in case the directory contains conffiles, pathnames owned by other packages, locally created pathnames, or when downgrading the package.
pt: Se um directório é comutado para um link simbólico, você precisa de certificar-se antes de desempacotar que o directório foi removido. Isto pode parecer no início uma alteração simples ao script B<preinst>, no entanto isso vai resultar em alguns problemas se o directório conter conffiles, nomes de caminhos possuídos por outros pacotes, nomes de caminhos criados localmente, ou quando instala uma versão anterior do pacote (downgrade).

note: type: textblock
en: Graceful switching can be implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
pt: Mudança elegante pode ser implementada ao colocar o seguinte fragmento de shell nos scripts B<preinst>, B<postinst> e B<postrm> do maintainer:

note: type: textblock
en: I<pathname> is the absolute name of the old directory (the path will be a symlink at the end of the installation) and I<new-target> is the target of the new symlink at I<pathname>.  It can either be absolute or relative to the directory containing I<pathname>.
pt: I<pathname> é o nome absoluto do directório antigo (o caminho será um link simbólico no final da instalação) e I<new-target> é o alvo do novo link simbólico em I<pathname>. Pode ser ou absoluto ou relativo ao directório que contem I<pathname>.

note: type: textblock
en: Current implementation: the B<preinst> checks if the directory exists, does not contain conffiles, pathnames owned by other packages, or locally created pathnames, if not then it's left in place, otherwise it's renamed to I<pathname>B<.dpkg-backup>, and an empty staging directory named I<pathname> is created, marked with a file so that dpkg can track it.  On configuration, the B<postinst> finishes the switch if I<pathname>B<.dpkg-backup> is still a directory and I<pathname> is the staging directory; it removes the staging directory mark file, moves the newly created files inside the staging directory to the symlink target I<new-target>/, replaces the now empty staging directory I<pathname> with a symlink to I<new-target>, and removes I<pathname>B<.dpkg-backup>.  On abort-upgrade/abort-install, the B<postrm> renames I<pathname>B<.dpkg-backup> back to I<pathname> if required.
pt: Implementação actual: o B<preinst> verifica se o directório existe, não contém conffiles, nomes de caminhos possuídos por outros pacotes, ou nomes de caminhos criados localmente, se não então é deixa-do como está, caso contrário é renomeado para I<pathname>B<.dpkg-backup>, e é criado um directório vazio estagiário chamado I<pathname>, marcado com um ficheiro para que o dpkg o possa acompanhar. Na configuração, o B<postinst> termina a comutação se I<pathname>B<.dpkg-backup> for ainda um directório e se I<pathname> é o directório de estagiário; remove o ficheiro marcador do directório estagiário, move os ficheiros acabados de criar dentro do directório estagiário para o link simbólico alvo I<new-target>/, substitui o agora vazio directório estagiário I<pathname> com um link simbólico para I<new-target>, e remove I<pathname>B<.dpkg-backup>. Ao abortar actualização/instalação, o B<postrm> renomeia I<pathname>B<.dpkg-backup> de volta para I<pathname> se necessário.

note: type: =head1
en: INTEGRATION IN PACKAGES
pt: INTEGRAÇÃO EM PACOTES

note: type: textblock
en: When using a packaging helper, please check if it has native B<dpkg-maintscript-helper> integration, which might make your life easier.  See for example L<dh_installdeb(1)>.
pt: Quando usar um ajudante de empacotamento, por favor verifique se ele tem integração com B<dpkg-maintscript-helper> nativa, o que pode tornar a sua vida mais fácil. Veja por exemplo L<dh_installdeb(1)>.

note: type: textblock
en: Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it unconditionally requires a pre-dependency to ensure that the required version of B<dpkg> has been unpacked before.  The required version depends on the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2, for B<symlink_to_dir> and B<dir_to_symlink> it is 1.17.14:
pt: Dado que B<dpkg-maintscript-helper> é usado no B<preinst>, usa-lo incondicionalmente requer uma pré-dependência para assegurar que a versão requerida do B<dpkg> já foi desempacotada antes. A versão requerida depende do comando usado, para B<rm_conffile> e B<mv_conffile> é 1.15.7.2, para B<symlink_to_dir> e B<dir_to_symlink> é 1.17.14:

note: type: textblock
en: But in many cases the operation done by the program is not critical for the package, and instead of using a pre-dependency we can call the program only if we know that the required command is supported by the currently installed B<dpkg>:
pt: Mas em muitos casos a operação feita pelo programa não é crítica para o pacote, e em vez de usar uma pré-dependência nós podemos chamar o programa apenas quando sabemos que o comando requerido é suportado pelo B<dpkg> presentemente instalado:

note: type: textblock
en: The command B<supports> will return 0 on success, 1 otherwise.  The B<supports> command will check if the environment variables as set by dpkg and required by the script are present, and will consider it a failure in case the environment is not sufficient.
pt: O comando B<supports> irá retornar 0 em sucesso, 1 caso contrário. O comando B<supports> irá verificar se as variáveis de ambiente estão presentes como definidas pelo dpkg e requeridas pelo script, e irá considerar um fracasso no caso do ambiente não ser suficiente.

note: type: textblock
en: If set, it will be used as the filesystem root directory.
pt: Se definido, será usado como o directório raiz do sistema de ficheiros.

note: type: textblock
en: If set, it will be used as the B<dpkg> data directory.
pt: Se definido, será usado como o directório de dados do B<dpkg>.

note: type: textblock
en: Sets the color mode (since dpkg 1.19.1).  The currently accepted values are: B<auto> (default), B<always> and B<never>.
pt: Define o modo de cor (desde dpkg 1.19.1). Os valores presentemente aceites são: B<auto> (predefinição), B<always> e B<never>.

note: type: textblock
en: dpkg-mergechangelogs - 3-way merge of debian/changelog files
pt: dpkg-mergechangelogs - fusão de 3 vias de ficheiros debian/changelog

note: type: textblock
en: This program will use the 3 provided versions of the Debian changelog to generate a merged changelog file.  The resulting changelog is stored in the file I<out> or output to the standard output if that parameter is not given.
pt: Este programa irá usar as 3 versões fornecidas do changelog Debian para gerar um ficheiro changelog resultante de fusão. O changelog resultante é guardado no ficheiro I<out> ou enviado para a saída standard se esse parâmetro não for fornecido.

note: type: textblock
en: Each entry is identified by its version number and they are assumed to be not conflicting, they are simply merged in the right order (by decreasing version number).  When B<--merge-prereleases> is used, the part of the version number after the last tilde is dropped so that 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same entry.  When the same version is available in both I<new-a> and I<new-b>, a standard line-based 3-way merge is attempted (provided that the module Algorithm::Merge is available — it's part of the package libalgorithm-merge-perl — otherwise you get a global conflict on the content of the entry).
pt: Cada entrada é identificada pelo seu número de versão e são assumidas como não em conflito, elas são simplesmente fundidas na ordem correcta (ao diminuir o número de versão). Quando B<--merge-prereleases> é usado, a parte do número de versão após o último til é largada de modo que 1.0-1~exp1 e 1.0-1~exp5 são consideradas a mesma entrada. Quando a mesma versão está disponível em ambas I<new-a> e I<new-b>, é tentada uma fusão standard de 3- vias baseada em linhas (desde que o módulo Algorithm::Merge esteja disponível — faz parte do pacote libalgorithm-merge-perl — caso contrário você vai obter um conflito global no conteúdo da entrada.).

note: type: textblock
en: Ignore the version number when the entries are marked as B<UNRELEASED> (since dpkg 1.21.0).
pt: Ignora o número de versão quando as entradas são marcadas como B<UNRELEASED> (desde dpkg 1.21.0).

note: type: textblock
en: This is useful when you have diverging development for versions that have not yet been released.  For instance 2.1-1 is released, then development happens for the new 2.2-1 and then for 2.3-1, where it makes sense to just end with a coalesced entry for 2.3-1 including all the development done in 2.2-1.
pt: Isto é útil quando você tem desenvolvimento divergente para versões que ainda não foram lançadas. Por exemplo, a 2.1-1 é lançada, depois acontece o desenvolvimento da nova 2.2-1 e depois para 2.3-1, onde faz sentido apenas ficar com uma entrada coalescida para 2.3-1 incluindo todo o desenvolvimento feito na 2.2-1.

note: type: textblock
en: Drop the part after the last tilde in the version number when doing version comparison to identify if two entries are supposed to be the same or not.
pt: Larga a parte após o último til no número de versão quando faz comparação de versões para identificar se duas entradas são supostamente a mesma ou não.

note: type: textblock
en: This is useful when you keep using the same changelog entry but you increase its version number regularly.  For instance, you might have 2.3-1~exp1, 2.3-1~exp2, ... until the official release 2.3-1 and they are all the same changelog entry that has evolved over time.
pt: Isto é útil quando você continua a usar a mesma entrada de changelog mas vai incrementado regularmente o seu número de versão. Por exemplo, você pode ter 2.3-1~exp1, 2.3-1~exp2, ... até ao lançamento oficial 2.3-1 e elas são todas a mesma entrada de changelog que foi evoluindo com o tempo.

note: type: =head1
en: LIMITATIONS
pt: LIMITAÇÕES

note: type: textblock
en: Anything that is not parsed by L<Dpkg::Changelog> is lost during the merge.  This might include stuff like comments which were not supposed to be there, etc.
pt: Tudo o que não seja analisado por L<Dpkg::Changelog> é perdido durante a fusão. Isto pode incluir coisas como comentários que não eram suposto estar lá, etc.

note: type: =head1
en: INTEGRATION WITH GIT
pt: INTEGRAÇÃO COM GIT

note: type: textblock
en: If you want to use this program to merge Debian changelog files in a git repository, you have first to register a new merge driver in B<.git/config> or B<~/.gitconfig>:
pt: Se você deseja usar este programa para fundir ficheiros changelog Debian num repositório git, você tem primeiro de registar uma nova driver de fusão em B<.git/config> ou B<~/.gitconfig>:

note: type: textblock
en: Then you have to setup the merge attribute for the debian/changelog file either in B<.gitattributes> in the repository itself, or in B<.git/info/attributes>:
pt: Depois você tem de configurar o atributo de fusão para o ficheiro debian/changelog seja em B<.gitattributes> no próprio repositório, ou em B<.git/info/attributes>:

note: type: textblock
en: dpkg-name - rename Debian packages to full package names
pt: dpkg-name - renomeia pacotes Debian para o nome de pacote completo

note: type: textblock
en: 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 fallbacks to B<deb>.
pt: Este manual documenta o programa B<dpkg-name> o qual fornece uma maneira fácil de renomear pacotes B<Debian> nos seus nomes de pacote completos. Todos os nomes de pacote completos consistem de I<pacote>B<_>I<versão>B<_>I<arquitectura>B<.>I<tipo-de-pacote> como especificado no ficheiro de controle do pacote. A parte I<versão> do nome do ficheiro consiste da informação de versão do autor seguida opcionalmente por um hífen e a informação de revisão. A parte I<tipo-de-pacote> vem desse campo se presente ou regressa a B<deb>.

note: type: textblock
en: The destination filename will not have the architecture information.
pt: O nome de ficheiro de destino não terá a informação de arquitectura.

note: type: textblock
en: Create a symlink, instead of moving.
pt: Cria um link simbólico, em vez de mover.

note: type: textblock
en: Existing files will be overwritten if they have the same name as the destination filename.
pt: Os ficheiros existentes serão sobrescritos se tiverem o mesmo nome que o nome de ficheiro de destino.

note: type: textblock
en: Files will be moved into a subdirectory.  If the directory given as argument exists the files will be moved into that directory otherwise the name of the target directory is extracted from the section field in the control part of the package.  The target directory will be «unstable/binary-I<architecture>/I<section>».  If the section is not found in the control, then B<no-section> is assumed, and in this case, as well as for sections B<non-free> and B<contrib> the target directory is «I<section>/binary-I<architecture>».  The section field is not required so a lot of packages will find their way to the B<no-section> area.
pt: 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>.

note: type: textblock
en: B<Warning>: Use this option with care, it is messy.
pt: B<Aviso>: Use esta opção com cuidado, ela faz porcaria.

note: type: textblock
en: This option can used together with the B<-s> option.  If a target directory isn't found it will be created automatically.
pt: 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.

note: type: textblock
en: B<Warning>: Use this option with care.
pt: B<Aviso>: Use esta opção com cuidado.

note: type: textblock
en: Some packages don't follow the name structure I<package>B<_>I<version>B<_>I<architecture>B<.deb>.  Packages renamed by B<dpkg-name> will follow this structure.  Generally this will have no impact on how packages are installed by L<dselect(1)>/L<dpkg(1)>, but other installation tools might depend on this naming structure.
pt: 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.

note: type: textblock
en: The file B<bar-foo.deb> will be renamed to bar-foo_1.0-2_i386.deb or something similar (depending on whatever information is in the control part of B<bar-foo.deb>).
pt: 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>).

note: type: textblock
en: All files with the extension B<deb> in the directory /root/debian and its subdirectory's will be renamed by B<dpkg-name> if required into names with no architecture information.
pt: 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.

note: type: textblock
en: B<Don't do this.> Your archive will be messed up completely because a lot of packages don't come with section information.  B<Don't do this.>
pt: 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.>

note: type: textblock
en: This can be used when building new packages.
pt: Isto pode ser usado quando se compila novos pacotes.

note: type: textblock
en: dpkg-parsechangelog - parse Debian changelog files
pt: dpkg-parsechangelog - analisa ficheiros de registos de alterações Debian

note: type: textblock
en: B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian source tree and outputs the information in it to standard output in a machine-readable form.
pt: B<dpkg-parsechangelog> lê e analisa o changelog de uma árvore fonte Debian desempacotada e envia a informação para a saída standard num formato de linguagem-máquina.

note: type: textblock
en: Specifies the changelog file to read information from.  A ‘-’ can be used to specify reading from standard input.  The default is B<debian/changelog>.
pt: Especifica o ficheiro de registo de alterações de onde ler informação. Pode ser usado um ‘-’ para especificar leitura a partir da entrada standard. A predefinição é B<debian/changelog>.

note: type: textblock
en: Specifies the format of the changelog.  By default the format is read from a special line near the bottom of the changelog or failing that defaults to the B<debian> standard format.  See also L</CHANGELOG FORMATS>.
pt: Especifica o formato do changelog. Por predefinição o formato é lido a partir de uma linha especial perto do fundo do changelog ou falhando isto cai para o formato standard B<debian>. Veja também L</FORMATOS DE CHANGELOG>.

note: type: textblock
en: Obsolete option without effect (since dpkg 1.18.8).  Setting the perl environment variables B<PERL5LIB> or B<PERLLIB> has a similar effect when looking for the parser perl modules.
pt: Opção obsoleta sem qualquer efeito (desde dpkg 1.18.8). Definir as variáveis de ambiente perl B<PERL5LIB> ou B<PERLLIB> tem um efeito semelhante quando se procura pelos módulos perl de analisador.

note: type: textblock
en: Specifies the name of the field to show (since dpkg 1.17.0).  The field name is not printed, only its value.
pt: Especifica o nome do campo a mostrar (desde dpkg 1.17.0). O nome do campo não é mostrado, apenas o seu valor.

note: type: =head2
en: Parser Options
pt: Opções de Analisador

note: type: textblock
en: The following options can be used to influence the output of the changelog parser, for example the range of entries or the format of the output.
pt: As seguintes opções podem ser usadas para influenciar o resultado do analisador de changelog, por exemplo o alcance das entradas ou o formato dos resultados.

note: type: textblock
en: Set the output format.  Currently supported values are B<dpkg> and B<rfc822>.  B<dpkg> is the classic output format (from before this option existed) and the default.  It consists of one stanza in Debian control format (see L<deb-control(5)>).  If more than one entry is requested, then most fields are taken from the first entry (usually the most recent entry), except otherwise stated:
pt: Define o formato de resultado. Actualmente os valores suportados são B<dpkg> e B<rfc822>. B<dpkg> é o formato de saída clássico (já vem de antes esta opção existir) e o predefinido. Consistem em uma estrofe em formato de controlo Debian  (veja L<deb-control(5)>). Se for requerida mais do que uma entrada, então a maioria dos campos são obtidos a partir da primeira entrada (geralmente a entrada mais recente), excepto caso contrário declarado:

note: type: textblock
en: The source version number.  B<Note>: For binary-only releases there might be no corresponding source release.
pt: O número de versão de fonte. B<Nota>: Para lançamentos apenas-binário pode não existir nenhum lançamento fonte correspondente.

note: type: textblock
en: A space-separated list of one or more distribution names where this version should be installed when it is uploaded.
pt: Uma lista separada por espaços de uma ou mais nomes de distribuições onde esta versão deve ser instalada quando é feito o envio dela.

note: type: textblock
en: The highest urgency of all included entries is used, followed by the concatenated (space-separated) comments from all the versions requested.
pt: De todas as entradas incluídas é usada a que tem a urgência mais alta, seguida pelos comentários (separados por espaços) concatenados de todas as versões requisitadas.

note: type: textblock
en: The name and email address of the person who prepared these changes, they are B<not> necessarily those of the uploader or the usual package maintainer.
pt: O nome e endereço de email da pessoa que preparou estas alterações, B<não> são necessariamente aquele de quem faz o envio nem do maintainer habitual do pacote.

note: type: textblock
en: The date of the entry as a string, as it appears in the changelog.  With a L<strptime(3)> format "B<%a, %d %b %Y %T %z>", but where the day of the week might not actually correspond to the real day obtained from the rest of the date string.  If you need a more accurate representation of the date, use the B<Timestamp> field, but take into account it might not be possible to map it back to the exact value in this field.
pt: A data da entrada como uma string, como aparece no changelog. Com um formato L<strptime(3)> "B<%a, %d %b %Y %T %z>", mas onde o dia da semana pode não corresponder realmente ao dia real obtido a partir do resto da string da data. Se você precisar duma representação mais exacta da data, use o campo B<Timestamp>, mas tenha em conta que pode não ser possível mapear-lo de volta ao valor exacto neste campo.

note: type: textblock
en: The date of the entry as a timestamp in seconds since the epoch (since dpkg 1.18.8).
pt: A data da entrada como uma marca temporal em segundos  desde a época (desde dpkg 1.18.8).

note: type: textblock
en: The Closes fields of all included entries are merged.
pt: Os campos Closes de todas as entradas incluídas são fundidos.

note: type: textblock
en: The text of all changelog entries is concatenated.  To make this field a valid Debian control format multiline field empty lines are replaced with a single full stop and all lines is intended by one space character.  The exact content depends on the changelog format.
pt: O texto de todas as entradas changelog é concatenado. Para tornar este campo um campo multi-linha de formato de controlo Debian válido, as linhas vazias são substituídas por um único ponto final e todas são destinadas por caractere de espaço. O conteúdo exacto depende do formato do changelog.

note: type: textblock
en: The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> fields are mandatory.
pt: Os campos B<Version>, B<Distribution>, B<Urgency>, B<Maintainer>e B<Changes> são obrigatórios.

note: type: textblock
en: There might be additional user-defined fields present.
pt: Podem estar presentes campos adicionais definidos pelo utilizador.

note: type: textblock
en: The B<rfc822> format uses the same fields but outputs a separate stanza for each changelog entry so that all metadata for each entry is preserved.
pt: O formato B<rfc822> usa os mesmos campos mas escreve uma estrofe separada para cada entrada no changelog para que todos os meta-dados de cada entrada sejam preservados.

note: type: textblock
en: Include all changes in reverse order (since dpkg 1.19.1).
pt: Inclui todas as alterações  em ordem reversa (desde dpkg 1.19.1).

note: type: textblock
en: B<Note>: For the B<dpkg> format the first entry will be the most ancient entry.
pt: B<Nota>: Para o formato do B<dpkg> a primeira entrada será a entrada mais antiga.

note: type: textblock
en: Include all changes.  B<Note>: Other options have no effect when this is in use.
pt: Inclui todas as alterações. B<Nota>: Outras opções não têm efeito quando isto é usado.

note: type: textblock
en: Include all changes later than I<version>.
pt: Inclui todas as alterações posteriores a I<versão>.

note: type: textblock
en: Include all changes earlier than I<version>.
pt: Inclui todas as alterações anteriores a I<versão>.

note: type: textblock
en: Include all changes equal or later than I<version>.
pt: Inclui todas as alterações iguais ou posteriores a I<versão>.

note: type: textblock
en: Include all changes up to or equal than I<version>.
pt: Inclui todas as alterações até ou igual a I<versão>.

note: type: textblock
en: Include I<number> entries from the top (or the tail if I<number> is lower than 0).
pt: Inclui I<número> de entradas a partir do topo (ou do fundo se I<número> for menor que 0).

note: type: textblock
en: Change the starting point for B<--count>, counted from the top (or the tail if I<number> is lower than 0).
pt: Altera o ponto de inicio para B<--count>, contado a partir do topo (ou do fundo se I<número> for menor que 0).

note: type: =head1
en: CHANGELOG FORMATS
pt: FORMATOS DE CHANGELOG

note: type: textblock
en: It is possible to use a different format to the standard one, by providing a parser for that alternative format.
pt: É possível usar um formato diferente para o standard, ao disponibilizar um analisador para esse formato alternativo.

note: type: textblock
en: In order to have B<dpkg-parsechangelog> run the new parser, a line must be included within the last 40 lines of the changelog file, matching the Perl regular expression: “B<\schangelog-format:\s+([0-9a-z]+)\W>”.  The part in parentheses should be the name of the format.  For example:
pt: De modo a ter o B<dpkg-parsechangelog> a correr o novo analisador, tem de ser incluída uma linha dentro das últimas 40 linhas do ficheiro changelog, correspondendo à expressão regular Perl “B<\schangelog-format:\s+([0-9a-z]+)\W>”. A parte em parêntesis deve ser o nome do formato. Por exemplo:

note: type: textblock
en: Changelog format names are non-empty strings of lowercase alphanumerics (“a-z0-9”).
pt: Os nomes de formatos do registo de alterações são strings não vazias de alfanuméricos em letra minúscula (“a-z0-9”).

note: type: textblock
en: If such a line exists then B<dpkg-parsechangelog> will look for the parser as a B<Dpkg::Changelog::>I<Otherformat> perl module; it is an error for it not being present.  The parser name in the perl module will be automatically capitalized.  The default changelog format is B<debian>, and a parser for it is provided by default.
pt: Se tal linha existir então B<dpkg-parsechangelog> irá procurar por um analisador como um B<Dpkg::Changelog::>I<Otherformat> módulo perl; é um erro para ele não estar presente. O nome do analisador no módulo perl irá ser automaticamente capitalizado. O formato de changelog predefinido é B<debian>, e um analisador para ele é fornecido por predefinição.

note: type: textblock
en: The parser should be derived from the L<Dpkg::Changelog> class and implement the required documented interface.
pt: O analisador deve ser derivado a partir da classe L<Dpkg::Changelog>e implementar a necessária interface documentada.

note: type: textblock
en: If the changelog format which is being parsed always or almost always leaves a blank line between individual change notes, these blank lines should be stripped out, so as to make the resulting output compact.
pt: No formato de changelog que está a ser analisado, sempre ou quase sempre deixa uma linha vazia entre notas de alteração individuais, estas linhas vazias devem ser retiradas, para se criar a saída compacta resultante.

note: type: textblock
en: If the changelog format does not contain date or package name information this information should be omitted from the output.  The parser should not attempt to synthesize it or find it from other sources.
pt: Se o formato de changelog não conter informação da data ou do nome do pacote, esta informação deve ser omitida do resultado. O analisador não deve tentar sintetiza-la ou encontra-la a partir de outros serviços.

note: type: textblock
en: If the changelog does not have the expected format the parser should error out, rather than trying to muddle through and possibly generating incorrect output.
pt: Se o changelog não tiver o formato esperado, o analisador deve sair em erro, em vez de tentar inventar e possivelmente gerar resultados incorrectos.

note: type: textblock
en: A changelog parser may not interact with the user at all.
pt: Um analisador do registo de alterações pode não interagir de todo com o utilizador.

note: type: textblock
en: All B<Parser Options> except for B<-v> are only supported since dpkg 1.14.16.
pt: Todas as B<Parser Options> excepto para B<-v> só são suportadas desde dpkg 1.14.16.

note: type: textblock
en: Short option parsing with non-bundled values available only since dpkg 1.18.0.
pt: A análise de opções curtas com valores não-embolados está disponível apenas desde dpkg 1.18.0.

note: type: textblock
en: The changelog file, used to obtain version-dependent information about the source package, such as the urgency and distribution of an upload, the changes made since a particular release, and the source version number itself.
pt: O ficheiro changelog, usado ara obter informação dependente da versão acerca do pacote fonte, tal como a urgência e distribuição de um envio, as alterações feitas desde um lançamento particular, e o número de versão da própria fonte.

note: type: textblock
en: The B<Maintainer> field has a confusing name matching the field in the F<debian/control> file but not its exact semantics, where its meaning would be better represented by the B<Changed-By> field name used in the F<.changes> file.
pt: O campo B<Maintainer> tem uma confusão com o nome que corresponde ao campo no ficheiro F<debian/control> mas não é exactamente a mesma semântica, onde o seu significado seria melhor representado pelo nome de campo B<Changed-By> usado no ficheiro F<.changes>.

note: type: textblock
en: dpkg-query - a tool to query the dpkg database
pt: dpkg-query - uma ferramenta para questionar a base de dados do dpkg

note: type: textblock
en: B<dpkg-query> is a tool to show information about packages listed in the B<dpkg> database.
pt: B<dpkg-query> é uma ferramenta para mostrar informação acerca de pacotes listados no base de dados do B<dpkg>.

note: type: textblock
en: List all known packages matching one or more patterns, regardless of their status, which includes any real or virtual package referenced in any dependency relationship field (such as B<Breaks>, B<Enhances>, etc.).  If no I<package-name-pattern> is given, list all packages in I<%ADMINDIR%/status>, excluding the ones marked as not-installed (i.e.  those which have been previously purged).  Normal shell wildcard characters are allowed in I<package-name-pattern>.  Please note you will probably have to quote I<package-name-pattern> to prevent the shell from performing filename expansion.  For example this will list all package names starting with “libc6”:
pt: Lista todos os pacotes conhecidos que correspondem a um ou mais padrões, independentemente do seu estado, o que inclui quaisquer referências a pacotes reais ou virtuais em qualquer campo de relacionamento de dependência (tal como B<Breaks>, B<Enhances>, etc.). Se nenhum I<package-name-pattern> for fornecido, lista todos os pacotes em I<%ADMINDIR%/status>, excluindo aqueles marcados como não-instalados (isto é, aqueles que foram previamente purgados). São permitidos caracteres wildcard de shell normal em I<package-name-pattern>. Por favor note que provavelmente terá que citar I<package-name-pattern> para impedir a shell de executar expansão do nome de ficheiro. Por exemplo isto irá listas todos os nomes de pacotes que comecem com “libc6”:

note: type: textblock
en: The first three columns of the output show the desired action, the package status, and errors, in that order.
pt: As primeiras três colunas do resultado mostram a acção desejada, e estado do pacote, e erros, por essa ordem.

note: type: textblock
en: Desired action:
pt: Acção desejada:

note: type: textblock
en: Package status:
pt: Estado de pacote:

note: type: textblock
en: Error flags:
pt: Flags de erro:

note: type: textblock
en: An uppercase status or error letter indicates the package is likely to cause severe problems.  Please refer to L<dpkg(1)> for information about the above states and flags.
pt: Um estado em letra maiúscula ou letra de erro indica que o pacote é provável de causar severos problemas. Por favor consulte L<dpkg(1)> para informação sobre os estados e bandeiras em cima.

note: type: textblock
en: The output format of this option is not configurable, but varies automatically to fit the terminal width.  It is intended for human readers, and is not easily machine-readable.  See B<-W> (B<--show>)  and B<--showformat> for a way to configure the output format.
pt: O formato de saída desta opção não é configurável, mas varia automaticamente para caber na largura do terminal. Destina-se a ser lido por humanos e não é facilmente lido por máquinas. Veja B<-W> (B<--show>)  e B<--showformat> para um modo de configurar o formato do resultado.

note: type: textblock
en: Just like the B<--list> option this will list all packages matching the given patterns.  However the output can be customized using the B<--showformat> option.
pt: Tal como a opção B<--list> isto irá listar todos os pacotes que correspondem aos padrões dados. No entanto o resultado pode ser personalizado usando a opção B<--showformat>.

note: type: textblock
en: The default output format gives one line per matching package, each line consisting of the package name and its installed version, separated by a tab.  The package name will be architecture qualified for packages with a B<Multi-Arch> field with the value B<same> or with a foreign architecture, which is an architecture that is neither the native one nor B<all>.
pt: O formato de resultados predefinido dá uma linha por pacote correspondente, cada linha consistindo do nome do pacote e a sua versão instalada, separados por um tab. O nome de pacote será qualificado de arquitectura para pacotes com um campo B<Multi-Arch> com o valor B<same> ou com uma arquitectura alienígena, a qual é uma arquitectura que não é a nativa nem B<all>.

note: type: textblock
en: Report status of specified packages.  This just displays the entry in the installed package status database.  If no I<package-name> is specified it will display all package entries in the status database (since dpkg 1.19.1).  When multiple I<package-name> entries are listed, the requested status entries are separated by an empty line, with the same order as specified on the argument list.
pt: Reporta estado de pacotes específicos. Isto apenas mostra a entrada na base de dados de estados de pacotes instalados. Se não especificado nenhum I<package-name> irá mostrar todas as entradas de pacotes na base de dados de estados (desde dpkg 1.19.1). Quando são listadas várias entradas de I<package-name>, as entradas de estado requisitadas são separadas por uma linha vazia, com a mesma ordem que foi especificada na lista de argumentos.

note: type: textblock
en: List files installed to your system from I<package-name>.  When multiple I<package-name>s are listed, the requested lists of files are separated by an empty line, with the same order as specified on the argument list.
pt: Lista os ficheiros instalados no seu sistema a partir de I<package-name>. Quando são listados vários I<package-name>s, as listas de ficheiros pedidas são separadas por uma linha vazia, na mesma ordem como especificada na lista de argumentos.

note: type: textblock
en: Each file diversion is printed on its own line after its diverted file, prefixed with one of the following localized strings:
pt: Cada diversão de ficheiro é escrita na sua própria linha após o seu ficheiro divergido, prefixado com uma das seguintes strings localizadas:

note: type: textblock
en: B<Hint>: When machine parsing the output, it is customary to set the locale to B<C.UTF-8> to get reproducible results.  On some systems this might also require adapting the B<LANGUAGE> environment variable appropriately if it is already set (see L<locale(7)>).
pt: B<Dica>: Quando se faz análise máquina a uma saída, é costume definir o locale para B<C.UTF-8> para obter resultados reproduzíveis. Em alguns sistemas isto pode também requerer adaptar a variável de ambiente B<LANGUAGE> apropriadamente se já estiver definida (veja L<locale(7)>).

note: type: textblock
en: This command will not list extra files created by maintainer scripts, nor will it list alternatives.
pt: Este comando não irá listar ficheiros extra criados pelos scripts do maintainer, nem irá listar alternativas.

note: type: =item
en: B<--control-list> I<package-name>
pt: <--control-list> I<package-name>

note: type: textblock
en: List control files installed to your system from I<package-name> (since dpkg 1.16.5).  These can be used as input arguments to B<--control-show>.
pt: Lista ficheiros de controle instalados no seu sistema a partir de I<nome-pacote> (desde dpkg 1.16.5). Estes podem ser usados como argumentos de entrada para B<--control-show>.

note: type: textblock
en: Print the I<control-file> installed to your system from I<package-name> to the standard output (since dpkg 1.16.5).
pt: Escreve o I<ficheiro-controle> instalado no seu sistema a partir de I<nome-pacote> na saída standard (desde dpkg 1.16.5).

note: type: textblock
en: List paths for control files installed to your system from I<package-name> (since dpkg 1.15.4).  If I<control-file> is specified then only list the path for that control file if it is present.
pt: Lista caminhos para ficheiros de controle instalados no seu sistema a partir de I<package-name> (desde dpkg 1.15.4).  Se for especificado I<control-file> então apenas lista o caminho para esse ficheiro de controle se estiver presente.

note: type: textblock
en: B<Warning>: this command is deprecated as it gives direct access to the internal dpkg database, please switch to use B<--control-list> and B<--control-show> instead for all cases where those commands might give the same end result.  Although, as long as there is still at least one case where this command is needed (i.e. when having to remove a damaging postrm maintainer script), and while there is no good solution for that, this command will not get removed.
pt: B<Aviso>: este comando está descontinuado pois da acesso direto à base de dados interna do  dpkg, por favor use B<--control-list> e B<--control-show> em vez deste para todos os casos onde esses comandos possam dar os mesmos resultados finais. esult. Apesar disto, enquanto ainda existir pelo menos um caso onde este comando é necessário (isto é, quando é preciso de remover um script de maintainer postrm prejudicial), e enquanto não existir boa solução para isso, este comando não será removido.

note: type: textblock
en: Search for packages that own files corresponding to the given patterns.  Standard shell wildcard characters can be used in the pattern, where asterisk (B<*>) and question mark (B<?>) will match a slash, and backslash (B<\>) will be used as an escape character.
pt: Procura por pacotes que possuem ficheiros que correspondem aos padrões dados. Podem ser usados caracteres wildcard de shell standard no padrão, onde o asterisco (B<*>) e ponto interrogação (B<?>) irão corresponder a uma barra, e a barra invertida (B<\>) será usada como um caractere de escape.

note: type: textblock
en: If the first character in the I<filename-search-pattern> is none of ‘B<*[?/>’ then it will be considered a substring match and will be implicitly surrounded by ‘B<*>’ (as in B<*>I<filename-search-pattern>B<*>).  If the subsequent string contains any of ‘B<*[?\>’, then it will handled like a glob pattern, otherwise any trailing ‘B</>’ or ‘B</.>’ will be removed and a literal path lookup will be performed.
pt: Se o primeiro caractere em I<filename-search-pattern> não for nenhum de ‘B<*[?/>’ então será considerado uma correspondência de sub-string e será implicitamente cercada por ‘B<*>’ (como em B<*>I<filename-search-pattern>B<*>).  Se a string subsequente conter qualquer de ‘B<*[?\>’, então será lidada como um padrão glob, caso contrário qualquer ‘B</>’ ou ‘B</.>’ no final será removido e será executada uma busca de caminho literal.

note: type: textblock
en: The output format consists of one line per matching pattern, with a list of packages owning the pathname separated by a comma (U+002C ‘B<,>’) and a space (U+0020 ‘B< >’), followed by a colon (U+003A ‘B<:>’) and a space, followed by the pathname.  As in:
pt: O formato de saída consiste numa linha por padrão de correspondência, com uma lista pacotes a ter o nome de caminho separado por uma vírgula (U+002C ‘B<,>’) e um espaço (U+0020 ‘B< >’), seguido por dois pontos (U+003A ‘B<:>’) e um espaço seguido pelo nome de caminho. Como em:

note: type: textblock
en: File diversions are printed with the following localized strings:
pt: Diversões de ficheiro são escritas com as seguintes strings localizadas:

note: type: textblock
en: or for local diversions:
pt: ou para diversões locais:

note: type: textblock
en: B<Hint>: When machine parsing the output, it is customary to set the locale to B<C.UTF-8> to get reproducible results.
pt: B<Dica>: Quando se faz análise máquina a uma saída,é costume definir o locale para B<C.UTF-8> para obter resultados reproduzíveis.

note: type: textblock
en: Display details about packages, as found in I<%ADMINDIR%/available>.  If no I<package-name> is specified, it will display all package entries in the I<available> database (since dpkg 1.19.1).  When multiple I<package-name> are listed, the requested I<available> entries are separated by an empty line, with the same order as specified on the argument list.
pt: Mostra detalhes sobre pacotes, como encontrado em I<%ADMINDIR%/available>. Se nenhum I<package-name> for especificado, irá mostrar todas as entradas de pacotes na base de dados I<disponível> (desde dpkg 1.19.1). Quando vários I<package-name> são listados, as entradas I<disponíveis> requeridas são separadas por uma linha vazia, com a mesma ordem que foi especificada na lista de argumentos.

note: type: textblock
en: Users of APT-based frontends should use B<apt show> I<package-name> instead as the I<available> file is only kept up-to-date when using B<dselect>.
pt: Utilizadores de frontends baseados no APT devem usar B<apt show> I<package-name> em vez disto, pois o ficheiro I<disponível> só é mantido actualizado quando se usa o B<dselect>.

note: type: textblock
en: Change the location of the B<dpkg> database.  The default location is I<%ADMINDIR%>.
pt: Altera a localização da base de dados do B<dpkg>. A localização predefinida é I<%ADMINDIR%>.

note: type: textblock
en: Set the root directory to I<directory>, which sets the administrative directory to «I<directory>%ADMINDIR%» (since dpkg 1.21.0).
pt: Define o directório raiz para I<directory>, o que define o directório administrativo para «I<directory>%ADMINDIR%» (desde dpkg 1.21.0).

note: type: textblock
en: Also load the available file when using the B<--show> and B<--list> commands, which now default to only querying the status file (since dpkg 1.16.2).
pt: Também carrega o ficheiro disponível quando se usa os comandos B<--show> e B<--list>, que agora por predefinição apenas consultam o ficheiro de status (desde dpkg 1.16.2).

note: type: textblock
en: Disables the use of any pager when showing information (since dpkg 1.19.2).
pt: Desactiva o uso de qualquer paginador quando mostra informação (desde dpkg 1.19.2).

note: type: textblock
en: This option is used to specify the format of the output B<--show> will produce (short option since dpkg 1.13.1).  The format is a string that will be output for each package listed.
pt: Esta opção é usada para especificar o formato dos resultados que B<--show> irá produzir (opção curta desde dpkg 1.13.1). O formato é uma string que irá ser escrita para cada pacote listado.

note: type: textblock
en: In the format string, “B<\>” introduces escapes:
pt: Na string de formato, “B<\>” introduz escapes:

note: type: =item
en: B<\n> newline
pt: B<\n> nova linha

note: type: =item
en: B<\r> carriage return
pt: B<\r> retorno do carrinho

note: type: textblock
en: “B<\>” before any other character suppresses any special meaning of the following character, which is useful for “B<\>” and “B<$>”.
pt: “B<\>” antes de qualquer outro caractere suprime qualquer significado especial do caractere seguinte, o que é útil para “B<\>” e “B<$>”.

note: type: textblock
en: Package information can be included by inserting variable references to package fields using the syntax “B<${>I<field>[B<;>I<width>]B<}>”.  Fields are printed right-aligned unless the width is negative in which case left alignment will be used.  The following I<field>s are recognized but they are not necessarily available in the status file (only internal fields or fields stored in the binary package end up in it):
pt: Informação do pacote pode ser incluída ao inserir referencias variáveis a campos de pacotes usando a sintaxe “B<${>I<field>[B<;>I<width>]B<}>”. Campos são escritos alinhados à direita a menos que a largura seja negativa que nessa caso será usado o alinhamento à esquerda. OS seguintes I<field>s são reconhecidos mas não estão necessariamente disponíveis no ficheiro de estado (apenas campos internos ou campos guardados no pacote binário ficam lá):

note: type: =item
en: B<Conffiles> (internal)
pt: B<Conffiles> (interno)

note: type: =item
en: B<Config-Version> (internal)
pt: B<Config-Version> (interno)

note: type: =item
en: B<Filename> (internal, front-end related)
pt: B<Filename> (interno, relacionado com front-end)

note: type: =item
en: B<MD5sum> (internal, front-end related)
pt: B<MD5sum> (interno, relacionado com front-end)

note: type: =item
en: B<MSDOS-Filename> (internal, front-end related)
pt: B<MSDOS-Filename> (interno, relacionado com front-end)

note: type: =item
en: B<Revision> (obsolete)
pt: B<Revision> (obsoleto)

note: type: =item
en: B<Size> (internal, front-end related)
pt: B<Size> (interno, relacionado com front-end)

note: type: =item
en: B<Status> (internal)
pt: B<Status> (interno)

note: type: =item
en: B<Tag> (usually not in .deb but in repository Packages files)
pt: B<Tag> (geralmente não em .deb mas em ficheiros Packages do repositório)

note: type: =item
en: B<Triggers-Awaited> (internal)
pt: B<Triggers-Awaited> (interno)

note: type: =item
en: B<Triggers-Pending> (internal)
pt: B<Triggers-Pending> (interno)

note: type: textblock
en: The following are virtual fields, generated by B<dpkg-query> from values from other fields (note that these do not use valid names for fields in control files):
pt: Os seguintes são campos virtuais,m gerados pelo B<dpkg-query> a partir de valores de outros campos (note que estes não usam nomes válidos para campos em ficheiros de controle):

note: type: textblock
en: It contains the binary package name with a possible architecture qualifier like “libc6:amd64” (since dpkg 1.16.2).  An architecture qualifier will be present to make the package name unambiguous, for packages with a B<Multi-Arch> field with the value B<same> or with a foreign architecture, which is an architecture that is neither the native one nor B<all>.
pt: Contém o nome do pacote binário com um possível qualificador de arquitectura como “libc6:amd64” (desde dpkg 1.16.2). Um qualificador de arquitectura irá estar presente para tornar o nome do pacote não-ambiguo, para pacotes com um campo B<Multi-Arch> com o valor de B<same> ou com uma arquitectura alienígena, a qual é uma arquitectura que não é a nativa nem B<all>.

note: type: textblock
en: It contains the package short description (since dpkg 1.19.1).
pt: Contém a descrição curta do pacote (desde dpkg 1.19.1).

note: type: textblock
en: This is an alias for B<binary:Synopsis> (since dpkg 1.16.2).
pt: Isto é um alias para B<binary:Synopsis> (desde dpkg 1.16.2).

note: type: textblock
en: It contains the abbreviated package status (as three characters), such as “ii ” or “iHR” (since dpkg 1.16.2).  See the B<--list> command description for more details.
pt: Contem o estado do pacote abreviado (em três caracteres), tais como “ii ” ou “iHR” (desde dpkg 1.16.2). Veja a descrição do comando B<--list> para mais detalhes.

note: type: textblock
en: It contains the package wanted status, part of the Status field (since dpkg 1.17.11).
pt: Contém o estado desejado do pacote, parte do campo Status (desde dpkg 1.17.11).

note: type: textblock
en: It contains the package status word, part of the Status field (since dpkg 1.17.11).
pt: Contém a palavra de estado do pacote, parte do campo Status (desde dpkg 1.17.11).

note: type: textblock
en: It contains the package status error flag, part of the Status field (since dpkg 1.17.11).
pt: Contém a flag de erro do estado do pacote, parte do campo Status (desde dpkg 1.17.11).

note: type: textblock
en: It contains the list of the package filesystem entries separated by newlines (since dpkg 1.19.3).
pt: Contém a lista de entradas se sistemas de ficheiros do pacote separadas por novas linhas (desde dpkg 1.19.3).

note: type: textblock
en: It contains the timestamp in seconds of the last time the package filesystem entries were modified (since dpkg 1.19.3).
pt: Contém a marca temporal em segundos da última vez que as entradas de sistemas de ficheiros do pacote foram modificadas (desde dpkg 1.19.3).

note: type: textblock
en: It contains the source package name for this binary package (since dpkg 1.16.2).
pt: Contém o nome do pacote fonte para este pacote binário (desde o dpkg 1.16.2).

note: type: textblock
en: It contains the source package version for this binary package (since dpkg 1.16.2)
pt: Contém a versão de pacote fonte para este pacote binário (desde o dpkg 1.16.2).

note: type: textblock
en: It contains the source package upstream version for this binary package (since dpkg 1.18.16)
pt: Contém a versão do autor do pacote fonte para este pacote binário (desde dpkg 1.18.16).

note: type: textblock
en: The default format string is “B<${binary:Package}\t${Version}\n>”.  Actually, all other fields found in the status file (i.e. user defined fields) can be requested, too.  They will be printed as-is, though, no conversion nor error checking is done on them.  To get the name of the B<dpkg> maintainer and the installed version, you could run:
pt: A string do formato predefinida é “B<${binary:Package}\t${Version}\n>”. Na realidade, todos os outros campos encontrados no ficheiro de estado (isto é, campos definidos pelo utilizador) podem ser também requisitados. Eles irão ser escritos tal como estão,  too. They will be printed as-is, não obstante, nenhuma conversão ou verificação de erros é feita neles. Para obter o nome do maintainer do B<dpkg> e da versão instalada, você pode correr:

note: type: textblock
en: The requested query was successfully performed.
pt: A pesquisa requisitada foi executada com sucesso.

note: type: textblock
en: The requested query failed either fully or partially, due to no file or package being found (except for B<--control-path>, B<--control-list> and B<--control-show> were such errors are fatal).
pt: A pesquisa requisitada falhou seja total ou parcialmente, devido a nenhum ficheiro ou pacote ter sido encontrado (excepto para B<--control-path>, B<--control-list> e B<--control-show> onde tais erros são fatais).

note: type: textblock
en: Sets the program to execute when spawning a command via a shell (since dpkg 1.19.2).
pt: Define o programa a executar quando multiplica um comando via shell (desde dpkg 1.19.2).

note: type: textblock
en: Sets the pager command to use (since dpkg 1.19.1), which will be executed with «B<$SHELL -c>».  If B<SHELL> is not set, «B<%DPKG_DEFAULT_SHELL%>» will be used instead.  The B<DPKG_PAGER> overrides the B<PAGER> environment variable (since dpkg 1.19.2).
pt: Define o comando paginador a usar (desde dpkg 1.19.1), o qual ir+a ser executado com «B<$SHELL -c>».  Se B<SHELL> não estiver definido, irá ser usado «B<%DPKG_DEFAULT_SHELL%>» em vez dele. O B<DPKG_PAGER> sobrepõe a variável de ambiente B<PAGER> (desde dpkg 1.19.2).

note: type: textblock
en: If set and the B<--root> option has not been specified, it will be used as the filesystem root directory (since dpkg 1.21.0).
pt: Se definido e a opção B<--root> não foi especificada, será usado como o directório raiz do sistema de ficheiros (desde dpkg 1.21.0).

note: type: textblock
en: If set and the B<--admindir> option has not been specified, it will be used as the B<dpkg> data directory.
pt: Se definido e a opção B<--admindir> não for especificada, será usado como o directório de dados do B<dpkg>.

note: type: textblock
en: Defined by B<dpkg-query> to “B<-FRSXMQ>”, if not already set, when spawning a pager (since dpkg 1.19.2).  To change the default behavior, this variable can be preset to some other value including an empty string, or the B<PAGER> or B<DPKG_PAGER> variables can be set to disable specific options with «B<-+>», for example B<DPKG_PAGER="less -+F">.
pt: Definido pelo B<dpkg-query> para “B<-FRSXMQ>”, se não já definido, quando gera um paginador (desde dpkg 1.19.2). Para mudar o comportamento predefinido, esta variável pode ser pré-ajustada para qualquer outro valor incluindo uma string vazia, ou as variáveis B<PAGER> ou B<DPKG_PAGER> pode ser definidas para desactivar opções específicas com «B<-+>», por exemplo B<DPKG_PAGER="less -+F">.

note: type: textblock
en: Query operations should never require root, and delegating their execution to unprivileged users via some gain-root command can have security implications (such as privilege escalation), for example when a pager is automatically invoked by the tool.
pt: Operações de consulta nunca devem requerer root, e delegar a sua execução para utilizadores sem privilégios via algum comando de ganhar-root pode ter implicações de segurança (tais como escalada de privilégios), por exemplo quando um paginador é invocado automaticamente pela ferramenta.

note: type: textblock
en: dpkg-realpath - print the resolved pathname with DPKG_ROOT support
pt: dpkg-realpath - escreve o nome de caminho resolvido com suporte de DPKG_ROOT

note: type: textblock
en: B<dpkg-realpath> is a tool (since dpkg 1.20.1) to resolve a pathname, that takes the L<dpkg(1)> root directory into account, either implicitly from the B<DPKG_ROOT> environment variable or from the command-line B<--root> or B<--instdir> options, and returns an absolute I<pathname> relative to the root directory.  The root directory must not be prefixed to the I<pathname> to be resolved.
pt: B<dpkg-realpath> é uma ferramenta (desde dpkg 1.20.1) para resolver um nome de caminho, que toma o directório raiz do L<dpkg(1)> em conta, seja implicitamente a partir da variável de ambiente B<DPKG_ROOT> ou a partir das opções B<--root> ou B<--instdir> da linha de comandos, e retorna um I<pathname> absoluto relativo ao directório raiz. O directório raiz não pode ser prefixado ao I<pathname> para ser resolvido.

note: type: textblock
en: This is intended to be used by other B<dpkg> helpers, or by maintainer scripts instead of using L<realpath(1)> or L<readlink(1)> to canonicalize pathnames, as these latter commands do not support canonicalization relative to a different root than F</>.
pt: Isto destina-se a ser usado por outros ajudantes do B<dpkg>, ou por scripts de maintainer em vez de se usar L<realpath(1)> ou L<readlink(1)> para canonizar nomes de caminhos, pois estes últimos comandos não suportam canonização relativa a uma raiz diferente de F</>.

note: type: textblock
en: This program was introduced in dpkg 1.20.1.
pt: Este programa foi introduzido no dpkg 1.20.1.

note: type: textblock
en: Use a NUL byte to end output lines instead of a new line character (since dpkg 1.20.6).
pt: Usa um byte NUL para terminar as linhas de resultados em vez do caractere de nova linha (desde dpkg 1.20.6).

note: type: textblock
en: Set the root directory to I<directory>, which is the base directory that pathnames get canonicalized against.  Defaults to «B</>» if B<DPKG_ROOT> has not been set.
pt: Define o directório raiz para I<directory>, o qual é o directório base com que os nomes de caminho são canonizados. A predefinição é «B</>» se B<DPKG_ROOT> não estiver definido.

note: type: textblock
en: If set and the B<--instdir> or B<--root> options have not been specified, it will be used as the filesystem root directory.
pt: Se definido e as opções B<--instdir> ou B<--root> não foram especificadas, será usado como o directório raiz do sistema de ficheiros.

note: type: textblock
en: Sets the color mode.  The currently accepted values are: B<auto> (default), B<always> and B<never>.
pt: Define o modo de cor. Os valores actualmente aceites são: B<auto> (predefinido), B<always> e B<never>.

note: type: textblock
en: dpkg-scanpackages - create Packages index files
pt: dpkg-scanpackages - cria ficheiros de índices Packages

note: type: textblock
en: B<dpkg-scanpackages> sorts through a tree of Debian binary packages and creates a Packages file, used by L<apt(8)>, L<dselect(1)>, etc, to tell the user what packages are available for installation.  These Packages files are the same as those found on Debian archive sites and media discs.  You might use B<dpkg-scanpackages> yourself if making a directory of local packages to install on a cluster of machines.
pt: B<dpkg-scanpackages> ordena entre uma árvore de pacotes binários Debian e caria um ficheiro Packages, usado por L<apt(8)>, L<dselect(1)>, etc, para dizer ao utilizador que pacotes estão disponíveis para instalação. Estes ficheiros Packages são os mesmo que aqueles encontrados em sites de arquivos Debian e discos de media. Você próprio pode usar B<dpkg-scanpackages> se pretender criar um directório local de pacotes para instalar num grupo de máquinas.

note: type: textblock
en: B<Note>: If you want to access the generated Packages file with L<apt(8)> you will probably need to compress the file with L<xz(1)> (generating a Packages.xz file), L<bzip2(1)> (generating a Packages.bz2 file) or L<gzip(1)> (generating a Packages.gz file).  L<apt(8)> ignores uncompressed Packages files except on local access (i.e.  B<file://> sources).
pt: B<Nota>: Se você pretende aceder ao ficheiro Packages gerado com o L<apt(8)> vai provavelmente precisar de comprimir o ficheiro com L<xz(1)> (gerando um ficheiro Packages.xz), L<bzip2(1)> (gerando um ficheiro Packages.bz2) ou L<gzip(1)> (gerando um ficheiro Packages.gz ). O L<apt(8)> ignora ficheiros Packages não comprimidos excepto em acesso local (isto é, fontes B<file://>).

note: type: textblock
en: I<binary-path> is the name of the tree of the binary packages to process (for example, B<contrib/binary-i386>).  It is best to make this relative to the root of the Debian archive, because every Filename field in the new Packages file will start with this string.
pt: I<binary-path> é o nome da árvore dos pacotes binários a processar (por exemplo, B<contrib/binary-i386>).  É melhor tornar isto relativo à raiz do arquivo Debian, porque cada campo Filename no novo ficheiro Packages irá começar com esta string.

note: type: textblock
en: I<override-file> is the name of a file to read which contains information about how the package fits into the distribution (the file can be compressed since dpkg 1.15.5); see L<deb-override(5)>.
pt: I<override-file> é o nome de um ficheiro a ler o qual contem informação acerca de como o pacote encaixa na distribuição (o ficheiro pode estar comprimido desde dpkg 1.15.5); veja L<deb-override(5)>.

note: type: textblock
en: I<path-prefix> is an optional string to be prepended to the Filename fields.
pt: I<prefixo-caminho> é um string opcional a ser precedida aos campos Filename.

note: type: textblock
en: If more than one version of a package is found only the newest one is included in the output.  If they have the same version and only differ in architecture only the first one found is used.
pt: Se for encontrada mais do que uma versão de um pacote, apenas a mais recente é incluída no resultado. Se estes tiverem a mesma versão e apenas diferirem na arquitectura, é usado apenas o primeiro encontrado.

note: type: textblock
en: Scan for *.I<type> packages, instead of *.deb.
pt: Sonda por pacotes *.I<tipo>, em vez de *.deb.

note: type: textblock
en: Scan I<file> to find supplementary overrides (the file can be compressed since dpkg 1.15.5).  See L<deb-extra-override(5)> for more information on its format.
pt: Sonda o I<file> para encontrar sobreposições suplementares (o ficheiro pode ser comprimido desde o dpkg 1.15.5). Veja L<deb-extra-override(5)> para mais informações sobre este formato.

note: type: textblock
en: Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of scanning for all debs.
pt: Usa um padrão que consistem de I<*_all.deb> e I<*_arch.deb> em vez de examinar todos os debs.

note: type: textblock
en: Only generate file hashes for the comma-specified list specified (since dpkg 1.17.14).  The default is to generate all currently supported hashes.  Supported values: B<md5>, B<sha1>, B<sha256>.
pt: Apenas gera cinzas de ficheiros para a lista especificada, especificada-por-vírgulas, (desde dpkg 1.17.14). A predefinição é gerar todos os hashes actualmente suportados. Valores suportados: B<md5>, B<sha1>, B<sha256>.

note: type: textblock
en: Include all found packages in the output.
pt: Inclui todos os pacotes encontrados no resultado.

note: type: textblock
en: Add an B<X-Medium> field containing the value I<id-string> (since dpkg 1.15.5).  This field is required if you want to generate B<Packages.cd> files for use by the B<media> access method of B<dselect>.
pt: Adiciona um campo B<X-Medium> que contém o valor I<string-id> (desde dpkg 1.15.5). Este campo é necessário se desejar gerar ficheiros B<Packages.cd> para serem usados pelo método de acesso B<media> do B<dselect>.

note: type: =head1
en: DIAGNOSTICS
pt: DIAGNÓSTICO

note: type: textblock
en: B<dpkg-scanpackages> outputs the usual self-explanatory errors.  It also warns about packages that are in the wrong subdirectory, are duplicated, have a Filename field in their control file, are missing from the override file, or have maintainer substitutions which do not take effect.
pt: B<dpkg-scanpackages> gera os erros auto-explicativos usuais. Também avisa acerca de pacotes que estão no sub-directório errado, estão duplicados, têm um campo Filename no seu ficheiro de controle, estão em falta no ficheiro de sobreposições, ou têm substituições do maintainer as quais não tomam efeito.

note: type: textblock
en: dpkg-scansources - create Sources index files
pt: dpkg-scansources - cria ficheiros de índices Sources

note: type: textblock
en: B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files.  These are used to create a Debian source index, which is output to stdout.
pt: B<dpkg-scansources> sonda o I<directório-binário> fornecido por ficheiros I<.dsc>. Estes são usados para criar um índice de fonte Debian, o qual é enviado para o stdout.

note: type: textblock
en: The I<override-file>, if given, is used to set priorities in the resulting index stanzas and to override the maintainer field given in the I<.dsc> files.  The file can be compressed (since dpkg 1.15.5).  See L<deb-override(5)> for the format of this file.
pt: O I<override-file>, se fornecido, é usado para definir prioridades nas estrofes de índice resultantes e para sobrepor o campo do maintainer dado nos ficheiros I<.dsc>. O ficheiro pode estar comprimido (desde dpkg 1.15.5). Veja L<deb-override(5)> para o formato deste ficheiro.

note: type: textblock
en: B<Note>: Since the override file is indexed by binary, not source packages, there's a bit of a problem here.  The current implementation uses the highest priority of all the binary packages produced by a I<.dsc> file for the priority of the source package, and the override entry for the first binary package listed in the I<.dsc> file to modify maintainer information.  This might change.
pt: B<Nota>: Como o ficheiro de sobreposição é indexado por pacotes binário, não pacotes fonte, existe um pequeno problema aqui. A implementação actual usa a prioridade mais alta de todos os pacotes binários produzidos por um ficheiro I<.dsc> para a prioridade do pacote fonte, e para a entrada de sobreposição para o primeiro pacote binário listado no ficheiro I<.dsc> para modificar a informação do maintainer. Isto poderá ser alterado.

note: type: textblock
en: The I<path-prefix>, if given, is prepended to the directory field in the generated source index.  You generally use this to make the directory fields contain the path from the top of the Debian archive hierarchy.
pt: O I<path-prefix>, se dado, é pré-adicionado ao campo directório no índice fonte gerado. Geralmente você usa isto para fazer com que os campos directório contenham o caminho desde o topo da hierarquia do arquivo Debian.

note: type: textblock
en: B<Note>: If you want to access the generated Sources file with L<apt(8)> you will probably need to compress the file with L<gzip(1)> (generating a Sources.gz file).  L<apt(8)> ignores uncompressed Sources files except on local access (i.e.  B<file://> sources).
pt: B<Nota>: Se você deseja aceder ao ficheiros Sources gerado com L<apt(8)> você vai provavelmente precisar de comprimir o ficheiro com L<gzip(1)> (gerando um ficheiro Sources.gz). O L<apt(8)> ignora ficheiros Sources não comprimidos excepto em acesso local (isto é, fontes B<file://>).

note: type: textblock
en: Do not sort the index stanzas.  Normally they are sorted by source package name.
pt: Não ordena as estrofes do índice. Normalmente elas estão ordenadas pelo nome do pacote fonte.

note: type: textblock
en: Scan I<file> to find supplementary overrides (since dpkg 1.15.4; the file can be compressed since dpkg 1.15.5).  See L<deb-extra-override(5)> for more information on its format.
pt: Sonda o I<ficheiro> para encontrar sobreposições suplementares (desde dpkg 1.15.4; o ficheiro pode ser comprimido desde 1.15.5). Veja L<deb-extra-override(5)> para mais informação sobre este formato.

note: type: textblock
en: Use I<file> as the source override file (the file can be compressed since dpkg 1.15.5).  The default is the name of the override file you specified with I<.src> appended.
pt: Usa I<file> como o ficheiro de sobreposição da fonte (o ficheiro pode ser comprimido desde dpkg 1.15.5). A predefinição é o nome do ficheiro de sobreposição que você especificou com I<.src> adicionado.

note: type: textblock
en: The source override file is in a different format from the binary override file.  It contains only two whitespace separated fields, the first is the source package name and the second is the section.  Blank lines and comment lines are ignored in the normal manner.  If a package appears in both files the source override takes precedence for setting the section.
pt: O ficheiro de sobreposição de fonte está num formato diferente do ficheiro de sobreposição de binário. Contém apenas dois campos separados por espaço em branco, o primeiro é o nome do pacote fonte e o segundo é a secção. Linhas vazias e comentários são ignorados no modo normal. Se um pacote aparece em ambos ficheiros a sobreposição de fonte toma precedência para definir a secção.

note: type: textblock
en: Turn debugging on.
pt: Liga a depuração.

note: type: textblock
en: dpkg-shlibdeps - generate shared library substvar dependencies
pt: dpkg-shlibdeps - gera dependências substvar de biblioteca partilhada

note: type: textblock
en: B<dpkg-shlibdeps> calculates shared library dependencies for executables named in its arguments.  The dependencies are added to the substitution variables file B<debian/substvars> as variable names B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency field name.  Any other variables starting with B<shlibs:> are removed from the file.
pt: B<dpkg-shlibdeps> calcula dependências de bibliotecas partilhadas para executáveis nomeados nos seus argumentos. As dependências são adicionadas ao ficheiro de variáveis de substituição B<debian/substvars> como nomes de variáveis B<shlibs:>I<dependency-field> onde I<dependency-field> é um nome de campo de dependência. Quaisquer outras variáveis começadas com B<shlibs:> são removidas do ficheiro.

note: type: textblock
en: B<dpkg-shlibdeps> has two possible sources of information to generate dependency information.  Either I<symbols> files or I<shlibs> files.  For each binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries that it's linked with.  Then, for each library, it looks up either the I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if debian/shlibs.local contains the relevant dependency).  Both files are supposed to be provided by the library package and should thus be available as %ADMINDIR%/info/I<package>.I<symbols> or %ADMINDIR%/info/I<package>.I<shlibs>.  The package name is identified in two steps: find the library file on the system (looking in the same directories that B<ld.so> would use), then use B<dpkg -S> I<library-file> to lookup the package providing the library.
pt: B<dpkg-shlibdeps> tem duas possíveis fontes de informação para gerar a informação de dependências. Seja ficheiros I<symbols> ou ficheiros I<shlibs>. Para cada binário que o B<dpkg-shlibdeps> analise, ele encontra a lista de binários com que tem links. Depois, para cada biblioteca, procura pelo ficheiro I<symbols>, ou pelo ficheiro I<shlibs> (se o anterior não existir ou se debian/shlibs.local conter a dependência relevante). Ambos ficheiros são supostos serem fornecidos pelo pacote biblioteca e devem assim estarem disponíveis como as %ADMINDIR%/info/I<package>.I<symbols> ou %ADMINDIR%/info/I<package>.I<shlibs>. O nome do pacote é identificado em dois passos: encontrar o ficheiro biblioteca no sistema (procurando nos mesmos directórios que B<ld.so> iria usar), depois usar B<dpkg -S> I<library-file> para procurar o pacote que fornece a biblioteca.

note: type: =head2
en: Symbols files
pt: Ficheiros de Símbolos

note: type: textblock
en: Symbols files contain finer-grained dependency information by providing the minimum dependency for each symbol that the library exports.  The script tries to find a symbols file associated to a library package in the following places (first match is used):
pt: Ficheiros Symbols contêm informação de dependências afinada ao fornecerem a dependência mínima para cada símbolo que a biblioteca exporta. O script tenta encontrar um ficheiro de símbolos associado a um pacote biblioteca nos seguintes locais (é usada a primeira correspondência):

note: type: textblock
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are generated by L<dpkg-gensymbols(1)>.  They are only used if the library is found in a package's build tree.  The symbols file in that build tree takes precedence over symbols files from other binary packages.
pt: Informação de biblioteca partilhada gerada pelo actual processo de compilação que também invocou B<dpkg-shlibdeps>. São gerados por L<dpkg-gensymbols(1)>. São apenas usados se a biblioteca for encontrada na árvore de compilação do pacote. O ficheiro de símbolos nessa árvore de compilação toma precedência sobre ficheiros de símbolos de outros pacotes binários.

note: type: textblock
en: Per-system overriding shared library dependency information.  I<arch> is the architecture of the current system (obtained by B<dpkg-architecture -qDEB_HOST_ARCH>).
pt: Informação de sobreposição por-sistema de dependência de biblioteca partilhada. I<arch> é a arquitectura do sistema actual (obtida por B<dpkg-architecture -qDEB_HOST_ARCH>).

note: type: =item
en: Output from “B<dpkg-query --control-path> I<package> symbols”
pt: Resultado de “B<dpkg-query --control-path> I<package> symbols”

note: type: textblock
en: Package-provided shared library dependency information.  Unless overridden by B<--admindir>, those files are located in %ADMINDIR%.
pt: Informação de dependências de bibliotecas partilhadas fornecidas pelo pacote. A menos que sobrepostas por B<--admindir>, esses ficheiros estão localizados em %ADMINDIR%.

note: type: textblock
en: While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers the (biggest) minimal version needed for each library.  At the end of the process, it is able to write out the minimal dependency for every library used (provided that the information of the I<symbols> files are accurate).
pt: Enquanto sonda os símbolos usados por todos os binários, o B<dpkg-shlibdeps> lembra-se da versão mínima (mais alta) necessária para cada biblioteca. No final do processo, é capaz de escrever a dependência mínima para cada biblioteca usada (desde que a informação dos ficheiros I<symbols> esteja exacta).

note: type: textblock
en: As a safe-guard measure, a symbols file can provide a B<Build-Depends-Package> or B<Build-Depends-Packages> meta-information field and B<dpkg-shlibdeps> will extract the minimal version required by the corresponding package in the B<Build-Depends> field and use this version if it's higher than the minimal version computed by scanning symbols.
pt: Como medida de salva-guarda, um ficheiro de símbolos pode fornecer um campo de meta-informação B<Build-Depends-Package> ou B<Build-Depends-Packages> e B<dpkg-shlibdeps> irá extrair a versão mínima requerida pelo pacote correspondente no campo B<Build-Depends> e usa esta versão se for maior que a versão mínima computada pela sondagem dos símbolos.

note: type: =head2
en: Shlibs files
pt: Ficheiros shlibs

note: type: textblock
en: Shlibs files associate directly a library to a dependency (without looking at the symbols).  It's thus often stronger than really needed but very safe and easy to handle.
pt: Ficheiros Shlibs associam directamente uma biblioteca a uma dependência (sem olhar para os símbolos). É assim geralmente mais forte do que realmente necessário mas muito seguro e fácil de manusear.

note: type: textblock
en: The dependencies for a library are looked up in several places.  The first file providing information for the library of interest is used:
pt: As dependências por uma biblioteca são procuradas em vários lugares. É usado o primeiro ficheiro que providencia informação para a biblioteca que interessa:

note: type: textblock
en: Package-local overriding shared library dependency information.
pt: Informação de dependência de biblioteca partilhada que sobrepõe pacote local

note: type: textblock
en: Per-system overriding shared library dependency information.
pt: Informação de dependência de biblioteca partilhada de sobreposição por sistema.

note: type: textblock
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are only used if the library is found in a package's build tree.  The shlibs file in that build tree takes precedence over shlibs files from other binary packages.
pt: Informação de biblioteca partilhada gerada pelo actual processo de compilação que também invocou B<dpkg-shlibdeps>. São apenas usados se a biblioteca for encontrada na árvore de compilação do pacote. O ficheiro shlibs nessa árvore de compilação toma precedência sobre ficheiros shlibs de outros pacotes binários.

note: type: =item
en: Output from “B<dpkg-query --control-path> I<package> shlibs”
pt: Resultado de “B<dpkg-query --control-path> I<package> shlibs”

note: type: textblock
en: Per-system default shared library dependency information.
pt: Informação de dependência de biblioteca partilhada predefinida por sistema.

note: type: textblock
en: The extracted dependencies are then directly used (except if they are filtered out because they have been identified as duplicate, or as weaker than another dependency).
pt: as dependências extraídas são depois usadas directamente (excepto se forem filtradas porque foram identificadas como duplicadas, ou como mas fracas que outra dependência).

note: type: textblock
en: B<dpkg-shlibdeps> interprets non-option arguments as executable names, just as if they'd been supplied as B<-e>I<executable>.
pt: B<dpkg-shlibdeps> interpreta argumentos não-opção como nomes executáveis, como se eles fosse fornecidos como B<-e>I<executable>.

note: type: textblock
en: Include dependencies appropriate for the shared libraries required by I<executable>.  This option can be used multiple times.
pt: Inclui as dependências apropriadas para as bibliotecas partilhadas requeridas pelo I<executável>. Esta opção pode ser usada várias vezes.

note: type: textblock
en: Prepend I<directory> to the list of directories to search for private shared libraries (since dpkg 1.17.0).  This option can be used multiple times.
pt: Adiciona I<directory> ao inicio da lista de directórios a pesquisar por bibliotecas partilhadas privadas (desde dpkg 1.17.0). Esta opção pode ser usada várias vezes.

note: type: textblock
en: Add dependencies to be added to the control file dependency field I<dependency-field>.  (The dependencies for this field are placed in the variable B<shlibs:>I<dependency-field>.)
pt: Todas as dependências a serem adicionadas ao campo de dependências do ficheiro de controle I<dependency-field>. (As dependências para este campo são colocadas na variável B<shlibs:>I<dependency-field>.)

note: type: textblock
en: The B<-d>I<dependency-field> option takes effect for all executables after the option, until the next B<-d>I<dependency-field>.  The default I<dependency-field> is B<Depends>.
pt: A opção B<-d>I<dependency-field> produz efeito para todos os executáveis após a opção, até ao próximo B<-d>I<dependency-field>. A predefinição de I<dependency-field> é B<Depends>.

note: type: textblock
en: If the same dependency entry (or set of alternatives) appears in more than one of the recognized dependency field names B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will automatically remove the dependency from all fields except the one representing the most important dependencies.
pt: Se a mesma entrada de dependência (ou conjunto de alternativas) aparecer em mais do que um dos nomes de campos de dependência reconhecida B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> ou B<Suggests> então B<dpkg-shlibdeps> irá remover automaticamente a dependência de todos os campos excepto daquele que representa as dependências mais importantes.

note: type: textblock
en: Start substitution variables with I<varname-prefix>B<:> instead of B<shlibs:>.  Likewise, any existing substitution variables starting with I<varname-prefix>B<:> (rather than B<shlibs:>)  are removed from the substitution variables file.
pt: Começa as variáveis de substituição com I<varname-prefix>B<:> em vez de B<shlibs:>. Do mesmo modo, quaisquer variáveis de substituição existentes que comecem com I<varname-prefix>B<:> (em vez de B<shlibs:>) são removidas do ficheiros de variáveis de substituição.

note: type: textblock
en: Print substitution variable settings to standard output (or I<filename> if specified, since dpkg 1.17.2), rather than being added to the substitution variables file (B<debian/substvars> by default).
pt: Escreve as definições de variáveis de substituição na saída standard (ou I<filename> se especificado, desde dpkg 1.17.2), em vez de serem adicionadas ao ficheiro de variáveis de substituição (B<debian/substvars> por predefinição).

note: type: textblock
en: Prefer shared library dependency information tagged for the given package type.  If no tagged information is available, falls back to untagged information.  The default package type is B<deb>.  Shared library dependency information is tagged for a given type by prefixing it with the name of the type, a colon, and whitespace.
pt: Informação etiquetada de dependência de biblioteca partilhada preferida para o tipo de pacote dado. Se não existir informação etiquetada, cai para a informação não etiquetada. O tipo de pacote predefinido é B<deb>. A informação de dependência de biblioteca partilhada é etiquetada para um determinado tipo ao prefixa-la com o nome to tipo, dois pontos, e espaço em branco.

note: type: textblock
en: Read overriding shared library dependency information from I<local-shlibs-file> instead of B<debian/shlibs.local>.
pt: Lê informação de sobreposição de dependência de biblioteca partilhada a partir de I<local-shlibs-file> em vez de B<debian/shlibs.local>.

note: type: textblock
en: Write substitution variables in I<substvars-file>; the default is B<debian/substvars>.
pt: Escreve variáveis de substituição em I<substvars-file>; a predefinição é B<debian/substvars>.

note: type: textblock
en: Enable verbose mode (since dpkg 1.14.8).  Numerous messages are displayed to explain what B<dpkg-shlibdeps> does.
pt: Activa o modo detalhado (desde dpkg 1.14.8). São mostradas numerosas mensagens para explicar o que o B<dpkg-shlibdeps> faz.

note: type: textblock
en: Exclude the package from the generated dependencies (since dpkg 1.14.8).  This is useful to avoid self-dependencies for packages which provide ELF binaries (executables or library plugins) using a library contained in the same package.  This option can be used multiple times to exclude several packages.
pt: Exclui o pacote das dependências geradas (desde dpkg 1.14.8). Isto é útil para evitar auto-dependências para pacotes que fornecem binários ELF (executáveis ou plugins biblioteca) usando uma biblioteca contida no mesmo pacote. Esta opção pode ser usada várias vezes para excluir vários pacotes.

note: type: textblock
en: Look into I<package-build-dir> first when trying to find a library (since dpkg 1.14.15).  This is useful when the source package builds multiple flavors of the same library and you want to ensure that you get the dependency from a given binary package.  You can use this option multiple times: directories will be tried in the same order before directories of other binary packages.
pt: Procura primeiro em I<package-build-dir> quando tenta encontrar uma biblioteca (desde dpkg 1.14.15). Isto é útil quando o pacote fonte compila vários sabores da mesma biblioteca e você quer assegurar que obtém a dependência a partir de um determinado pacote binário. Você pode usar esta opção várias vezes: directórios serão tentados na mesma ordem antes de directórios de outros pacotes binários.

note: type: textblock
en: Ignore I<package-build-dir> when looking for shlibs, symbols, and shared library files (since dpkg 1.18.5).  You can use this option multiple times.
pt: Ignora I<package-build-dir> quando procurar por shlibs, symbols, e ficheiros de biblioteca partilhada (desde dpkg 1.18.5). Você pode usar esta opção várias vezes.

note: type: textblock
en: Do not fail if dependency information can't be found for a shared library (since dpkg 1.14.8).  Usage of this option is discouraged, all libraries should provide dependency information (either with shlibs files, or with symbols files)  even if they are not yet used by other packages.
pt: Não falha se a informação de dependência não pode ser encontrada para uma biblioteca partilhada (desde dpkg 1.14.8). A utilização desta opção é desencorajada, todas as bibliotecas devem fornecer informação de dependências (seja com ficheiros shlibs, ou com ficheiros symbols) mesmo se ainda não forem usadas por outros pacotes.

note: type: textblock
en: I<value> is a bit field defining the set of warnings that can be emitted by B<dpkg-shlibdeps> (since dpkg 1.14.17).  Bit 0 (value=1) enables the warning “symbol I<sym> used by I<binary> found in none of the libraries”, bit 1 (value=2) enables the warning “package could avoid a useless dependency” and bit 2 (value=4) enables the warning “I<binary> should not be linked against I<library>”.  The default I<value> is 3: the first two warnings are active by default, the last one is not.  Set I<value> to 7 if you want all warnings to be active.
pt: I<value> é um campo de bit que define o conjunto de avisos que podem ser emitidos pelo B<dpkg-shlibdeps> (desde dpkg 1.14.17).  Bit 0 (valor=1) activa o aviso “symbol I<sym> usado por I<binary> encontrado em nenhuma das bibliotecas, bit 1 (valor=2) activa o aviso “pacote podia evitar uma dependência inútil” e bit 2 (valor=4) activa o aviso “I<binary> não deveria estar em link contra I<library>”. O I<value> predefinido é 3: os dois primeiros avisos estão activos por predefinição, o último não está. Defina I<value> para 7 se deseja ter todos os avisos activos.

note: type: =head2
en: Warnings
pt: Avisos

note: type: textblock
en: Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of the generated package, it is able to emit warnings in several cases.  They inform you of things that can be improved in the package.  In most cases, those improvements concern the upstream sources directly.  By order of decreasing importance, here are the various warnings that you can encounter:
pt: Como o B<dpkg-shlibdeps> analisa o conjunto de símbolos usados por cada binário do pacote gerado, é capaz de emitir avisos em vários casos. Eles informam-o de coisas que podem ser melhoradas no pacote. Na maioria dos casos, esses melhoramentos interessam directamente às fontes do autor. Por ordem de importância descendente, aqui estão os vários avisos que você pode encontrar:

note: type: textblock
en: The indicated symbol has not been found in the libraries linked with the binary.  The I<binary> is most likely a library and it needs to be linked with an additional library during the build process (option B<-l>I<library> of the linker).
pt: O símbolo indicado não foi encontrado nas bibliotecas em link com o binário. O I<binary> é mais certamente uma biblioteca e precisa de ser ligada em link com uma biblioteca adicional durante o processo de compilação (opção B<-l>I<library> do vinculador).

note: type: textblock
en: The indicated symbol has not been found in the libraries linked with the binary.  The I<binary> is most likely a plugin and the symbol is probably provided by the program that loads this plugin.  In theory a plugin doesn't have any SONAME but this binary does have one and as such it could not be clearly identified as such.  However the fact that the binary is stored in a non-public directory is a strong indication that's it's not a normal shared library.  If the binary is really a plugin, then disregard this warning.  But there's always the possibility that it's a real library and that programs linking to it are using an RPATH so that the dynamic loader finds it.  In that case, the library is broken and needs to be fixed.
pt: O símbolo indicado não foi encontrado nas bibliotecas em link com o binário. O I<binary> é mais certamente um plugin e o símbolo é provavelmente fornecido pelo programa que carrega este plugin. Em teoria um plugin não tem nenhum SONAME mas este binário tem um e como tal ele não pôde ser claramente identificado como tal. No entanto, o facto de que o binários está armazenado num directório não-público é uma forte indicação que não é uma biblioteca partilhada normal. Se o binário é mesmo um plugin, então esqueça este aviso. Mas há sempre a possibilidade que seja uma biblioteca real e que esses programas em link com ela estejam a usar uma RPATH para que o carregador dinâmico as encontre. Nesse caso, a biblioteca está quebrada e precisa de ser reparada.

note: type: textblock
en: None of the I<binaries> that are linked with I<library> use any of the symbols provided by the library.  By fixing all the binaries, you would avoid the dependency associated to this library (unless the same dependency is also generated by another library that is really used).
pt: Nenhum dos I<binaries> que estão em link com I<library> usam qualquer dos símbolos fornecidos pela biblioteca. Ao corrigir todos os binários, você deveria evitar a dependência associada a esta biblioteca (a menos que a mesma dependência seja também gerada por outra biblioteca que seja realmente usada).

note: type: textblock
en: Exactly the same as the above warning, but for multiple binaries.
pt: Exactamente o mesmo que o aviso em cima, mas para múltiplos binários.

note: type: textblock
en: The I<binary> is linked to a library that it doesn't need.  It's not a problem but some small performance improvements in binary load time can be obtained by not linking this library to this binary.  This warning checks the same information as the previous one but does it for each binary instead of doing the check globally on all binaries analyzed.
pt: O I<binary> está ligado em link com uma biblioteca que não precisa. Não é um problema mas pode-se obter algum pequeno melhoramento de performance no tempo de carga do binário se não se ligar esta biblioteca a este binário. Este aviso verifica a mesma informação que o anterior mas fá-lo para cada binário em vez de fazer as verificações globalmente para todos os binários analisados.

note: type: =head2
en: Errors
pt: Erros

note: type: textblock
en: B<dpkg-shlibdeps> will fail if it can't find a public library used by a binary or if this library has no associated dependency information (either shlibs file or symbols file).  A public library has a SONAME and is versioned (libsomething.so.I<X>).  A private library (like a plugin) should not have a SONAME and doesn't need to be versioned.
pt: B<dpkg-shlibdeps> irá falhar se não conseguir encontrar uma biblioteca pública usada por um binário ou se esta biblioteca não tiver informação de dependência associada (seja um ficheiro shlibs ou symbols). Uma biblioteca pública tem um SONAME e é versionado ((libsomething.so.I<X>). Uma biblioteca privada (como um plugin) não deve ter um SONAME e não precisa de ser versionada.

note: type: textblock
en: The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> has been unable to find the library.  B<dpkg-shlibdeps> creates a list of directories to check as following: directories listed in the RPATH of the binary, directories added by the B<-l> option, directories listed in the B<LD_LIBRARY_PATH> environment variable, cross multiarch directories (ex. /lib/arm64-linux-gnu, /usr/lib/arm64-linux-gnu), standard public directories (/lib, /usr/lib), directories listed in /etc/ld.so.conf, and obsolete multilib directories (/lib32, /usr/lib32, /lib64, /usr/lib64).  Then it checks those directories in the package's build tree of the binary being analyzed, in the packages' build trees indicated with the B<-S> command-line option, in other packages' build trees that contains a DEBIAN/shlibs or DEBIAN/symbols file and finally in the root directory.  If the library is not found in any of those directories, then you get this error.
pt: O I<binary> usa uma biblioteca chamada I<library-soname> mas o B<dpkg-shlibdeps> não foi capaz de encontrar a biblioteca. B<dpkg-shlibdeps> cria uma lista de directórios a verificar como se segue: directórios listados na RPATH do binário, directórios adicionados pela opção B<-l>, directórios listados na variável de ambiente B<LD_LIBRARY_PATH>, directórios de multi-arquitectura cruzada (ex. /lib/arm64-linux-gnu, /usr/lib/arm64-linux-gnu), directórios públicos standard (/lib, /usr/lib), directórios listados em /etc/ld.so.conf, e directórios multilib obsoletos (/lib32, /usr/lib32, /lib64, /usr/lib64). Depois verifica esses directórios na árvore de compilação do pacote do binário a ser analisado, nas árvores de compilação dos pacotes indicados com a opção de linha de comandos B<-S>, nas árvores de compilação de outros pacotes que contêm um ficheiro DEBIAN/shlibs ou DEBIAN/symbols e finalmente no directório raiz. Se a biblioteca não for encontrada em nenhum destes directórios, então você vai obter este erro.

note: type: textblock
en: If the library not found is in a private directory of the same package, then you want to add the directory with B<-l>.  If it's in another binary package being built, you want to make sure that the shlibs/symbols file of this package is already created and that B<-l> contains the appropriate directory if it also is in a private directory.
pt: Se a biblioteca não encontrada está num directório privado do mesmo pacote, então você tem de adicionar o directório com B<-l>. Se está noutro pacote binário a ser compilado, então você tem de certificar-se que o ficheiro shlibs/symbols deste pacote já está criado e que o B<-l> contém o directório apropriado se estiver também num directório privado.

note: type: textblock
en: The library needed by I<binary> has been found by B<dpkg-shlibdeps> in I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency information for that library.  To find out the dependency, it has tried to map the library to a Debian package with the help of B<dpkg -S> I<library-file>.  Then it checked the corresponding shlibs and symbols files in %ADMINDIR%/info/, and in the various package's build trees (debian/*/DEBIAN/).
pt: A biblioteca necessária pelo I<binary> foi encontrada pelo B<dpkg-shlibdeps> em I<library-file> mas B<dpkg-shlibdeps> não foi capaz de encontrar nenhuma informação de dependência para essa biblioteca.  Para encontrar a dependência, tentou mapear a biblioteca a um pacote Debian com a ajuda de B<dpkg -S> I<library-file>. Depois verificou os ficheiros shlibs e symbols correspondentes em %ADMINDIR%/info/, e nas várias árvores de compilação de pacotes (debian/*/DEBIAN/).

note: type: textblock
en: This failure can be caused by a bad or missing shlibs or symbols file in the package of the library.  It might also happen if the library is built within the same source package and if the shlibs files has not yet been created (in which case you must fix debian/rules to create the shlibs before calling B<dpkg-shlibdeps>).  Bad RPATH can also lead to the library being found under a non-canonical name (example: /usr/lib/openoffice.org/../lib/libssl.so.0.9.8 instead of /usr/lib/libssl.so.0.9.8) that's not associated to any package, B<dpkg-shlibdeps> tries to work around this by trying to fallback on a canonical name (using L<realpath(3)>)  but it might not always work.  It's always best to clean up the RPATH of the binary to avoid problems.
pt: Esta falha pode ser causada por um ficheiro shlibs ou symbols mau ou em falta no pacote da biblioteca. Também pode acontecer se a biblioteca for compilada dentro do mesmo pacote fonte e se os ficheiros shlibs ainda não foram criados (que neste caso você tem de corrigir debian/rules para criar o shlibs antes de chamar B<dpkg-shlibdeps>). Uma má RPATH também pode levar a que a biblioteca seja encontrada sob um nome não-canónico (exemplo: /usr/lib/openoffice.org/../lib/libssl.so.0.9.8 em vez de /usr/lib/libssl.so.0.9.8) que não está associado a nenhum pacote, o B<dpkg-shlibdeps> tenta contornar isto ao tentar descer para um nome canónico (usando L<realpath(3)>) mas pode nem sempre funcionar. É sempre melhor limpar a RPATH do binário para evitar problemas.

note: type: textblock
en: Calling B<dpkg-shlibdeps> in verbose mode (B<-v>) will provide much more information about where it tried to find the dependency information.  This might be useful if you don't understand why it's giving you this error.
pt: Chamar o B<dpkg-shlibdeps> em modo detalhado (B<-v>) irá providenciar muito mais informação acerca de onde ele tentou encontrar a informação de dependência. Isto pode ser útil se você não perceber porquê está a dar-lhe este erro.

note: type: textblock
en: dpkg-source - Debian source package (.dsc) manipulation tool
pt: dpkg-source - ferramenta de manipulação de pacotes fonte Debian (.dsc)

note: type: textblock
en: B<dpkg-source> packs and unpacks Debian source archives.
pt: B<dpkg-source> empacote e desempacota arquivos de fonte Debian.

note: type: textblock
en: None of these commands allow multiple options to be combined into one, and they do not allow the value for an option to be specified in a separate argument.
pt: Nenhum destes comandos permite que várias acções sejam combinadas em uma, e eles não permitem que o valor para uma opção seja especificado num argumento separado.

note: type: textblock
en: Extract a source package (B<--extract> since dpkg 1.17.14).  One non-option argument must be supplied, the name of the Debian source control file (B<.dsc>).  An optional second non-option argument may be supplied to specify the directory to extract the source package to, this must not exist.  If no output directory is specified, the source package is extracted into a directory named I<source>-I<version> under the current working directory.
pt: Extrai o pacote fonte (B<--extract> desde dpkg 1.17.14). Tem de ser fornecido um argumento não-opção, o nome do ficheiro de controle de fonte Debian (B<.dsc>). Opcionalmente pode ser fornecido um segundo argumento não-opção para especificar o directório para onde extrair o pacote fonte, e este não pode existir. Se não for especificado o directório de saída, o pacote fonte é extraído para um directório chamado I<source>-I<version> sob o directório de trabalho actual.

note: type: textblock
en: B<dpkg-source> will read the names of the other file(s) making up the source package from the control file; they are assumed to be in the same directory as the B<.dsc>.
pt: O B<dpkg-source> irá ler os nomes dos outros ficheiros que fazem o pacote fonte a partir do ficheiro de controle; assume-se que eles estejam no mesmo directório que o B<.dsc>.

note: type: textblock
en: The files in the extracted package will have their permissions and ownerships set to those which would have been expected if the files and directories had simply been created - directories and executable files will be 0777 and plain files will be 0666, both modified by the extractors' umask; if the parent directory is setgid then the extracted directories will be too, and all the files and directories will inherit its group ownership.
pt: Os ficheiros no pacote extraído irão ter as suas permissões e propriedades definidas para aquelas que seriam as esperadas caso os ficheiros e directórios tivessem simplesmente sido criados - os directórios e ficheiros executáveis irão ficar com 0777 e ficheiros simples irão ficar com 0666, ambos modificados pelo umask do extractor; se o directório pai está com setgid então os directórios extraídos estarão também, e todos os ficheiros e directórios irão herdar a propriedade do seu grupo.

note: type: textblock
en: If the source package uses a non-standard format (currently this means all formats except “1.0”), its name will be stored in B<debian/source/format> so that the following builds of the source package use the same format by default.
pt: Se o pacote fonte usar um formato não-standard (actualmente isto significa todos os formatos excepto “1.0”), o seu nome será armazenado em B<debian/source/format> para que as compilações seguintes do pacote fonte usem o mesmo formato por predefinição.

note: type: textblock
en: Build a source package (B<--build> since dpkg 1.17.14).  The first non-option argument is taken as the name of the directory containing the debianized source tree (i.e. with a debian sub-directory and maybe changes to the original files).  Depending on the source package format used to build the package, additional parameters might be accepted.
pt: Compila um pacote fonte (B<--build> desde dpkg 1.17.14). O primeiro argumento não-opção é tomado como o nome do directório que contém a árvore fonte debianizada (isto é, com um sub-directório debian e talvez alterações aos ficheiro originais). Dependendo do formato do pacote fonte usado para compilar o pacote, podem ser aceites parâmetros adicionais.

note: type: textblock
en: B<dpkg-source> will build the source package with the first format found in this ordered list: the format indicated with the I<--format> command line option, the format indicated in B<debian/source/format>, “1.0”.  The fallback to “1.0” is deprecated and will be removed at some point in the future, you should always document the desired source format in B<debian/source/format>.  See section L</SOURCE PACKAGE FORMATS> for an extensive description of the various source package formats.
pt: B<dpkg-source> irá compilado o pacote fonte com o primeiro formato encontrado nesta lista por esta ordem: o formato indicado com a opção de linha de comando I<--format>, o formato indicado em B<debian/source/format>, “1.0”. O cair para “1.0” está descontinuado e será removido em algum ponto no futuro, você deve sempre documentar o formato de fonte desejado em B<debian/source/format>.Veja a secção L</SOURCE PACKAGE FORMATS> para uma descrição extensiva dos vários formatos de pacote fonte.

note: type: textblock
en: Print the source format that would be used to build the source package if B<dpkg-source --build> I<directory> was called (in the same conditions and with the same parameters; since dpkg 1.15.5).
pt: Escreve o formato de fonte que será usado para compilar o pacote fonte se foi chamado B<dpkg-source -b> I<directory> (nas mesmas condições e com os mesmos parâmetros; desde dpkg 1.15.5).

note: type: textblock
en: Run the corresponding hook of the source package format (since dpkg 1.15.8).  This hook is called before any build of the package (B<dpkg-buildpackage> calls it very early even before B<debian/rules clean>).  This command is idempotent and can be called multiple times.  Not all source formats implement something in this hook, and those that do usually prepare the source tree for the build for example by ensuring that the Debian patches are applied.
pt: Corre o hook correspondente do formato de pacote fonte (desde dpkg 1.15.8). Este hook é chamado antes de qualquer compilação do pacote (B<dpkg-buildpackage> chama-o muito cedo ainda antes de B<debian/rules clean>). Este comando é idempotente e pode ser chamado várias vezes. Nem todos os formatos fonte implementam alguma coisa neste hook, e os que o fazem geralmente preparam a árvore fonte para a compilação, por exemplo ao assegurarem que as patches Debian são aplicadas.

note: type: textblock
en: Run the corresponding hook of the source package format (since dpkg 1.15.8).  This hook is called after any build of the package (B<dpkg-buildpackage> calls it last).  This command is idempotent and can be called multiple times.  Not all source formats implement something in this hook, and those that do usually use it to undo what B<--before-build> has done.
pt: Corre o hook correspondente do formato de pacote fonte (desde dpkg 1.15.8). Este hook é chamado após qualquer compilação do pacote (B<dpkg-buildpackage> chama-o no em último). Este comando é idempotente e pode ser chamado várias vezes. Nem todos os formatos fonte implementam alguma coisa neste hook, e os que o fazem geralmente usam-no para desfazer o que o B<--before-build> fez.

note: type: textblock
en: Record changes in the source tree unpacked in I<directory> (since dpkg 1.16.1).  This command can take supplementary parameters depending on the source format.  It will error out for formats where this operation doesn't mean anything.
pt: Grava alterações na árvore fonte desempacotada em I<directory> (desde dpkg 1.16.1). Este comando pode levar parâmetros suplementares dependendo do formato de fonte. Irá terminar em erro para formatos onde este operador não signifique nada.

note: type: textblock
en: Show the usage message and exit.  The format specific build and extract options can be shown by using the B<--format> option.
pt: Mostra a mensagem de utilização e termina. O formato específico de compilação e opções de extração podem ser mostrados ao usar a opção B<--format>.

note: type: =head2
en: Generic build options
pt: Opções de compilação genéricas

note: type: textblock
en: Specifies the main source control file to read information from.  The default is B<debian/control>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
pt: Especifica o ficheiro de controle fonte principal de onde ler informação. A predefinição é B<debian/control>. Se fornecido com nome de caminho relativo isso é interpretado como começado a partir do directório de nível de topo da árvore fonte.

note: type: textblock
en: Specifies the changelog file to read information from.  The default is B<debian/changelog>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
pt: Especifica o ficheiro changelog de onde ler informação. A predefinição é B<debian/changelog>. Se fornecido com nome de caminho relativo isso é interpretado como começado a partir do directório de nível de topo da árvore fonte.

note: type: textblock
en: Use the given format for building the source package (since dpkg 1.14.17).  It does override any format given in B<debian/source/format>.
pt: Usa o formato fornecido para compilar o pacote fonte (desde dpkg 1.14.17). Sobrepõe-se a qualquer formato dado em B<debian/source/format>.

note: type: textblock
en: Read substitution variables in I<substvars-file>; the default is to not read any file.  This option can be used multiple times to read substitution variables from multiple files (since dpkg 1.15.6).
pt: Lê variáveis de substituição em I<substvars-file>; a predefinição é não ler nenhum ficheiro. Esta opção pode usada várias vezes para ler variáveis de substituição a partir de múltiplos ficheiros (desde 1.15.6).

note: type: textblock
en: Specify the compression to use for created tarballs and diff files (B<--compression> since dpkg 1.15.5).  Note that this option will not cause existing tarballs to be recompressed, it only affects new files.  Supported values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>.  The default is I<xz> for formats 2.0 and newer, and I<gzip> for format 1.0.  I<xz> is only supported since dpkg 1.15.5.
pt: Especifica a compressão a usar para os ficheiros tarball e diff criados (B<--compression> desde dpkg 1.15.5). Note que esta opção não irá fazer com que tarballs existentes sejam re-comprimidos, apenas afecta os novos ficheiros. Valores suportados são: I<gzip>, I<bzip2>, I<lzma> e I<xz>. A predefinição é I<xz> para formatos 2.0 e mais recentes, e I<gzip> para o formato 1.0. I<xz> é apenas suportado desde dpkg 1.15.5.

note: type: textblock
en: Compression level to use (B<--compression-level> since dpkg 1.15.5).  As with B<-Z> it only affects newly created files.  Supported values are: I<1> to I<9>, I<best>, and I<fast>.  The default is I<9> for gzip and bzip2, I<6> for xz and lzma.
pt: Nível de compressão a usar (B<--compression-level> desde dpkg 1.15.5). Tal como B<-Z> irá apenas afectar ficheiros recentemente criados. Valores suportados são: I<1> até I<9>, I<best>, e I<fast>.  A predefinição é I<9> para gzip e bzip2, I<6> para xz e lzma.

note: type: textblock
en: You may specify a perl regular expression to match files you want filtered out of the list of files for the diff (B<--diff-ignore> since dpkg 1.15.6).  (This list is generated by a find command.) (If the source package is being built as a version 3 source package using a VCS, this can be used to ignore uncommitted changes on specific files.  Using -i.* will ignore all of them.)
pt: Você pode especificar uma expressão regular perl para coincidir aos ficheiros que deseja filtrar e retirar da lista de ficheiros para o diff (B<--diff-ignore> desde dpkg 1.15.6). (Esta lista é gerada por um comando de procura (find)) (Se o pacote fonte está a ser compilado como um pacote fonte de versão 3 usando um VCS, isto pode ser usado para ignorar alterações não cometidas em ficheiros específicos . Usar -i.* irá ignorar todos eles.)

note: type: textblock
en: The B<-i> option by itself enables this setting with a default regex (preserving any modification to the default regex done by a previous use of B<--extend-diff-ignore>) that will filter out control files and directories of the most common revision control systems, backup and swap files and Libtool build output directories.  There can only be one active regex, of multiple B<-i> options only the last one will take effect.
pt: A opção B<-i> por si só activa esta definição com uma regex predefinida (preservando qualquer modificação ao regex predefinido feito por uma utilização anterior de B<--extend-diff-ignore>) que irá filtrar fora ficheiros de controle e directórios dos sistemas de controlo de revisão mais comuns, salvaguardas e ficheiros swap, e directórios de resultados de compilação de Libtool. Só pode existir um regex activo, das várias opções B<-i> apenas a última irá ter efeito.

note: type: textblock
en: This is very helpful in cutting out extraneous files that get included in the diff, for example if you maintain your source in a revision control system and want to use a checkout to build a source package without including the additional files and directories that it will usually contain (e.g. CVS/, .cvsignore, .svn/).  The default regex is already very exhaustive, but if you need to replace it, please note that by default it can match any part of a path, so if you want to match the begin of a filename or only full filenames, you will need to provide the necessary anchors (e.g. ‘(^|/)’, ‘($|/)’) yourself.
pt: Isto é uma grande ajuda para cortar ficheiros alheios que foram incluídos no diff, por exemplo se você mantêm a sua fonte num sistema de controle de revisão e deseja usar um checkout para compilar um pacote fonte sem incluir os ficheiros adicionais e os directórios que geralmente contém (ex. CVS/, .cvsignore, .svn/). O regex predefinido já é bastante exaustivo, mas se precisar de o substituir, por favor note que por predefinição ele consegue corresponder a qualquer parte de um caminho, portanto se você quer corresponder ao inicio de um nome de ficheiro, ou apenas nomes completos de ficheiros, precisa ser você próprio a fornecer as âncoras necessárias (ex, ‘(^|/)’, ‘($|/)’).

note: type: textblock
en: The perl regular expression specified will extend the default value used by B<--diff-ignore> and its current value, if set (since dpkg 1.15.6).  It does this by concatenating “B<|>I<regex>” to the existing value.  This option is convenient to use in B<debian/source/options> to exclude some auto-generated files from the automatic patch generation.
pt: A expressão regular perl especificada irá estender o valor predefinido usado por B<--diff-ignore> e o seu valor actual, se definido (desde dpkg 1.15.6). Faz isto ao concatenar “B<|>I<regex>” ao valor existente. Esta opção é conveniente de usar em B<debian/source/options> para excluir alguns ficheiros -auto-gerados da geração de patch automática.

note: type: textblock
en: If this option is specified, the pattern will be passed to L<tar(1)>'s B<--exclude> option when it is called to generate a .orig.tar or .tar file (B<--tar-ignore> since dpkg 1.15.6).  For example, B<-I>CVS will make tar skip over CVS directories when generating a .tar.gz file.  The option may be repeated multiple times to list multiple patterns to exclude.
pt: Se esta opção for especificada, o padrão será passado à opção B<--exclude> do L<tar(1)> quando este é chamado para gerar um ficheiro .orig.tar ou .tar (B<--tar-ignore> desde dpkg 1.15.6). Por exemplo, B<-I>CVS irá fazer o tar saltar os directórios CVS ao gerar um ficheiro .tar.gz. A opção pode ser repetida várias vezes para listar vários padrões de exclusão.

note: type: textblock
en: B<-I> by itself adds default B<--exclude> options that will filter out control files and directories of the most common revision control systems, backup and swap files and Libtool build output directories.
pt: B<-I> por si próprio adiciona opções B<--exclude> predefinidas que irão filtrar ficheiros de controle e directórios dos sistemas de controlo de revisão mais comuns, ol systems, salvaguarda e permutar ficheiros e directórios de saída de compilação de Libtool.

note: type: textblock
en: B<Note>: While they have similar purposes, B<-i> and B<-I> have very different syntax and semantics.  B<-i> can only be specified once and takes a perl compatible regular expression which is matched against the full relative path of each file.  B<-I> can specified multiple times and takes a filename pattern with shell wildcards.  The pattern is applied to the full relative path but also to each part of the path individually.  The exact semantic of tar's B<--exclude> option is somewhat complicated, see L<https://www.gnu.org/software/tar/manual/tar.html#wildcards> for a full documentation.
pt: B<Nota>: Apesar de terem objectivos semelhantes, B<-i> e B<-I> têm muitas diferenças na sintaxe e semântica. B<-i> só pode ser especificado uma vez e e recebe uma expressão regular compatível com perl que é correspondida ao caminho relativo completo de cada ficheiro. B<-I> pode se especificado várias vezes e recebe um padrão de nome de ficheiro com wildcards de shell. O padrão é aplicado ao caminho relativo completo mas também a cada parte do caminho individualmente. A semântica exacta da opção B<--exclude> do tar é um tanto complicada, veja L<https://www.gnu.org/software/tar/manual/tar.html#wildcards> para a documentação completa.

note: type: textblock
en: The default regex and patterns for both options can be seen in the output of the B<--help> command.
pt: A regex e padrões predefinidos para ambas opções podem ser vistos no resultado do comando B<--help>.

note: type: =head2
en: Generic extract options
pt: Opções de extração genéricas

note: type: textblock
en: Do not copy original tarballs near the extracted source package (since dpkg 1.14.17).
pt: Não copia os tarballs originais perto do pacote fonte extraído (desde dpkg 1.14.17).

note: type: textblock
en: Do not check signatures and checksums before unpacking (since dpkg 1.14.17).
pt: Não verifica assinaturas nem sumários de verificação antes de desempacotar desde dpkg 1.14.17).

note: type: textblock
en: Do not overwrite the extraction directory if it already exists (since dpkg 1.18.8).
pt: Não sobrepõe o directório de extração se este já existir (desde dpkg 1.18.8).

note: type: textblock
en: Refuse to unpack the source package if it doesn't contain an OpenPGP signature that can be verified (since dpkg 1.15.0) either with the user's I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg>, I</usr/share/keyrings/debian-nonupload.gpg> and I</usr/share/keyrings/debian-maintainers.gpg>).
pt: Recusa-se a desempacotar um pacote fonte se este não conter uma assinatura OpenPGP que possa ser verificada (desde dpkg 1.15.0) seja com o chaveiro I<trustedkeys.gpg> do utilizador, com um chaveiro específico do fornecedor, ou um dos chaveiros oficiais Debian (I</usr/share/keyrings/debian-keyring.gpg>, I</usr/share/keyrings/debian-nonupload.gpg> e I</usr/share/keyrings/debian-maintainers.gpg>).

note: type: textblock
en: Refuse to unpack the source package if it does not contain any strong checksums (since dpkg 1.18.7).  Currently the only known checksum considered strong is B<SHA-256>.
pt: Recusa-se a desempacotar p pacote fonte se este não conter nenhuns checksums fortes (desde 1.18.7). Actualmente o único checksum conhecido considerado forte é B<SHA-256>.

note: type: textblock
en: Turns the bad source package version check into a non-fatal warning (since dpkg 1.17.7).  This option should only be necessary when extracting ancient source packages with broken versions, just for backwards compatibility.
pt: Torna a verificação de versão má de pacote fonte num aviso não-fatal (desde dpkg 1.17.7). Esta opção só deve ser necessária quando se extrai pacotes fonte anciãos com versões quebradas, apenas para compatibilidade com versões antigas.

note: type: =head2
en: Generic general options
pt: Opções gerais genéricas

note: type: textblock
en: Sets the maximum number of threads allowed for compressors that support multi-threaded operations (since dpkg 1.21.14).
pt: Define o número máximo de tópicos permitidos para compressores que suportam operações multi-tópico (desde dpkg 1.21.14).

note: type: textblock
en: Sets quiet mode to suppress warnings.
pt: Define o modo silencioso para suprimir avisos.

note: type: =head1
en: SOURCE PACKAGE FORMATS
pt: FORMATOS DE PACOTE FONTE

note: type: textblock
en: If you don't know what source format to use, you should probably pick either “3.0 (quilt)” or “3.0 (native)”.  See L<https://wiki.debian.org/Projects/DebSrc3.0> for information on the deployment of those formats within Debian.
pt: Se você não sabe que formato de fonte usar, deve provavelmente escolher entre “3.0 (quilt)” ou “3.0 (native)”.  Veja L<https://wiki.debian.org/Projects/DebSrc3.0> para informação sobre o desenvolvimento desses formatos em Debian.

note: type: =head2
en: Format: 1.0
pt: Formato: 1.0

note: type: textblock
en: A source package in this format consists either of a B<.orig.tar.gz> associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package is said to be I<native>).  Optionally the original tarball might be accompanied by a detached upstream signature B<.orig.tar.gz.asc>, extraction supported since dpkg 1.18.5.
pt: Um pacote fonte neste formato consiste ou de um B<.orig.tar.gz> associado a um B<.diff.gz> ou de um único B<.tar.gz> (nesse caso diz-se que o pacote é I<nativo>). Opcionalmente o tarball origina pode estar acompanhado de uma assinatura separada do autor B<.orig.tar.gz.asc>, extração suportada desde dpkg 1.18.5.

note: type: textblock
en: Extracting a native package is a simple extraction of the single tarball in the target directory.  Extracting a non-native package is done by first unpacking the B<.orig.tar.gz> and then applying the patch contained in the B<.diff.gz> file.  The timestamp of all patched files is reset to the extraction time of the source package (this avoids timestamp skews leading to problems when autogenerated files are patched).  The diff can create new files (the whole debian directory is created that way) but cannot remove files (empty files will be left over) and cannot create or change symlinks.
pt: Extrair um pacote nativo é uma simples extração do único tarball no directório alvo. Extrair um pacote não-nativo é feito ao primeiro desempacotar o B<.orig.tar.gz> e depois aplicar a patch contida no ficheiro B<.diff.gz>. O carimbo temporal de todos os ficheiros que receberam patch é reposto à hora de extração do pacote fonte (isto evita confusões com carimbos temporais que levam a problemas quando se aplicam patch a ficheiros auto-gerados). O diff pode criar novos ficheiros (todo o directório debian é criado deste modo) mas não pode remover ficheiros (ficheiros vazios serão deixados) e não pode criar ou modificar links simbólicos.

note: type: textblock
en: Building a native package is just creating a single tarball with the source directory.  Building a non-native package involves extracting the original tarball in a separate “.orig” directory and regenerating the B<.diff.gz> by comparing the source package I<directory> with the .orig directory.
pt: Compilar um pacote nativo é apenas criar um único tarball com o directório fonte. Compilar um pacote não-nativo involve extrair o tarball original num directório “.orig” separado e regenerar o B<.diff.gz> ao comparar o I<directory> do pacote fonte com o directório .orig.

note: type: textblock
en: If a second non-option argument is supplied it should be the name of the original source directory or tarfile or the empty string if the package is a Debian-specific one and so has no debianization diffs.  If no second argument is supplied then B<dpkg-source> will look for the original source tarfile I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source directory I<directory>B<.orig> depending on the B<-sX> arguments.
pt: Se um segundo argumento não-opção for fornecido este deve ser o nome do directório fonte original ou ficheiro tar ou uma string vazia se o pacote é um específico de Debian, e assim não tem diffs de debianização. Se não for fornecido um segundo argumento, então B<dpkg-source> irá procurar o ficheiro tar fonte original I<package>B<_>I<upstream-version>B<.orig.tar.gz> ou o directório fonte original I<directory>B<.orig> dependendo dos argumentos B<-sX>.

note: type: textblock
en: B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing tarfiles or directories.  If this is desired then B<-sA>, B<-sP>, B<-sK>, B<-sU> and B<-sR> should be used instead.
pt: B<-sa>, B<-sp>, B<-sk>, B<-su> e B<-sr> não irão sobrescrever ficheiros tar ou directórios existentes. Se isto for desejado então devem antes ser usados B<-sA>, B<-sP>, B<-sK>, B<-sU> e B<-sR>.

note: type: textblock
en: Specifies to expect the original source as a tarfile, by default I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>.  It will leave this original source in place as a tarfile, or copy it to the current directory if it isn't already there.  The tarball will be unpacked into I<directory>B<.orig> for the generation of the diff.
pt: Especifica que se espera a fonte original como um ficheiro tar, por predefinição I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>.  irá deixar a fonte original no lugar como um ficheiro tar, ou irá copia-la para o directório actual se não estiver já lá. O tarball será desempacotado em I<directory>B<.orig> para a geração do diff.

note: type: textblock
en: Like B<-sk> but will remove the directory again afterwards.
pt: Tal como B<-sk> mas irá remover o directório outra vez depois.

note: type: textblock
en: Specifies that the original source is expected as a directory, by default I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a new original source archive from it.
pt: Especifica que a fonte original é esperada como um directório, por predefinição I<pacote>B<->I<versão-do-autor>B<.orig> e B<dpkg-source> irá criar um novo arquivo de fonte original a partir dele.

note: type: textblock
en: Like B<-su> but will remove that directory after it has been used.
pt: Como B<-su> mas irá remover esse directório após ter sido usado.

note: type: textblock
en: Specifies that the original source is available both as a directory and as a tarfile.  B<dpkg-source> will use the directory to create the diff, but the tarfile to create the B<.dsc>.  This option must be used with care - if the directory and tarfile do not match a bad source archive will be generated.
pt: Especifica que a fonte original está disponível tanto como directório e como um ficheiro tar. B<dpkg-source> irá usar o directório para criar o diff, mas o ficheiro tar para criar o B<.dsc>.  Esta opção tem de ser usada com cuidado, Se o directório e o ficheiro tar não corresponderem, será gerado um arquivo de má fonte.

note: type: textblock
en: Specifies to not look for any original source, and to not generate a diff.  The second argument, if supplied, must be the empty string.  This is used for Debian-specific packages which do not have a separate upstream source and therefore have no debianization diffs.
pt: Especifica para não procurar por nenhuma fonte original, e não gerar um diff. O segundo argumento, se fornecido, deve ser a string vazia. Isto é usado para pacotes específicos-Debian que não têm uma fonte de autor separada e por isso não têm diffs de debianização.

note: type: =item
en: B<-sa> or B<-sA>
pt: B<-sa> ou B<-sA>

note: type: textblock
en: Specifies to look for the original source archive as a tarfile or as a directory - the second argument, if any, may be either, or the empty string (this is equivalent to using B<-sn>).  If a tarfile is found it will unpack it to create the diff and remove it afterwards (this is equivalent to B<-sp>); if a directory is found it will pack it to create the original source and remove it afterwards (this is equivalent to B<-sr>); if neither is found it will assume that the package has no debianization diffs, only a straightforward source archive (this is equivalent to B<-sn>).  If both are found then B<dpkg-source> will ignore the directory, overwriting it, if B<-sA> was specified (this is equivalent to B<-sP>)  or raise an error if B<-sa> was specified.  B<-sa> is the default.
pt: Especifica para procurar pelo arquivo fonte original como um ficheiro tar ou como um directório - o segundo argumento, se existir, pode ser um de, ou a string vazia (isto é equivalente a usar <-sn>). Se for encontrado um ficheiro tar irá desempacota-lo para criar o diff e remove-lo depois (isto é equivalente a B<-sp>); Se for encontrado um directório irá empacota-lo para criar a fonte original e remove-lo depois (isto é o equivalente a B<-sr>); Se nenhum for encontrado irá assumir que o pacote não tem diffs de debianização, é apenas um arquivo fonte directo (isto é o equivalente a B<-sn>). Se ambos forem encontrados então o B<dpkg-source> irá ignorar o directório, sobrescrevendo-o, se for especificado B<-sA> (isto é o equivalente a B<-sP>)  ou elevar um erro se for especificado B<-sa>. B<-sa> é a predefinição.

note: type: textblock
en: The process fails if the generated diff contains changes to files outside of the debian sub-directory (since dpkg 1.15.8).  This option is not allowed in B<debian/source/options> but can be used in B<debian/source/local-options>.
pt: O processo falha se o diff gerado conter diferenças de ficheiros fora do sub-directório debian (desde dpkg 1.15.8). Esta opção não é permitida em B<debian/source/options> mas pode ser usada em B<debian/source/local-options>.

note: type: textblock
en: B<Extract options (with --extract):>
pt: B<Opções de extração (com --extract):>

note: type: textblock
en: In all cases any existing original source tree will be removed.
pt: Em todos os casos qualquer árvore de fonte original existente será removida.

note: type: textblock
en: Used when extracting then the original source (if any) will be left as a tarfile.  If it is not already located in the current directory or if an existing but different file is there it will be copied there.  (B<This is the default>).
pt: Usado ao extrair depois a fonte original (se alguma) será deixada como um ficheiro tar. Se não estiver já localizada no directório actual ou se um ficheiro existente mas diferente estiver lá será copiado para lá. (B<Isto é a predefinição>).

note: type: textblock
en: Unpacks the original source tree.
pt: Desempacota a árvore fonte original.

note: type: textblock
en: Ensures that the original source is neither copied to the current directory nor unpacked.  Any original source tree that was in the current directory is still removed.
pt: Assegura que a árvore original nem é copiada para o directório actual nem desempacotada. Qualquer árvore de fonte original que esteja no directório actual é ainda removida.

note: type: textblock
en: All the B<-s>I<X> options are mutually exclusive.  If you specify more than one only the last one will be used.
pt: Todas as opções B<-s>I<X> são mutuamente exclusivas. Se você especificar mais do que uma, apenas será usada a última.

note: type: textblock
en: Skips application of the debian diff on top of the upstream sources (since dpkg 1.15.1).
pt: Salta a aplicação do diff debian no topo das fontes do autor (desde dpkg 1.15.1).

note: type: =head2
en: Format: 2.0
pt: Formato: 2.0

note: type: textblock
en: Extraction supported since dpkg 1.13.9, building supported since dpkg 1.14.8.  Also known as wig&pen.  This format is not recommended for wide-spread usage, the format “3.0 (quilt)” replaces it.  Wig&pen was the first specification of a new-generation source package format.
pt: Extração suportada desde dpkg 1.13.9, compilação suportada desde dpkg 1.14.8. Também conhecido como wig&pen. Este formato não é recomendado para utilização em massa, o formato "3.0 (quilt)" substitui este. Wig&pen foi a primeira especificação de um formato de pacote fonte da nova geração.

note: type: textblock
en: The behavior of this format is the same as the “3.0 (quilt)” format except that it doesn't use an explicit list of patches.  All files in B<debian/patches/> matching the perl regular expression B<[\w-]+> must be valid patches: they are applied at extraction time.
pt: O comportamento deste formato é o mesmo que o do formato "3.0 (quilt)" com a excepção de que não usa uma lista de patches explicita. Todos os ficheiros em B<debian/patches/> que correspondem à expressão regular perl B<[\w-]+> têm de ser patches válidas: elas são aplicadas durante a extração.

note: type: textblock
en: When building a new source package, any change to the upstream source is stored in a patch named B<zz_debian-diff-auto>.
pt: Quando se constrói um novo pacote fonte, qualquer alteração na fonte do autor é armazenada numa patch chamada B<zz_debian-diff-auto>.

note: type: =head2
en: Format: 3.0 (native)
pt: Formato: 3.0 (nativo)

note: type: textblock
en: Supported since dpkg 1.14.17.  This format is an extension of the native package format as defined in the 1.0 format.  It supports all compression methods and will ignore by default any VCS specific files and directories as well as many temporary files (see default value associated to B<-I> option in the B<--help> output).
pt: Suportado desde dpkg 1.14.17. Este formato é uma extensão do formato de pacote nativo como definido no formato 1.0. Suporta todos os métodos de compressão e irá ignorar por predefinição quaisquer ficheiros específicos de VCS e directórios também assim como muitos ficheiros temporários (veja valor predefinido associado à opção B<-I> no resultado de B<--help>).

note: type: =head2
en: Format: 3.0 (quilt)
pt: Formato: 3.0 (quilt)

note: type: textblock
en: Supported since dpkg 1.14.17.  A source package in this format contains at least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>).  It can also contain additional original tarballs (B<.orig->I<component>B<.tar.>I<ext>).  I<component> can only contain alphanumeric (‘a-zA-Z0-9’) characters and hyphens (‘-’).  Optionally each original tarball can be accompanied by a detached upstream signature (B<.orig.tar.>I<ext>B<.asc> and B<.orig->I<component>B<.tar.>I<ext>B<.asc>), extraction supported since dpkg 1.17.20, building supported since dpkg 1.18.5.
pt: Suportado desde dpkg 1.14.17.  Um pacote fonte neste formato contém pelo menos um tarball original (B<.orig.tar.>I<ext> onde I<ext> pode ser B<gz>, B<bz2>, B<lzma> e B<xz>) e um tarball debian (B<.debian.tar.>I<ext>). Também pode conter tarballs originais adicionais (B<.orig->I<component>B<.tar.>I<ext>).  I<component> pode apenas conter caracteres alfanuméricos (‘a-zA-Z0-9’) e hífens (‘-’). Opcionalmente cada tarball original pode ser acompanhado por uma assinatura em separado do autor (B<.orig.tar.>I<ext>B<.asc> e B<.orig->I<component>B<.tar.>I<ext>B<.asc>), extração suportada desde dpkg 1.17.20, compilação suportada desde dpkg 1.18.5.

note: type: textblock
en: The main original tarball is extracted first, then all additional original tarballs are extracted in subdirectories named after the I<component> part of their filename (any pre-existing directory is replaced).  The debian tarball is extracted on top of the source directory after prior removal of any pre-existing B<debian> directory.  Note that the debian tarball must contain a B<debian> sub-directory but it can also contain binary files outside of that directory (see B<--include-binaries> option).
pt: O tarball original principal é extraído primeiro, depois todos os tarballs originais adicionais são extraídos em sub-directórios nomeados após a parte I<component> do seu nome de ficheiro (qualquer directório pré-existente é substituído). O tarball debian é extraído no topo do directório fonte após a pré remoção de qualquer directório B<debian> pré-existente mas pode também conter ficheiros binários fora desse directório (veja a opção B<--include-binaries>).

note: type: textblock
en: All patches listed in B<debian/patches/>I<vendor>B<.series> or B<debian/patches/series> are then applied, where I<vendor> will be the lowercase name of the current vendor, or B<debian> if there is no vendor defined.  If the former file is used and the latter one doesn't exist (or is a symlink), then the latter is replaced with a symlink to the former.  This is meant to simplify usage of B<quilt> to manage the set of patches.  Vendor-specific series files are intended to make it possible to serialize multiple development branches based on the vendor, in a declarative way, in preference to open-coding this handling in B<debian/rules>.  This is particularly useful when the source would need to be patched conditionally because the affected files do not have built-in conditional occlusion support.  Note however that while B<dpkg-source> parses correctly series files with explicit options used for patch application (stored on each line after the patch filename and one or more spaces), it does ignore those options and always expects patches that can be applied with the B<-p1> option of B<patch>.  It will thus emit a warning when it encounters such options, and the build is likely to fail.
pt: Todas as patches listadas em B<debian/patches/>I<vendor>B<.series> ou B<debian/patches/series> são então aplicadas, onde I<vendor> será o nome em minúsculas do fornecedor actual, ou B<debian> se não existir um fornecedor definido. Se o ficheiro anterior for usado e o posterior não existir (ou for um link simbólico), então o posterior é substituído por um link simbólico para o antigo. Isto destina-se a simplificar a utilização de B<quilt> para gerir o conjunto de patches. Ficheiros de séries especificas-de-fornecedor destinam-se a tornar possível a criação de séries de múltiplos ramos de desenvolvimento baseados no fornecedor, num modo declarativo, dando preferência a codificação-aberta deste manuseamento em B<debian/rules>. Isto é particularmente útil quando a fonte precisa de receber uma patch condicionalmente porque os ficheiros afectados não possuem suporte a oclusão condicional embutido. Note no entanto que enquanto B<dpkg-source> analisa correctamente ficheiros de séries com opções explícitas usadas para aplicar patch a aplicação (armazenada em cada linha antes do nome de ficheiro de patch e um ou mais espaços), ele ignora essas opções e espera sempre que as patches possam ser aplicadas com a opção B<-p1> ou B<patch>. Irá portanto emitir um aviso quando encontra tais opções, e é provável que a compilação falhe.

note: type: textblock
en: Note that L<lintian(1)> will emit unconditional warnings when using vendor series due to a controversial Debian specific ruling, which should not affect any external usage; to silence these, the dpkg lintian profile can be used by passing «B<--profile dpkg>» to L<lintian(1)>.
pt: Note que L<lintian(1)> irá emitir avisos incondicionais quando usa séries de fornecedor devido a regulamento controverso específico de Debian, o qual não deve afectar nenhuma utilização externa; para silenciar isto, o perfil lintian do dpkg pode ser usado ao passar «B<--profile dpkg>» a L<lintian(1)>.

note: type: textblock
en: The timestamp of all patched files is reset to the extraction time of the source package (this avoids timestamp skews leading to problems when autogenerated files are patched).
pt: O carimbo temporal de todos os ficheiros com patch é reposto para a hora da extração do pacote fonte (isto evita inclinações do carimbo temporal que levam a problemas quando aplica patch a ficheiros auto-gerados).

note: type: textblock
en: Contrary to B<quilt>'s default behavior, patches are expected to apply without any fuzz.  When that is not the case, you should refresh such patches with B<quilt>, or B<dpkg-source> will error out while trying to apply them.
pt: Contrariamente ao comportamento predefinido de B<quilt>, espera-se que as patches sejam aplicadas sem confusões. Quando esse não é o caso, você deve refrescar tais patches com B<quilt>, ou B<dpkg-source> irá terminar em erro ao tentar aplica-las.

note: type: textblock
en: Similarly to B<quilt>'s default behavior, the patches can remove files too.
pt: Semelhante ao comportamento predefinido de B<quilt>. as patches também podem remover ficheiros.

note: type: textblock
en: The file B<.pc/applied-patches> is created if some patches have been applied during the extraction.
pt: O ficheiro B<.pc/applied-patches> é criado se algumas patches foram aplicadas durante a extração.

note: type: textblock
en: All original tarballs found in the current directory are extracted in a temporary directory by following the same logic as for the unpack, the debian directory is copied over in the temporary directory, and all patches except the automatic patch (B<debian-changes->I<version> or B<debian-changes>, depending on B<--single-debian-patch>) are applied.  The temporary directory is compared to the source package directory.  When the diff is non-empty, the build fails unless B<--single-debian-patch> or B<--auto-commit> has been used, in which case the diff is stored in the automatic patch.  If the automatic patch is created/deleted, it's added/removed from the series file and from the B<quilt> metadata.
pt: Todos os tarballs originais encontrados no directório actual são extraídos num directório temporário seguindo a mesma lógica que para o desempacotar, o directório debian é copiado sobre o directório temporário, e todas as são aplicadas, excepto a patch automática (B<debian-changes->I<version> ou B<debian-changes>, dependendo de B<--single-debian-patch>). O directório temporário é comparado com o directório do pacote fonte. Quando o diff é não-vazio, a compilação falha a menos que tenham sido usados B<--single-debian-patch> ou B<--auto-commit>, que neste caso o diff é guardado na patch automática. Se a patch automática for criada/apagada, é adicionada/removida do ficheiro de séries e dos meta-dados B<quilt>.

note: type: textblock
en: Any change on a binary file is not representable in a diff and will thus lead to a failure unless the maintainer deliberately decided to include that modified binary file in the debian tarball (by listing it in B<debian/source/include-binaries>).  The build will also fail if it finds binary files in the debian sub-directory unless they have been allowed through B<debian/source/include-binaries>.
pt: Qualquer alteração num ficheiro binário não é representável num diff e irá assim levar a uma falha a menos que o maintainer tenha decidido deliberadamente incluir esse ficheiro binário modificado no tarball debian (ao lista-lo em B<debian/source/include-binaries>). A compilação irá também falhar se encontrar ficheiros binários no sub-directório debian a menos que estes tenham sido autorizados através de B<debian/source/include-binaries>.

note: type: textblock
en: The updated debian directory and the list of modified binaries is then used to generate the debian tarball.
pt: O directório debian actualizado e a lista de binários modificados são então usados para gerar o tarball debian.

note: type: textblock
en: The automatically generated diff doesn't include changes on VCS specific files as well as many temporary files (see default value associated to B<-i> option in the B<--help> output).  In particular, the B<.pc> directory used by B<quilt> is ignored during generation of the automatic patch.
pt: O diff gerado automaticamente não inclui alterações em ficheiros específicos de VCS assim como em muitos ficheiro temporários (veja valor predefinido associado à opção B<-i> no resultado de B<--help>). Em particular, o directório B<.pc> usado por B<quilt> é ignorado durante a geração da patch automática.

note: type: textblock
en: B<Note>: B<dpkg-source> B<--before-build> (and B<--build>) will ensure that all patches listed in the series file are applied so that a package build always has all patches applied.  It does this by finding unapplied patches (they are listed in the B<series> file but not in B<.pc/applied-patches>), and if the first patch in that set can be applied without errors, it will apply them all.  The option B<--no-preparation> can be used to disable this behavior.
pt: B<Nota>: B<dpkg-source> B<--before-build> (e B<--build>) irão assegurar que todas as patches listadas no ficheiro series são aplicadas para que uma compilação do pacote tenha sempre todas as patches aplicadas. Faz isto ao encontrar patches não aplicadas (elas estão listadas no ficheiro B<series> mas não em B<.pc/applied-patches>), e se a primeira patch nesse conjunto puder ser aplicada sem erros, irá aplica-las todas. A opção B<--no-preparation> pode ser usada para desactivar este comportamento.

note: type: textblock
en: B<Recording changes>
pt: B<Gravar alterações>

note: type: textblock
en: Generates a patch corresponding to the local changes that are not managed by the B<quilt> patch system and integrates it in the patch system under the name I<patch-name>.  If the name is missing, it will be asked interactively.  If I<patch-file> is given, it is used as the patch corresponding to the local changes to integrate.  Once integrated, an editor (the first one found from B<sensible-editor>, C<$VISUAL>, C<$EDITOR>, B<vi>) is launched so that you can edit the meta-information in the patch header.
pt: Gera uma patch correspondente às alterações locais que não são geridas pelo sistema de patch B<quilt> e integra-a no sistema de patch sob o nome I<patch-name>. se o nome está em falta, será perguntado interactivamente. Se I<patch-file> for fornecido, é usado como uma patch correspondente às alterações locais a integrar. Uma vez integrada, é lançado um editor (o primeiro encontrado de B<sensible-editor>, C<$VISUAL>, C<$EDITOR>, B<vi>) para que você possa editar a meta-informação no cabeçalho da patch.

note: type: textblock
en: Passing I<patch-file> is mainly useful after a build failure that pre-generated this file, and on this ground the given file is removed after integration.  Note also that the changes contained in the patch file must already be applied on the tree and that the files modified by the patch must not have supplementary unrecorded changes.
pt: Passar I<patch-file> é principalmente útil após uma falha de compilação que pré-gerou este ficheiro, e por esse motivo o ficheiro fornecido é removido após integração. Note também que as alterações contidas no ficheiro patch têm de já estar aplicadas na árvore e que os ficheiros modificados pela patch não podem ter alterações suplementares por gravar.

note: type: textblock
en: If the patch generation detects modified binary files, they will be automatically added to B<debian/source/include-binaries> so that they end up in the debian tarball (exactly like B<dpkg-source --include-binaries --build> would do).
pt: Se a geração da patch detectar ficheiros binários modificados, eles serão adicionados automaticamente a B<debian/source/include-binaries> para que eles acabem no tarbal debian (exactamente como B<dpkg-source --include-binaries --build> faria).

note: type: textblock
en: B<Build options>
pt: B<Opções de compilação>

note: type: textblock
en: Allow B<dpkg-source> to build the source package if the version of the B<quilt> metadata is the one specified, even if B<dpkg-source> doesn't know about it (since dpkg 1.15.5.4).  Effectively this says that the given version of the B<quilt> metadata is compatible with the version 2 that B<dpkg-source> currently supports.  The version of the B<quilt> metadata is stored in B<.pc/.version>.
pt: Permite a B<dpkg-source> compilar o pacote fonte se a versão dos meta-dados B<quilt> for uma especificada, mesmo se B<dpkg-source> não souber disso (desde dpkg 1.15.5.4).  Efectivamente isto diz que a versão dada dos meta-dados B<quilt> é compatível com a versão 2 que o B<dpkg-source> presentemente suporta. A versão dos meta-dados B<quilt> é guardada em B<.pc/.version>.

note: type: textblock
en: Do not ignore removed files and include them in the automatically generated patch.
pt: Não ignora os ficheiros removidos e inclui-os na patch gerada automaticamente.

note: type: textblock
en: Include timestamp in the automatically generated patch.
pt: Inclui o carimbo data/hora na patch gerada automaticamente.

note: type: textblock
en: Add all modified binaries in the debian tarball.  Also add them to B<debian/source/include-binaries>: they will be added by default in subsequent builds and this option is thus no more needed.
pt: Adiciona todos os binários modificados ao tarball debian. Também os adiciona a B<debian/source/include-binaries>: eles serão adicionados por predefinição em compilações subsequentes e esta opção é assim não mais necessária.

note: type: textblock
en: Do not try to prepare the build tree by applying patches which are apparently unapplied (since dpkg 1.14.18).
pt: Não tenta preparar a árvore de compilação ao não aplicar as patches que aparentemente ainda não foram aplicadas (desde dpkg 1.14.18).

note: type: textblock
en: Use B<debian/patches/debian-changes> instead of B<debian/patches/debian-changes->I<version> for the name of the automatic patch generated during build (since dpkg 1.15.5.4).  This option is particularly useful when the package is maintained in a VCS and a patch set can't reliably be generated.  Instead the current diff with upstream should be stored in a single patch.  The option would be put in B<debian/source/local-options> and would be accompanied by a B<debian/source/local-patch-header> file explaining how the Debian changes can be best reviewed, for example in the VCS that is used.
pt: Usa B<debian/patches/debian-changes> em vez de B<debian/patches/debian-changes->I<version> para o nome da patch automática gerada durante a compilação (desde dpkg 1.15.5.4). Esta opção é particularmente útil quando o pacote é mantido num VCS e um conjunto de patch não pode ser gerado com confiança. Em vez disso o diff actual com o original deve ser guardado numa patch única. A opção seria posta em B<debian/source/local-options> e deveria ser acompanhada por um ficheiro B<debian/source/local-patch-header> explicando como as alterações Debian poderão ser melhor revistas, por exemplo no VCS que é usado.

note: type: textblock
en: Automatically create the main original tarball as empty if it's missing and if there are supplementary original tarballs (since dpkg 1.15.6).  This option is meant to be used when the source package is just a bundle of multiple upstream software and where there's no “main” software.
pt: Cria automaticamente o principal tarball original como vazio se está em falta e se existirem tarballs suplementares originais (desde dpkg 1.15.6). Esta opção destina-se a ser usada quando o pacote fonte é apenas um bolo de múltiplos softwares originais e não há nenhum software “main”.

note: type: textblock
en: By default, B<dpkg-source> will automatically unapply the patches in the B<--after-build> hook if it did apply them during B<--before-build> (B<--unapply-patches> since dpkg 1.15.8, B<--no-unapply-patches> since dpkg 1.16.5).  Those options allow you to forcefully disable or enable the patch unapplication process.  Those options are only allowed in B<debian/source/local-options> so that all generated source packages have the same behavior by default.
pt: Por predefinição, B<dpkg-source> irá automaticamente desfazer a aplicação das patches no hook B<--after-build> se ele as aplicou durante B<--before-build> (B<--unapply-patches> desde dpkg 1.15.8, B<--no-unapply-patches> desde dpkg 1.16.5). Essas opções permitem-lhe desactivar ou activar à força o processo de desaplicação da patch. Essas opções são apenas permitidas em B<debian/source/local-options> para que todos os pacotes fonte gerados tenham o mesmo comportamento por predefinição.

note: type: textblock
en: The process fails if an automatic patch has been generated (since dpkg 1.15.8).  This option can be used to ensure that all changes were properly recorded in separate B<quilt> patches prior to the source package build.  This option is not allowed in B<debian/source/options> but can be used in B<debian/source/local-options>.
pt: O processo falha se uma patch automática foi gerada (desde dpkg 1.15.8). Esta opção pode ser usada para assegurar que todas as alterações foram gravadas apropriadamente em patches B<quilt> separadas antes da compilação do pacote fonte. Esta opção não é permitida em B<debian/source/options> mas pode ser usada em B<debian/source/local-options>.

note: type: textblock
en: The process doesn't fail if an automatic patch has been generated, instead it's immediately recorded in the B<quilt> series.
pt: O processo não falha se foi gerada uma patch automática, em vez disso, é imediatamente gravado nas séries B<quilt>.

note: type: textblock
en: B<Extract options>
pt: B<Opções de extração>

note: type: textblock
en: Skips extraction of the debian tarball on top of the upstream sources (since dpkg 1.15.1).
pt: Salta a extração do tarball debian por cima da fonte do autor (desde dpkg 1.15.1).

note: type: textblock
en: Do not apply patches at the end of the extraction (since dpkg 1.14.18).
pt: Não aplica as patches no final da extração (desde dpkg 1.14.18).

note: type: =head2
en: Format: 3.0 (custom)
pt: Formato: 3.0 (personalizado)

note: type: textblock
en: Supported since dpkg 1.14.17.  This format is special.  It doesn't represent a real source package format but can be used to create source packages with arbitrary files.
pt: Suportado desde dpkg 1.14.17. Este formato é especial. Não representa o formato real  do pacote fonte mas pode ser usado para criar pacotes fonte com ficheiros arbitrários.

note: type: textblock
en: All non-option arguments are taken as files to integrate in the generated source package.  They must exist and are preferably in the current directory.  At least one file must be given.
pt: Todos os argumentos não-opção são tomados como ficheiros para integrar no pacote fonte gerado. Estes têm de existir e estão preferencialmente no directório actual. Pelo menos um ficheiro tem de ser fornecido.

note: type: textblock
en: B<Required>.  Defines the real format of the generated source package.  The generated .dsc file will contain this value in its B<Format> field and not “3.0 (custom)”.
pt: B<Requerido>. Define o formato real do pacote fonte gerado. O ficheiro .dsc gerado irá conter este valor no seu campo B<Format> e não “3.0 (custom)”.

note: type: =head2
en: Format: 3.0 (git)
pt: Formato: 3.0 (git)

note: type: textblock
en: Supported since dpkg 1.14.17.  This format is experimental.
pt: Suportado desde dpkg 1.14.17. Este formato é experimental.

note: type: textblock
en: A source package in this format consists of a single bundle of a git repository B<.git> to hold the source of a package.  There may also be a B<.gitshallow> file listing revisions for a shallow git clone.
pt: Um pacote fonte neste formato consiste de um único bolo de repositório git B<.git> para manter a fonte de um pacote. Também pode existir um ficheiro B<.gitshallow> listando revisões para um clone git shallow.

note: type: textblock
en: The bundle is cloned as a git repository to the target directory.  If there is a gitshallow file, it is installed as I<.git/shallow> inside the cloned git repository.
pt: O bolo é clonado como um repositório git para o directório alvo. Se existir um ficheiro gitshallow, é instalado como I<.git/shallow> dentro do repositório git clonado.

note: type: textblock
en: Note that by default the new repository will have the same branch checked out that was checked out in the original source.  (Typically “main”, but it could be anything.)  Any other branches will be available under I<remotes/origin/>.
pt: Note que por predefinição o novo repositório irá ter o mesmo ramo "checked out" como era "checked out" na fonte original. (Tipicamente “main”, mas pode ser qualquer coisa.) Quaisquer outros ramos irão estar disponíveis sob I<remotes/origin/>.

note: type: textblock
en: Before going any further, some checks are done to ensure that we don't have any non-ignored uncommitted changes.
pt: Antes de avançar-mos, são feitas algumas verificações para assegurar que não temos nenhumas alterações não ignoradas por submeter.

note: type: textblock
en: L<git-bundle(1)> is used to generate a bundle of the git repository.  By default, all branches and tags in the repository are included in the bundle.
pt: L<git-bundle(1)> é usado para gerar um bolo do repositório git. Por predefinição, todos os ramos e etiquetas no repositório são incluídos no bolo.

note: type: textblock
en: Allows specifying a git ref to include in the git bundle.  Use disables the default behavior of including all branches and tags.  May be specified multiple times.  The I<ref> can be the name of a branch or tag to include.  It may also be any parameter that can be passed to L<git-rev-list(1)>.  For example, to include only the main branch, use B<--git-ref=>main.  To include all tags and branches, except for the private branch, use B<--git-ref=>--all B<--git-ref=>^private
pt: Permite especificar um ref de git para incluir no bolo do git. O uso desactiva o comportamento predefinido de incluir todos os ramos e etiquetas. Pode ser especificado várias vezes. O I<ref> pode ser o nome de um ramo ou etiqueta a incluir. Também pode ser qualquer parâmetro que possa ser passado ao L<git-rev-list(1)>. Por exemplo, para incluir apenas o ramo main, use B<--git-ref=>main. Para incluir todos as etiquetas e ramos, excepto para o ramo privado, use B<--git-ref=>--all B<--git-ref=>^private

note: type: textblock
en: Creates a shallow clone with a history truncated to the specified number of revisions.
pt: Cria um clone sombra com o histórico truncado ao número específico de revisões.

note: type: =head2
en: Format: 3.0 (bzr)
pt: Formato: 3.0 (bzr)

note: type: textblock
en: Supported since dpkg 1.14.17.  This format is experimental.  It generates a single tarball containing the bzr repository.
pt: Suportado desde dpkg 1.14.17. Este formato é experimental. Gera um único tarball que contem o repositório bzr.

note: type: textblock
en: The tarball is unpacked and then bzr is used to checkout the current branch.
pt: O tarball é desempacotado e depois é usado o bzr para fazer "checkout" ao ramo actual.

note: type: textblock
en: Then the VCS specific part of the source directory is copied over to a temporary directory.  Before this temporary directory is packed in a tarball, various cleanup are done to save space.
pt: Depois a parte específica de VCS do directório fonte é copiada para um directório temporário. Antes deste directório temporário ser empacotado num tarball, são feitas várias limpezas para libertar espaço.

note: type: =head2
en: no source format specified in debian/source/format
pt: nenhum formato fonte especificado em debian/source/format

note: type: textblock
en: The file B<debian/source/format> should always exist and indicate the desired source format.  For backwards compatibility, format “1.0” is assumed when the file doesn't exist but you should not rely on this: at some point in the future B<dpkg-source> will be modified to fail when that file doesn't exist.
pt: O ficheiro B<debian/source/format> deve sempre existir e indicar o formato de fonte desejado. Para compatibilidade com software anterior, o  formato “1.0” é assumido quando o ficheiro não existe mas você não deve confiar nisto: algures no futuro, B<dpkg-source> será modificado para falhar quando esse ficheiro não existe.

note: type: textblock
en: The rationale is that format “1.0” is no longer the recommended format, you should usually pick one of the newer formats (“3.0 (quilt)”, “3.0 (native)”) but B<dpkg-source> will not do this automatically for you.  If you want to continue using the old format, you should be explicit about it and put “1.0” in B<debian/source/format>.
pt: A lógica é que o formato “1.0”não é mais o formato recomendado, você deve geralmente escolher um dos formatos mais recentes (“3.0 (quilt)”, “3.0 (native)”) mas o B<dpkg-source> não vai fazer isto automaticamente por si. Se você deseja continuar a usar o formato antigo, você deve ser explícito acerca disso a colocar "1.0” em B<debian/source/format>.

note: type: =head2
en: the diff modifies the following upstream files
pt: o diff modifica os seguintes ficheiros do autor

note: type: textblock
en: When using source format “1.0” it is usually a bad idea to modify upstream files directly as the changes end up hidden and mostly undocumented in the .diff.gz file.  Instead you should store your changes as patches in the debian directory and apply them at build-time.  To avoid this complexity you can also use the format “3.0 (quilt)” that offers this natively.
pt: Quando se usar o formato de fonte “1.0” é geralmente uma má ideia modificar ficheiros do autor directamente pois as alterações acabam escondidas e maioritariamente não documentadas no ficheiro .diff.gz. Em vez disso você deve guardar as suas alterações em patches no directório debian e aplica-las durante a compilação. Para evitar esta complexidade você pode também usar o formato "3.0 (quilt)” que oferece isto nativamente.

note: type: =head2
en: cannot represent change to I<file>
pt: não pode representar alteração no I<ficheiro>

note: type: textblock
en: Changes to upstream sources are usually stored with patch files, but not all changes can be represented with patches: they can only alter the content of plain text files.  If you try replacing a file with something of a different type (for example replacing a plain file with a symlink or a directory), you will get this error message.
pt: As alterações às fontes originais são geralmente guardadas com ficheiros patch, mas nem todas as alterações podem ser representadas com patches: elas apenas podem alterar o conteúdo de ficheiros de texto simples. Se você tentar substituir um ficheiro por algo de diferente tipo (por exemplo, substituir um ficheiro simples por um link simbólico ou directório), você vai receber esta mensagem  de erro.

note: type: =head2
en: newly created empty file I<file> will not be represented in diff
pt: o ficheiro I<ficheiro> vazio acabado de criar não será representado no diff.

note: type: textblock
en: Empty files can't be created with patch files.  Thus this change is not recorded in the source package and you are warned about it.
pt: Ficheiros vazios não podem ser criados com ficheiros patch. Assim esta alteração não é gravada no pacote fonte e você é avisado acerca disso.

note: type: =head2
en: executable mode I<perms> of I<file> will not be represented in diff
pt: I<perms> de modo executável do I<ficheiro> não serão representados no diff

note: type: textblock
en: Patch files do not record permissions of files and thus executable permissions are not stored in the source package.  This warning reminds you of that fact.
pt: Os ficheiros patch não gravam permissões dos ficheiro e assim as permissões de executável não são guardadas no pacote fonte. Este aviso lembra-o desse facto.

note: type: =head2
en: special mode I<perms> of I<file> will not be represented in diff
pt: I<perms> de modo especial do I<ficheiro> não serão representados no diff

note: type: textblock
en: Patch files do not record permissions of files and thus modified permissions are not stored in the source package.  This warning reminds you of that fact.
pt: Os ficheiros patch não gravam permissões dos ficheiro e assim as permissões modificadas não são guardadas no pacote fonte. Este aviso lembra-o desse facto.

note: type: textblock
en: If set, it will be used as the timestamp (as seconds since the epoch) to clamp the mtime in the L<tar(5)> file entries.
pt: Se definido, será usado como marca temporal (em segundos desde a época) para engatar o mtime nas entradas do ficheiro L<tar(5)>.

note: type: textblock
en: Used by the “2.0” and “3.0 (quilt)” source format modules.
pt: Usado pelos módulos de formato de fonte “2.0” e “3.0 (quilt)”.

note: type: textblock
en: Used by the “3.0 (git)” source format modules.
pt: Usado pelos módulos de formato de fonte “3.0 (git)”.

note: type: textblock
en: This file contains on a single line the format that should be used to build the source package (possible formats are described above).  No leading or trailing spaces are allowed.
pt: Este ficheiro contém numa linha única o formato que deve ser usado para compilar o pacote fonte (os formatos possíveis estão descritos acima). Não são permitidos espaços a anteceder ou a preceder.

note: type: textblock
en: This file contains a list of pathnames of binary files (one per line) relative to the source root directory that should be included in the debian tarball.  Leading and trailing spaces are stripped.  Lines starting with ‘B<#>’ are comments and are skipped.  Empty lines are ignored.
pt: Este ficheiro contém uma lista nomes de caminhos de ficheiros binários (um por cada linha) relativos ao directório raiz da fonte que devem ser incluídos no tarball de debian. Os espaços que antecedem e precedem são removidos. As linhas que começam com ‘B<#>’ são comentários e são saltadas. Linhas vazias são ignoradas.

note: type: textblock
en: This file contains a list of long options that should be automatically prepended to the set of command line options of a B<dpkg-source --build> or B<dpkg-source --print-format> call.  Options like B<--compression> and B<--compression-level> are well suited for this file.
pt: Este ficheiro contem uma lista de opções longas que devem ser automaticamente anexadas ao conjunto de opções de linha de comandos de uma chamada B<dpkg-source --build> ou B<dpkg-source --print-format>. Opções como B<--compression> e B<--compression-level> são bem apropriadas para este ficheiro.

note: type: textblock
en: Each option should be put on a separate line.  Empty lines and lines starting with ‘B<#>’ are ignored.  The leading ‘B<-->’ should be stripped and short options are not allowed.  Optional spaces are allowed around the ‘B<=>’ symbol and optional quotes are allowed around the value.  Here's an example of such a file:
pt: Cada opção deve ser posta numa linha separada. AS linhas vazias e linhas começadas com ‘B<#>’ são ignoradas.  O ‘B<-->’ inicial deve ser cortado e as opções curtas não são permitidas. São permitidos espaços opcionais a contornar o símbolo 'B<=>’ e são permitidas citações opcionais a envolver o valor. Aqui está um exemplo de tal ficheiro:

note: type: textblock
en: B<Note>: B<format> options are not accepted in this file, you should use B<debian/source/format> instead.
pt: B<Nota>: As opções B<format> não são aceites neste ficheiro, em vez disso você deve usar B<debian/source/format>.

note: type: textblock
en: Exactly like B<debian/source/options> except that the file is not included in the generated source package.  It can be useful to store a preference tied to the maintainer or to the VCS repository where the source package is maintained.
pt: Exactamente como B<debian/source/options> excepto que o ficheiro não é incluído no pacote fonte gerado. Pode ser útil para guardar uma preferência amarrada ao maintainer ou ao repositório VCS onde o pacote fonte é mantido.

note: type: textblock
en: Free form text that is put on top of the automatic patch generated in formats “2.0” or “3.0 (quilt)”.  B<local-patch-header> is not included in the generated source package while B<patch-header> is.
pt: Texto de formato livre que é colocado no topo da patch automática gerada em formatos “2.0” ou “3.0 (quilt)”. B<local-patch-header> não é incluído no pacote fonte gerado enquanto B<patch-header> o é.

note: type: textblock
en: This file lists all patches that have to be applied (in the given order)  on top of the upstream source package.  Leading and trailing spaces are stripped.  The I<vendor> will be the lowercase name of the current vendor, or B<debian> if there is no vendor defined.  If the vendor-specific series file does not exist, the vendor-less series file will be used.  Lines starting with ‘B<#>’ are comments and are skipped.  Empty lines are ignored.  Remaining lines start with a patch filename (relative to the B<debian/patches/> directory) up to the first space character or the end of line.  Optional B<quilt> options can follow up to the end of line or the first ‘B<#>’ preceded by one or more spaces (which marks the start of a comment up to the end of line).
pt: Este ficheiro lista todas as patches que têm de ser aplicadas (na ordem dada) no topo do pacote fonte do autor original. Os espaços iniciais e finais são retirados. O I<vendor> será o nome em minúsculas do fornecedor actual, ou B<debian> se não existir um fornecedor definido. Se o ficheiro series especifico-do-fornecedor não existir, será usado o ficheiro series sem-fornecedor. As linha começadas com ‘B<#>’ são comentários e são retiradas. Linhas vazias são ignoradas. As linhas restantes começam com um nome de ficheiro patch (relativo ao directório B<debian/patches/>) até ap primeiro caractere de espaço ou ao fim da linha. Opções B<quilt> opcionais podem seguir até ao fim da linha ou ao primeiro ‘B<#>’ precedido por um ou mais espaços (o que marca o começo de um comentário até ao fim da linha).

note: type: textblock
en: Examining untrusted source packages or extracting them into staging directories should be considered a security boundary, and any breakage of that boundary stemming from these operations should be considered a security vulnerability.  But handling untrusted source packages should not be done lightly, as the surface area includes any compression command supported, commands to handle specific data formats (such as L<tar(1)> or L<patch(1)>)  in addition to the source package formats and control files themselves.  Performing these operations over untrusted data as root is strongly discouraged.
pt: Examinar pacotes fonte não-confiáveis ou extraí-los para directórios estagiários deve ser considerado um limite à segurança, e qualquer violação desse limite derivando dessas operações deve ser considerada uma vulnerabilidade na segurança. Mas manusear pacotes fonte não-confiáveis não deve ser feito com facilitismos, pois a área de superfície inclui qualquer comando de compressão suportado, comandos para lidar com formatos de dados específicos e os próprios ficheiros de controle. Executar essas operações sobre dados não-confiáveis como root é fortemente desaconselhado.

note: type: textblock
en: Building source packages should only be performed over trusted data.
pt: A compilação de pacotes fonte só deve ser executada sobre dados de confiança.

note: type: textblock
en: The point at which field overriding occurs compared to certain standard output field settings is rather confused.
pt: O ponto no qual cada sobreposição de campo ocorre comparado com certas definições de campos de saídas standard é bastante confuso.

note: type: textblock
en: dpkg-split - Debian package archive split/join tool
pt: dpkg-split - ferramenta de divisão/junção de arquivos de pacote Debian

note: type: textblock
en: B<dpkg-split> splits Debian binary package files into smaller parts and reassembles them again, to support the storage of large package files on small media such as floppy disks.
pt: B<dpkg-split> divide ficheiros de pacotes binários Debian em partes menores e junta-as outra vez, para suportar o armazenamento de ficheiros de pacotes grandes em meios pequenos como as disquetes.

note: type: textblock
en: It can be operated manually using the B<--split>, B<--join> and B<--info> options.
pt: Pode ser operado manualmente usando as opções B<--split>, B<--join> e B<--info>.

note: type: textblock
en: It also has an automatic mode, invoked using the B<--auto> option, where it maintains a queue of parts seen but not yet reassembled and reassembles a package file when it has seen all of its parts.  The B<--listq> and B<--discard> options allow the management of the queue.
pt: Também tem um modo automático, invocado usando a opção B<--auto>, onde mantém uma lista de espera com as partes visíveis mas ainda não juntadas e junta um ficheiro pacote quando tem todas as partes visíveis. As opções B<--listq> e B<--discard> permitem a gestão da lista de espera.

note: type: textblock
en: All splitting, joining and queueing operations produce informative messages on standard output; these may safely be ignored.
pt: Todas as operações de separar, juntar e meter em lista de espera produzem mensagens informativas na saída standard; estas podem ser ignoradas em segurança.

note: type: textblock
en: Splits a single Debian binary package into several parts.
pt: Divide um pacote binário Debian em várias partes.

note: type: textblock
en: The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part number, starting at 1, and I<M> is the total number of parts (both in decimal).
pt: As partes são nomeadas I<prefixo>B<.>I<N>B<of>I<M>B<.deb> onde I<N> é o número da parte, começando de 1, e I<M> é o número total de partes (ambos em decimal).

note: type: textblock
en: If no I<prefix> is supplied then the I<complete-archive> filename is taken, including directory, with any trailing B<.deb> removed.
pt: Se não for fornecido um I<prefixo>, então é usando o nome de ficheiro de I<arquivo-completo>, incluindo o directório, com qualquer B<.deb> à direita removido.

note: type: textblock
en: Joins the parts of a package file together, reassembling the original file as it was before it was split.
pt: Junta as partes do ficheiro de pacote, voltando a remontando o ficheiro original como ele era antes de ser dividido.

note: type: textblock
en: The part files given as arguments must be all the parts of exactly the same original binary file.  Each part must occur exactly once in the argument list, though the parts to not need to be listed in order.
pt: Os ficheiros parte dados como argumentos têm de ser todas as partes de exactamente o mesmo ficheiro binário original. Cada parte tem de ocorrer exactamente uma vez na lista de argumentos, apesar das partes não precisarem estar listadas por ordem.

note: type: textblock
en: The parts must of course all have been generated with the same part size specified at split time, which means that they must usually have been generated by the same invocation of B<dpkg-split --split>.
pt: Claro que as partes têm todas de ser geradas com o mesmo tamanho de parte especificado durante a divisão, o que significa que têm de ser geralmente geradas pela mesma invocação de B<dpkg-split --split>.

note: type: textblock
en: The parts' filenames are not significant for the reassembly process.
pt: Os nomes dos ficheiros das partes não são significantes para o processo de remontagem.

note: type: textblock
en: By default the output file is called I<package>B<_>I<version>B<_>I<arch>B<.deb>.
pt: Por predefinição, o ficheiro resultante é chamado I<pacote>B<_>I<versão>B<_>I<arquitectura>B<.deb>.

note: type: textblock
en: Prints information, in a human-readable format, about the part file(s)  specified.  Arguments which are not binary package parts produce a message saying so instead (but still on standard output).
pt: Escreve informação, num formato humanamente legível, acerca dos ficheiro(s) parte especificados. Argumentos que não sejam partes de pacote binário, em vez disso, produzem uma mensagem a dizer-lo (mas mesmo assim na saída standard).

note: type: textblock
en: Automatically queue parts and reassemble a package if possible.
pt: Põe em lista de espera partes e remonta um pacote automaticamente se possível.

note: type: textblock
en: The I<part> specified is examined, and compared with other parts of the same package (if any) in the queue of packages file parts.
pt: A I<part> especificada é examinada, e comparada com outras partes do mesmo pacote (se alguma) na fila de partes de ficheiros de pacotes.

note: type: textblock
en: If all parts of the package file of which I<part> is a part are available then the package is reassembled and written to I<complete-output> (which should not usually already exist, though this is not an error).
pt: Se todas as partes do ficheiro pacote no qual I<part> é uma parte estiverem disponíveis, então o pacote é remontado e escrito para I<complete-output> (o que não deve geralmente já existir, apesar de isto não ser um erro).

note: type: textblock
en: If not then the I<part> is copied into the queue and I<complete-output> is not created.
pt: Se não então a I<parte> é copiada para a lista de espera e o I<resultado-completo> não é criado.

note: type: textblock
en: If I<part> is not a split binary package part then B<dpkg-split> will exit with status B<1>; if some other trouble occurs then it will exit with status B<2>.
pt: Se I<part> não for uma parte de pacote binário dividido então B<dpkg-split> irá terminar com estado B<1>; se ocorrer algum outro problema então vai terminar com estado B<2>.

note: type: textblock
en: The B<--output> or B<-o> option must be supplied when using B<--auto>.  (If this were not mandatory the calling program would not know what output file to expect.)
pt: A opção B<--output> ou B<-o> tem de ser fornecida quando se usa B<--auto>.  (se isto não fosse obrigatório o programa chamador não saberia que ficheiro resultante esperar.)

note: type: textblock
en: Lists the contents of the queue of packages to be reassembled.
pt: Lista o conteúdo da lista de espera de pacotes a serem remontados.

note: type: textblock
en: For each package file of which parts are in the queue the output gives the name of the package, the parts in the queue, and the total number of bytes stored in the queue.
pt: Para cada ficheiro pacote cujas partes estão na fila o resultado dá o nome do pacote, as partes na fila, e o número total de bytes armazenados na fila.

note: type: textblock
en: This discards parts from the queue of those waiting for the remaining parts of their packages.
pt: Isto descarta partes da lista de espera daqueles que esperam as partes restantes dos seus pacotes.

note: type: textblock
en: If no I<package> is specified then the queue is cleared completely; if any are specified then only parts of the relevant package(s) are deleted.
pt: Se nenhum I<pacote> for especificado então a lista de espera é completamente limpa; se algum for especificado então apenas partes do(s) pacote(s) são apagadas.

note: type: textblock
en: Specifies an alternative directory for the queue of parts awaiting automatic reassembly.  The default is B<%ADMINDIR%/parts>.
pt: Especifica um directório alternativo para a lista de espera das partes que espera a remontagem automática. A predefinição é B<%ADMINDIR%/parts>.

note: type: textblock
en: Set the administrative directory to I<directory> (since dpkg 1.21.10).  This is where the I<statoverride> file is stored.  Defaults to «I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set.
pt: Define o directório de administração para I<directory> (desde dpkg 1.21.10). Isto é onde o ficheiro I<statoverride> é guardado. A predefinição é «I<%ADMINDIR%>» se B<DPKG_ADMINDIR> não estiver definido.

note: type: textblock
en: Set the root directory to B<directory> (since dpkg 1.21.10), which sets the installation directory to «I<directory>» and the administrative directory to «I<directory>B<%ADMINDIR%>» if B<DPKG_ROOT> has not been set.
pt: Define o directório raiz para B<directory> (desde dpkg 1.21.10), o que define o directório de instalação para «I<directory>» e o directório administrativo para «I<directory>B<%ADMINDIR%>» se B<DPKG_ROOT> não estiver definido.

note: type: textblock
en: Specifies the maximum part size when splitting, in kibibytes (1024 bytes).  The default is 450 KiB.
pt: Especifica o tamanho máximo de parte quando divide, em kibibytes (1024 bytes). A predefinição é 450 KiB.

note: type: textblock
en: Specifies the output file name for a reassembly.
pt: Especifica o nome de ficheiro resultante para uma remontagem.

note: type: textblock
en: This overrides the default for a manual reassembly (B<--join>)  and is mandatory for an automatic queue-or-reassemble (B<--auto>).
pt: Isto sobrepõe a predefinição para uma remontagem manual (B<--join>)  e é obrigatório para uma fila-ou-remontagem automática (B<--auto>).

note: type: textblock
en: When doing automatic queue-or-reassembly B<dpkg-split> usually prints a message if it is given a I<part> that is not a binary package part.  This option suppresses this message, to allow programs such as B<dpkg> to cope with both split and unsplit packages without producing spurious messages.
pt: quando faz fila ou remontagem automática o B<dpkg-split> geralmente escreve uma mensagem se lhe for dada uma I<part> que não é uma parte de um pacote binário. Esta opção suprime esta mensagem, para permitir a programas como o B<dpkg> lidar com ambos pacotes divididos e não-divididos sem produzir mensagens espúrias.

note: type: textblock
en: Forces the output filenames generated by B<--split> to be MSDOS-compatible.
pt: Impõe que os nomes de ficheiros gerados pelo B<--split> sejam compatíveis com MSDOS.

note: type: textblock
en: This mangles the prefix - either the default derived from the input filename or the one supplied as an argument: alphanumerics are lowercased, plus signs are replaced by B<x>'s and all other characters are discarded.
pt: Isto mutila o prefixo - ou a predefinição derivada do nome de ficheiro introduzido ou aquele fornecido como um argumento: alfanuméricos são minúsculas, sinais mais são substituídos por B<x>s e todos os outros caracteres são descartados.

note: type: textblock
en: The result is then truncated as much as is necessary, and filenames of the form I<prefixN>B<of>I<M>B<.deb> are generated.
pt: O resultado é então truncado o quanto necessário, e são gerados nomes de ficheiros no formato I<prefixoN>B<de>I<M>B<.deb>.

note: type: textblock
en: The requested split, merge, or other command succeeded.  B<--info> commands count as successful even if the files are not binary package parts.
pt: Os comandos split, merge, ou outros requeridos tiveram sucesso. Os comandos B<--info> contam como com sucesso mesmo que os ficheiros não sejam partes de pacotes binários.

note: type: textblock
en: Only occurs with B<--auto> and indicates that the I<part> file was not a binary package part.
pt: Apenas ocorre com B<--auto> e indica que o ficheiro I<parte> não é uma parte de um pacote binário.

note: type: textblock
en: Fatal or unrecoverable error due to invalid command-line usage, a file that looked like a package part file but was corrupted, or interactions with the system, such as accesses to the database, memory allocations, etc.
pt: Erro fatal ou irrecuperável devido a utilização inválida de linha de comandos, a um ficheiro que parecia um ficheiro de parte de pacote mas estava corrompido, ou a interações com o sistema, tais como acesso à base de dados, alocações de memória, etc.

note: type: textblock
en: If set and B<--root> option has not been specified, it will be used as the filesystem root directory (since dpkg 1.21.10).
pt: Se definido e a opção B<--root> não foi especificada, será usado como o directório raiz do sistema de ficheiros (desde dpkg 1.21.10).

note: type: textblock
en: If set and the B<--admindir> or B<--root> options have not been specified, it will be used as the B<dpkg> data directory (since dpkg 1.21.10).
pt: Se definido e as opções B<--admindir> ou B<--root> forem especificadas, será usado como o directório de dados do B<dpkg> (desde dpkg 1.21.10).

note: type: textblock
en: If set, it will be used as the timestamp (as seconds since the epoch) in the L<deb-split(5)>'s L<ar(5)> container.
pt: Se definido, irá ser usado como marca temporal (como segundos desde a época) no contentor L<ar(5)> de L<deb-split(5)>.

note: type: textblock
en: The default queue directory for part files awaiting automatic reassembly.
pt: O directório de lista de espera predefinido para ficheiros de partes que esperam a montagem automática.

note: type: textblock
en: The filenames used in this directory are in a format internal to B<dpkg-split> and are unlikely to be useful to other programs, and in any case the filename format should not be relied upon.
pt: Os nomes de ficheiros usados neste directório estão num formato interno ao B<dpkg-split> e é improvável que sejam úteis a outros programas, e em qualquer caso não se deve confiar no formato do nome de ficheiro.

note: type: textblock
en: Examining or joining untrusted split package archives should be considered a security boundary, and any breakage of that boundary stemming from these operations should be considered a security vulnerability.  Performing these operations over untrusted data as root is strongly discouraged.
pt: Examinar ou juntar arquivos de pacotes divididos não-confiáveis deve ser considerado um limite à segurança, e qualquer violação desse limite derivando dessas operações deve ser considerada uma vulnerabilidade na segurança. Executar essas operações sobre dados não-confiáveis como root é fortemente desaconselhado.

note: type: textblock
en: Auto-accumulating and discarding split package parts are considered privileged operations that might allow root escalation.  These operations must never be delegated to an untrusted user or be done on untrusted packages, as that might allow root access to the system.
pt: A auto-acumulação e descarte de partes de pacotes divididos são consideradas operações privilegiadas que podem permitir escalada a root. Estas operações nunca devem ser delegadas a um utilizador não-confiável ou serem feitas em pacotes não-confiáveis, pois isso pode permitir acesso de root ao sistema.

note: type: textblock
en: Splitting package archives should only be performed over trusted data.
pt: A divisão de arquivos de pacotes só deve ser executada sobre dados de confiança.

note: type: textblock
en: Full details of the packages in the queue are impossible to get without digging into the queue directory yourself.
pt: Os detalhes completos dos pacotes na lista de espera são impossíveis de obter sem que você próprio pesquise dentro do directório de lista de espera.

note: type: textblock
en: There is no easy way to test whether a file that may be a binary package part is one.
pt: Não há maneira fácil de testar se um ficheiro que pode ser uma parte de um pacote binário o é mesmo.

note: type: textblock
en: dpkg-statoverride - override ownership and mode of files
pt: dpkg-statoverride - sobrepõe a propriedade e o modo dos ficheiros

note: type: textblock
en: “B<stat overrides>” are a way to tell L<dpkg(1)> to use a different owner or mode for a path when a package is installed (this applies to any filesystem object that B<dpkg> handles, including directories, devices, etc.).  This can be used to force programs that are normally setuid to be install without a setuid flag, or only executable by a certain group.
pt: “B<stat overrides>” são um modo de dizer L<dpkg(1)> para usar um dono ou modo diferente para um caminho quando um pacote é instalado (isto aplica-se a qualquer objecto de sistema de ficheiros com que o B<dpkg> lide, incluindo directórios, dispositivos, etc.). Isto pode ser usado para forçar programas que são normalmente definidos a um uid a serem instalados sem uma bandeira setuid, ou apenas executável por um determinado grupo.

note: type: textblock
en: B<dpkg-statoverride> is a utility to manage the list of stat overrides.  It has three basic functions: adding, removing and listing overrides.
pt: B<dpkg-statoverride> é um utilitário para gerir sobreposições de estatísticas. Tem três funções básicas: adicionar, remover e listar sobreposições.

note: type: textblock
en: Add an override for I<path>.  I<path> does not need to exist nor be known to B<dpkg> when this command is used; the override will be stored and used later.  Users and groups can be specified by their name (for example B<root> or B<nobody>), or by their number by prepending the number with a ‘B<#>’ (for example B<#0> or B<#65534>).  The I<mode> needs to be specified in octal.
pt: Adiciona uma sobreposição para I<path>. I<path> não precisa existir nem ser conhecida pelo B<dpkg> quando este comando é usado; a sobreposição será guardada e usada mais tarde. Os utilizadores e grupos podem ser especificados pelo seu nome (por exemplo, B<root> ou B<nobody>), ou pelo seu número ao anexar o número com um ‘B<#>’ (por exemplo B<#0> ou B<#65534>). O I<mode> precisa de ser especificado em octal.

note: type: textblock
en: If B<--update> is specified and I<path> exists, it is immediately set to the new owner and mode.
pt: Se for especificado B<--update> e I<caminho> existir, é imediatamente definido para o proprietário e modo novos.

note: type: textblock
en: Remove an override for I<path>, the status of I<path> is left unchanged by this command.
pt: Remove uma sobreposição para I<path>, o estado de I<path> é mantido inalterado por este comando.

note: type: textblock
en: List all overrides.  If a glob pattern is specified restrict the output to overrides which match the glob.
pt: Lista todas as sobreposições. Se for especificado um padrão glob, restringe o resultado às sobreposições que correspondem ao glob.

note: type: textblock
en: Give help about the B<--force->I<thing> options (since dpkg 1.19.5).
pt: Oferece ajuda acerca das opções B<--force->I<thing> (desde dpkg 1.19.5).

note: type: textblock
en: Set the administrative directory to I<directory>.  This is where the I<statoverride> file is stored.  Defaults to «I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set.
pt: Define o directório de administração para I<directory>. Isto é onde o ficheiro I<statoverride> é guardado. A predefinição é «I<%ADMINDIR%>» se B<DPKG_ADMINDIR> não estiver definido.

note: type: textblock
en: Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some things (since dpkg 1.19.5).  I<things> is a comma separated list of things specified below.  B<--force-help> displays a message describing them.  Things marked with (*) are forced by default.
pt: Força ou recusa (B<no-force> e B<refuse> significam o mesmo) a fazer algumas coisas (desde dpkg 1.19.5).  I<things> é uma lista separada por vírgulas de coisas especificadas em baixo. B<--force-help> mostra uma mensagem a descreve-las. A coisas marcadas com (*) já são forçadas por predefinição.

note: type: textblock
en: B<Warning>: These options are mostly intended to be used by experts only.  Using them without fully understanding their effects may break your whole system.
pt: I<Aviso>: Estas opções são maioritariamente destinadas a serem usadas apenas por experts. Usa-las sem total conhecimento dos seus efeitos pode danificar todo o seu sistema.

note: type: textblock
en: Turns on (or off) all force options.
pt: Liga (ou desliga) todas as opções de forçar.

note: type: textblock
en: Overwrite an existing stat override when adding it (since dpkg 1.19.5).
pt: Sobrescreve uma sobreposição de estatística existente quando a adiciona (desde dpkg 1.19.5).

note: type: textblock
en: Ignore a missing stat override when removing it (since dpkg 1.19.5).
pt: Ignora uma sobreposição de estatística em falta quando a remove (desde dpkg 1.19.5).

note: type: textblock
en: Use platform-specific Mandatory Access Controls (MAC) based security when installing files into the filesystem (since dpkg 1.19.5).  On Linux systems the implementation uses SELinux.
pt: Usa segurança baseada em Mandatory Access Controls (MAC) específica da plataforma quando instala ficheiros no sistema de ficheiros (desde dpkg 1.19.5). Em sistemas Linux a implementação usa SELinux.

note: type: textblock
en: Try to (de)install things even when not root (since dpkg 1.21.8).
pt: Tenta (des)instalar coisas mesmo não sendo root (desde dpkg 1.21.8).

note: type: textblock
en: Force an action, even if a sanity check would otherwise prohibit it.  This is necessary to override an existing override.  This option is deprecated (since dpkg 1.19.5), it is replaced by B<--force-all>.
pt: Força uma acção, mesmo que a verificação de sanidade a proíba Isto é necessário para sobrepor uma sobreposição existente. Esta opção está descontinuada (desde dpkg 1.19.5), é substituída por B<--force-all>.

note: type: textblock
en: Immediately try to change the I<path> to the new owner and mode if it exists.
pt: Imediatamente tenta alterar o I<caminho> para o novo dono e modo se existir.

note: type: textblock
en: Be less verbose about what we do.
pt: Fica menos detalhado sobre o que faz.

note: type: textblock
en: For B<--list>, if there are no overrides or none match the supplied glob.
pt: Para B<--list>, se não existirem sobreposições ou nenhuma corresponder ao glob fornecido.

note: type: textblock
en: If set and none of the B<--force->I<...> options have been specified, it will be used as the force options to use (since dpkg 1.19.5).
pt: Se definido e nenhuma da opções B<--force->I<...> forem especificadas, será usado como a opção de forçar a usar (desde dpkg 1.19.5).

note: type: textblock
en: File which contains the current list of stat overrides of the system.  It is located in the B<dpkg> administration directory, along with other files important to B<dpkg>, such as I<status> or I<available>.
pt: Ficheiro que contém a lista actual de sobreposições de estados do sistema. Está localizado no directório de administração do <dpkg>, juntamente com outros ficheiros importantes para o B<dpkg>, como I<status> ou I<available>.

note: type: textblock
en: B<Note>: B<dpkg-statoverride> preserves the old copy of this file, with extension “-old”, before replacing it with the new one.
pt: B<Nota>: O B<dpkg-statoverride> preserva uma copia antiga deste ficheiro, com a extensão "-old", antes de o substituir pelo novo.

note: type: textblock
en: dpkg-trigger - a package trigger utility
pt: dpkg-trigger - um utilitário de trigger de pacote

note: type: textblock
en: B<dpkg-trigger> is a tool to explicitly activate triggers and check for its support on the running B<dpkg>.
pt: B<dpkg-trigger> é uma ferramenta para activar explicitamente triggers e verificar o seu suporte no B<dpkg> em execução.

note: type: textblock
en: This can be used by maintainer scripts in complex and conditional situations where the file triggers, or the declarative B<activate> triggers control file directive, are insufficiently rich.  It can also be used for testing and by system administrators (but note that the triggers won't actually be run by B<dpkg-trigger>).
pt: Isto pode ser usado pelos scripts do maintainer em situações complexas e condicionais onde os gatilhos do ficheiro, ou a directiva de ficheiro declarativa de gatilhos B<activate>, sejam insuficientemente ricos. Também pode ser usado para testes e por administradores de sistema (mas note que os gatilhos não serão realmente corridos pelo B<dpkg-trigger>).

note: type: textblock
en: Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>.
pt: Sintaxes de nome de trigger não reconhecidas são um erro para o B<dpkg-trigger>.

note: type: textblock
en: This program was introduced in dpkg 1.14.17.
pt: Este programa foi introduzido no dpkg 1.14.17.

note: type: textblock
en: Check if the running B<dpkg> supports triggers (usually called from a postinst).  Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> with an error message to stderr if not.  Normally, however, it is better just to activate the desired trigger with B<dpkg-trigger>.
pt: Verifica se o B<dpkg> a correr suporta gatilhos (geralmente chamados a partir de um postinst). Irá terminar com B<0> se correu um B<dpkg> com capacidade-de-gatilhos, ou B<1> com uma mensagem de erro para o stderr se não. No entanto, é normalmente melhor apenas activar o gatilho desejado com B<dpkg-trigger>.

note: type: textblock
en: Change the location of the B<dpkg> database.  Defaults to I<%ADMINDIR%> if B<DPKG_ADMINDIR> has not been set.
pt: Altera a localização da base de dados do B<dpkg>. A predefinição é I<%ADMINDIR%> se B<DPKG_ADMINDIR> não estiver definido.

note: type: textblock
en: Override trigger awaiter (normally set by B<dpkg> through the B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, naming the package to which the script belongs, and this will be used by default).
pt: Sobrepõe o esperador do gatilho (normalmente definido pelo B<dpkg> através da variável de ambiente B<DPKG_MAINTSCRIPT_PACKAGE> dos scripts do maintainer, que nomeiam o pacote ao qual o script pertence, e isto será usado por predefinição).

note: type: textblock
en: This option arranges that the calling package I<T> (if any) need not await the processing of this trigger; the interested package(s) I<I>, will not be added to I<T>'s trigger processing awaited list and I<T>'s status is unchanged.  I<T> may be considered installed even though I<I> may not yet have processed the trigger.
pt: Esta opção faz com que o pacote chamador I<T> (se existir) não precisa de esperar o processamento deste gatilho; os pacotes interessados I<I>, não serão adicionados à lista de espera de processamento de gatilhos de I<T> e o estado de I<T> não alterou. I<T> pode ser considerado instalado mesmo apesar de I<I> ainda não ter processado o gatilho.

note: type: textblock
en: This option does the inverse of B<--no-await> (since dpkg 1.17.21).  If the interested package has declared a “noawait” directive, then this option will not be effective.  It is currently the default behavior.
pt: Esta opção faz o inverso de B<--no-await> (desde dpkg 1.17.21). Se o pacote interessado declarou uma directiva “noawait”, então esta opção não será efectiva. Actualmente é o comportamento predefinido.

note: type: textblock
en: Just test, do not actually change anything.
pt: Apenas testa, na realidade não alterada nada.

note: type: textblock
en: The requested action was successfully performed.  Or a check or assertion command returned true.
pt: A acção requisitada foi executada com sucesso. Ou uma verificação ou comando de afirmação retornou verdadeiro.

note: type: textblock
en: A check or assertion command returned false.
pt: Uma verificação ou comando de afirmação retornou falso.

note: type: textblock
en: dpkg-vendor - queries information about distribution vendors
pt: dpkg-vendor - recolhe informação acerca dos fornecedores da distribuição

note: type: textblock
en: B<dpkg-vendor> is a tool to query information about vendors listed in B<%PKGCONFDIR%/origins>.  B<%PKGCONFDIR%/origins/default> contains information about the current vendor.
pt: B<dpkg-vendor> é uma ferramenta para inquirir informação acerca dos fornecedores listados em B<%PKGCONFDIR%/origins>. B<%PKGCONFDIR%/origins/default> contém informação acerca do fornecedor actual.

note: type: textblock
en: This program was introduced in dpkg 1.15.1.
pt: Este programa foi introduzido no dpkg 1.15.1.

note: type: textblock
en: Exits with B<0> if the current vendor is I<vendor>.  Otherwise exits with B<1>.
pt: Termina com B<0> se o fornecedor actual for I<vendor>. Caso contrário, termina com B<1>.

note: type: textblock
en: Exits with B<0> if the current vendor distribution is a derivative of I<vendor>, otherwise exits with B<1>.  It uses the B<Parent> field to browse all ancestors of the current vendor.
pt: Termina com B<0> se o fornecedor actual da distribuição é um derivativo de I<vendor>, caso contrário termina com B<1>. Usa o campo B<Parent> para explorar todos os ancestrais do fornecedor actual.

note: type: textblock
en: Print on standard output the value of the vendor-specific I<field> for the current vendor.
pt: Escreve na saída standard o valor do I<field> vendor-specific para o fornecedor actual.

note: type: textblock
en: Assumes the current vendor is I<vendor> instead of discovering it with the B<DEB_VENDOR> environment variable or B<%PKGCONFDIR%/origins/default>.
pt: Assume que o actual fornecedor é I<fornecedor> em vez de o descobrir com a variável de ambiente B<DEB_VENDOR> ou B<%PKGCONFDIR%/origins/default>.

note: type: textblock
en: dpkg.cfg - dpkg configuration file
pt: dpkg.cfg - ficheiro de configuração do dpkg

note: type: textblock
en: This file contains default options for dpkg.  Each line contains a single option which is exactly the same as a normal command line option for dpkg except for the leading hyphens which are not used here.  Quotes surrounding option values are stripped.  Comments are allowed by starting a line with a hash sign (‘B<#>’).
pt: Este ficheiro contem opções predefinidas para o dpkg. Cada linha contem uma opção única que é exatamente a mesma que uma opção de linha de comandos normal para o dpkg excepto pelos traços iniciais que não são usados aqui. As citações que rodeiam os valores das opções são cortadas. Os comentários são permitidos ao iniciar uma linha com um sinal cardinal (‘B<#>’).

note: type: textblock
en: dpkg - package manager for Debian
pt: dpkg - gestor de pacotes para Debian

note: type: =head1
en: WARNING
pt: AVISO

note: type: textblock
en: This manual is intended for users wishing to understand B<dpkg>'s command line options and package states in more detail than that provided by B<dpkg --help>.
pt: este manual destina-se a utilizadores que desejam compreender as opções de linha de comandos do B<dpkg> e estados de pacotes em mais detalhe do que aquele fornecido por B<dpkg --help>.

note: type: textblock
en: It should I<not> be used by package maintainers wishing to understand how B<dpkg> will install their packages.  The descriptions of what B<dpkg> does when installing and removing packages are particularly inadequate.
pt: I<Não> deverá ser usado por maintainers de pacotes que desejem compreender como o B<dpkg> irá instalar os seus pacotes. A descrição do que o B<dpkg> faz quando instala ou remove pacotes é particularmente inadequada.

note: type: textblock
en: B<dpkg> is a medium-level tool to install, build, remove and manage Debian packages.  The primary and more user-friendly front-end for B<dpkg> as a CLI (command-line interface) is L<apt(8)> and as a TUI (terminal user interface) is L<aptitude(8)>.  B<dpkg> itself is controlled entirely via command line parameters, which consist of exactly one action and zero or more options.  The action-parameter tells B<dpkg> what to do and options control the behavior of the action in some way.
pt: B<dpkg> é uma ferramenta de nível médio para instalar, compilar, remover e gerir pacotes Debian. O front-end principal e mais amigo-do-utilizador para o B<dpkg> como CLI é o (interface de linha de comandos) é o L<apt(8)> e como TUI (interface de terminal de utilizador) é o L<aptitude(8)>. O próprio B<dpkg> é controlado inteiramente via parâmetros de linha de comandos, o que consiste de exactamente uma acção e zero ou mais opções. O parâmetro-acção diz ao B<dpkg> o que fazer e as opções controlam o comportamento da acção em algum modo.

note: type: textblock
en: B<dpkg> can also be used as a front-end to L<dpkg-deb(1)> and L<dpkg-query(1)>.  The list of supported actions can be found later on in the B<ACTIONS> section.  If any such action is encountered B<dpkg> just runs B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no specific options are currently passed to them, to use any such option the back-ends need to be called directly.
pt: O B<dpkg> pode também ser usado como front-end para L<dpkg-deb(1)> e L<dpkg-query(1)>. A lista de acções suportadas pode ser encontrada mais tarde na secção B<ACÇÕES>. Se qualquer tal acção for encontrada, o B<dpkg> apenas corre B<dpkg-deb> ou B<dpkg-query> com os parâmetros dados a ele, mas nenhuma opção especifica é presentemente passada para eles, para se qualquer tal opção, os back-ends precisam de ser chamados directamente.

note: type: =head1
en: INFORMATION ABOUT PACKAGES
pt: INFORMAÇÃO ACERCA DE PACOTES

note: type: textblock
en: B<dpkg> maintains some usable information about available packages.  The information is divided in three classes: B<states>, B<selection states> and B<flags>.  These values are intended to be changed mainly with B<dselect>.
pt: O B<dpkg> mantém alguma informação utilizável sobre pacotes disponíveis. A informação é dividida em três classes: B<states>, B<selection states> e B<flags>. Estes valores destinam-se a serem alterados principalmente com o B<dselect>.

note: type: =head2
en: Package states
pt: Estados de pacote

note: type: textblock
en: The package is not installed on your system.
pt: Este pacote não está instalado no seu sistema.

note: type: textblock
en: Only the configuration files or the B<postrm> script and the data it needs to remove of the package exist on the system.
pt: Apenas os ficheiros de configuração ou o script B<postrm> e os dados que precisa para remoção do pacote existem no sistema.

note: type: textblock
en: The installation of the package has been started, but not completed for some reason.
pt: A instalação do pacote foi iniciada, mas não foi acabada por alguma razão.

note: type: textblock
en: The package is unpacked, but not configured.
pt: O pacote está desempacotado mas não configurado.

note: type: textblock
en: The package is unpacked and configuration has been started, but not yet completed for some reason.
pt: O pacote está desempacotado e a configuração foi iniciada, mas ainda não está acabada por alguma razão.

note: type: textblock
en: The package awaits trigger processing by another package.
pt: O pacote espera o processamento de trigger por outro pacote.

note: type: textblock
en: The package has been triggered.
pt: O pacote foi despoletado

note: type: textblock
en: The package is correctly unpacked and configured.
pt: O pacote está actualmente desempacotado e configurado.

note: type: =head2
en: Package selection states
pt: Estados de selecção de pacote

note: type: textblock
en: The package is selected for installation.
pt: O pacote está seleccionado para instalação.

note: type: textblock
en: A package marked to be on B<hold> is kept on the same version, that is, no automatic new installs, upgrades or removals will be performed on them, unless these actions are requested explicitly, or are permitted to be done automatically with the B<--force-hold> option.
pt: Um pacote marcado para estar em B<hold> é mantido na mesma versão, isto é, não serão executadas nenhumas novas instalações, actualizações ou remoções automáticas nele, a menos que estas acções sejam requisitadas explicitamente, ou sejam permitidas serem feitas automaticamente com a opção B<--force-hold>.

note: type: textblock
en: The package is selected for deinstallation (i.e. we want to remove all files, except configuration files).
pt: O pacote está seleccionado para desinstalação (isto é, queremos remover todos os ficheiros, excepto os ficheiros de configuração).

note: type: textblock
en: The package is selected to be purged (i.e. we want to remove everything from system directories, even configuration files).
pt: O pacote está seleccionado para ser purgado (isto é, queremos remover tudo dos directórios do sistema, até os ficheiros de configuração).

note: type: textblock
en: The package selection is unknown.  A package that is also in a B<not-installed> state, and with an B<ok> flag will be forgotten in the next database store.
pt: A selecção de pacote é desconhecida. Um pacote que também está nu estado B<not-installed>, e com uma bandeira B<ok> irá ser esquecido no próximo armazenamento da base de dados.

note: type: =head2
en: Package flags
pt: Bandeiras (flags) do pacote

note: type: textblock
en: A package marked B<ok> is in a known state, but might need further processing.
pt: Um pacote marcado com B<ok> está num estado conhecido, mas pode precisar de mais processamento.

note: type: textblock
en: A package marked B<reinstreq> is broken and requires reinstallation.  These packages cannot be removed, unless forced with option B<--force-remove-reinstreq>.
pt: Um pacote marcado com B<reinstreq> está quebrado e requer reinstalação. Estes pacotes não podem ser removidos, a menos que tal seja forçado com a opção B<--force-remove-reinstreq>.

note: type: =head1
en: ACTIONS
pt: ACÇÕES

note: type: textblock
en: Install the package.  If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
pt: Instala o pacote. Se a opção B<--recursive> ou B<-R> for especificada, I<ficheiro-pacote> tem que se referir a um directório em vez de um ficheiro.

note: type: textblock
en: Installation consists of the following steps:
pt: A instalação consiste nos seguintes passos:

note: type: textblock
en: Extract the control files of the new package.
pt: Extrai os ficheiros de controle do novo pacote.

note: type: textblock
en: If another version of the same package was installed before the new installation, execute I<prerm> script of the old package.
pt: Se outra versão do mesmo pacote foi instalada antes da nova instalação, executa o script I<prerm> do pacote antigo.

note: type: textblock
en: Run I<preinst> script, if provided by the package.
pt: Corre o script I<preinst>, se disponibilizado pelo pacote.

note: type: textblock
en: Unpack the new files, and at the same time back up the old files, so that if something goes wrong, they can be restored.
pt: Desempacota os novos ficheiros, e aos mesmo tempo salvaguarda os ficheiros antigos, para que se algo correr mal, eles possam ser restaurados.

note: type: textblock
en: If another version of the same package was installed before the new installation, execute the I<postrm> script of the old package.  Note that this script is executed after the I<preinst> script of the new package, because new files are written at the same time old files are removed.
pt: Se outra versão do mesmo pacote foi instalada antes da nova instalação, executa o script I<postrm> do pacote antigo. Note que este script é executado depois do script I<preinst> do novo pacote, porque novos ficheiros são escritos ao mesmo tempo que ficheiros antigos são removidos.

note: type: textblock
en: Configure the package.  See B<--configure> for detailed information about how this is done.
pt: Configura o pacote. Veja B<--configure> para informação detalhada sobre como isto é feito.

note: type: textblock
en: Unpack the package, but don't configure it.  If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
pt: Desempacota o pacote, mas não o configura. Se a opção B<--recursive> ou B<-R> for especificada, I<package-file> deverá então referir-se a um directório.

note: type: textblock
en: Will process triggers for B<Pre-Depends> unless B<--no-triggers> has been specified.
pt: Irá processar os gatilhos para B<Pre-Depends> a menos que B<--no-triggers> esteja especificado.

note: type: textblock
en: Configure a package which has been unpacked but not yet configured.  If B<-a> or B<--pending> is given instead of I<package>, all unpacked but unconfigured packages are configured.
pt: Configura um pacote que foi desempacotado mas ainda não configurado. Se for fornecido B<-a> ou B<--pending> em vez de I<package>, todos os pacotes desempacotados mas não configurados são configurados.

note: type: textblock
en: To reconfigure a package which has already been configured, try the L<dpkg-reconfigure(8)> command instead (which is part of the B<debconf> project).
pt: Para reconfigurar um pacote que já foi configurado, tente usar o comando L<dpkg-reconfigure(8)> em vez deste (o qual faz parte do projeto B<debconf>).

note: type: textblock
en: Configuring consists of the following steps:
pt: A configuração consiste dos seguintes passos:

note: type: textblock
en: Unpack the conffiles, and at the same time back up the old conffiles, so that they can be restored if something goes wrong.
pt: Desempacota os conffiles, e ao mesmo tempo faz salvaguardas dos conffiles antigos, para que possam ser restaurados se algo correr mal.

note: type: textblock
en: Run I<postinst> script, if provided by the package.
pt: Corre o script I<postinst>, se fornecido pelo pacote.

note: type: textblock
en: Will process triggers unless B<--no-triggers> has been specified.
pt: Irá processar os gatilhos a menos que B<--no-triggers> esteja especificado.

note: type: textblock
en: Processes only triggers (since dpkg 1.14.17).  All pending triggers will be processed.  If package names are supplied only those packages' triggers will be processed, exactly once each where necessary.  Use of this option may leave packages in the improper B<triggers-awaited> and B<triggers-pending> states.  This can be fixed later by running: B<dpkg --configure --pending>.
pt: Processa apenas gatilhos (desde dpkg 1.14.17).  Todos os gatilhos pendentes serão processados. Se forem fornecidos nomes de pacotes, apenas os gatilhos desses pacotes serão processados, exactamente uma vez onde necessário. O uso desta opção pode deixar pacotes em estados B<triggers-awaited> e B<triggers-pending> impróprios. Isto pode ser corrigido mais tarde ao correr: B<dpkg --configure --pending>.

note: type: textblock
en: Remove an installed package.  This removes everything except conffiles and other data cleaned up by the I<postrm> script, which may avoid having to reconfigure the package if it is reinstalled later (conffiles are configuration files that are listed in the I<DEBIAN/conffiles> control file).  If there is no I<DEBIAN/conffiles> control file nor I<DEBIAN/postrm> script, this command is equivalent to calling B<--purge>.  If B<-a> or B<--pending> is given instead of a package name, then all packages unpacked, but marked to be removed in file I<%ADMINDIR%/status>, are removed.
pt: Remove um pacote instalado. Isto remove tudo excepto conffiles e outros dados limpos pelo script I<postrm>, o qual pode evitar de ter que reconfigurar o pacote se for reinstalado mais tarde (conffiles são ficheiros de configuração que estão listados no ficheiro de controle I<DEBIAN/conffiles>). Se não existir um ficheiro de controlo I<DEBIAN/conffiles> nem script I<DEBIAN/postrm>, este comando é equivalente a chamar B<--purge>. Se for fornecido B<-a> ou B<--pending> em vez de um nome de pacote , então são removidos todos os pacotes desempacotados mas marcados para serem removidos no ficheiro I<%ADMINDIR%/status>.

note: type: textblock
en: Removing of a package consists of the following steps:
pt: Remover um pacote consiste nos seguintes passos:

note: type: textblock
en: Run I<prerm> script.
pt: Corre o script I<prerm>.

note: type: textblock
en: Remove the installed files.
pt: Remove os ficheiros instalados.

note: type: textblock
en: Run I<postrm> script.
pt: Corre o script I<postrm>.

note: type: textblock
en: Purge an installed or already removed package.  This removes everything, including conffiles, and anything else cleaned up from I<postrm>.  If B<-a> or B<--pending> is given instead of a package name, then all packages unpacked or removed, but marked to be purged in file I<%ADMINDIR%/status>, are purged.
pt: Purga um pacote instalado ou já removido.Isto remove tudo, incluindo conffiles, e tudo o resto limpo a partir do I<postrm>.  Se for fornecido B<-a> ou  B<--pending> em vez do nome de pacote, então todos os pacotes desempacotados ou removidos, mas marcados para serem purgados no ficheiro I<%ADMINDIR%/status>, serão purgados.

note: type: textblock
en: B<Note>: Some configuration files might be unknown to B<dpkg> because they are created and handled separately through the configuration scripts.  In that case, B<dpkg> won't remove them by itself, but the package's I<postrm> script (which is called by B<dpkg>), has to take care of their removal during purge.  Of course, this only applies to files in system directories, not configuration files written to individual users' home directories.
pt: B<Nota>: Alguns ficheiros de configuração podem ser desconhecidos para o B<dpkg> porque eles são criados e manuseados separadamente através dos scripts de configuração. Nesse caso, o B<dpkg> não irá remove-los sozinho, mas o script I<postrm> do pacote (que é chamado pelo B<dpkg>), tem de fazer a sua remoção durante a purga. Claro que, isto só se aplica a ficheiros em directórios do sistema, e não a ficheiros de configuração escritos nos directórios home de utilizadores individuais.

note: type: textblock
en: Purging of a package consists of the following steps:
pt: Purgar um pacote consiste nos seguintes passos:

note: type: textblock
en: Remove the package, if not already removed.  See B<--remove> for detailed information about how this is done.
pt: Remove o pacote, se não estiver já removido. Veja B<--remove> para informação detalhada acerca de como isto é feito.

note: type: textblock
en: Verifies the integrity of I<package-name> or all packages if omitted, by comparing information from the files installed by a package with the files metadata information stored in the B<dpkg> database (since dpkg 1.17.2).  The origin of the files metadata information in the database is the binary packages themselves.  That metadata gets collected at package unpack time during the installation process.
pt: Verifica a integridade de I<package-name> ou todos os pacotes se omitido, ao comparar informação dos ficheiros instalados com a informação de metadados de ficheiros guardada na base de dados do B<dpkg> (desde dpkg 1.17.2). A origem da informação de metadados de ficheiros na base de dados é os próprios pacotes binários. Esses metadados são colecionados ao desempacotar os ficheiros durante o processo de instalação.

note: type: textblock
en: Currently the only functional check performed is an md5sum verification of the file contents against the stored value in the files database.  It will only get checked if the database contains the file md5sum.  To check for any missing metadata in the database, the B<--audit> command can be used.  This is only an integrity check and should not be considered as any kind of security verification.
pt: Presentemente a única verificação funcional executada é uma verificação de md5sum do conteúdo dos ficheiros contra o valor armazenado na base de dados dos ficheiros. Só serão verificados se a base de dados conter o md5sum dos ficheiros. Para verificar por quaisquer metadados em falta na base de dados, pode ser usado o comando B<--audit>. Isto é apenas uma verificação de integridade e não deve ser considerado como nenhum tipo de verificação de segurança.

note: type: textblock
en: The output format is selectable with the B<--verify-format> option, which by default uses the B<rpm> format, but that might change in the future, and as such, programs parsing this command output should be explicit about the format they expect.
pt: O formato do resultado é seleccionável com a opção B<--verify-format>, que por predefinição usa o formato B<rpm>, mas isso pode mudar no futuro, e como tal, os programas que analisam resultado de comando devem estar explícitos acerca do formato que esperam.

note: type: textblock
en: Performs database sanity and consistency checks for I<package-name> or all packages if omitted (per package checks since dpkg 1.17.10).  For example, searches for packages that have been installed only partially on your system or that have missing, wrong or obsolete control data or files.  B<dpkg> will suggest what to do with them to get them fixed.
pt: Executa testes de sanidade e consistência para I<package-name> ou todos os pacotes se omitido (verificações por pacote desde dpkg 1.17.10). Por exemplo, procura por pacote que foram instalados apenas parcialmente no seu sistema ou têm ficheiros ou dados de controle em falta, errados ou obsoletos. O B<dpkg> irá sugerir o que fazer com eles para os corrigir.

note: type: textblock
en: Update B<dpkg>'s and B<dselect>'s idea of which packages are available.  With action B<--merge-avail>, old information is combined with information from I<Packages-file>.  With action B<--update-avail>, old information is replaced with the information in the I<Packages-file>.  The I<Packages-file> distributed with Debian is simply named «I<Packages>».  If the I<Packages-file> argument is missing or named «B<->» then it will be read from standard input (since dpkg 1.17.7).  B<dpkg> keeps its record of available packages in I<%ADMINDIR%/available>.
pt: Actualiza o conhecimento de B<dpkg>'s e B<dselect> de quais pacotes estão disponíveis. Com a acção B<--merge-avail>, a informação antiga é combinada com informação de I<Packages-file>. Com a acção B<--update-avail>, informação antiga é substituída pela informação de I<Packages-file>. O I<Packages-file> distribuído com Debian é simplesmente chamado «I<Packages>». Se o argumento I<Packages-file> estiver em falta ou for chamado «B<->» então será lido a partir da entrada standard (desde dpkg 1.17.7). B<dpkg> mantém o seu registo de pacotes disponíveis em I<%ADMINDIR%/available>.

note: type: textblock
en: A simpler one-shot command to retrieve and update the I<available> file is B<dselect update>.  Note that this file is mostly useless if you don't use B<dselect> but an APT-based frontend: APT has its own system to keep track of available packages.
pt: Um comando único mais simples de obter e actualizar o ficheiro I<available> é B<dselect update>. Note que este ficheiro é maioritariamente inútil se você não usar o B<dselect> mas um frontend baseado no APT: O APT tem o seu próprio sistema para acompanhar os pacotes disponíveis.

note: type: textblock
en: Update B<dpkg> and B<dselect>'s idea of which packages are available with information from the package I<package-file>.  If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
pt: Actualiza o conhecimento de B<dpkg>'s e B<dselect> de quais pacotes estão disponíveis com informação a partir do pacote I<package-file>. Se forem especificadas as opções B<--recursive> ou B<-R>, então I<package-file> deve referir-se a um directório.

note: type: textblock
en: Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled unavailable packages (since dpkg 1.15.4), but only those that do not contain user information such as package selections.
pt: Agora B<obsoleto> e uma não-opção pois o B<dpkg> irá esquecer automaticamente os pacotes não instalados e não disponíveis (desde dpkg 1.15.4), mas apenas aqueles que não contêm informação de utilizador tal como selecções de pacotes.

note: type: textblock
en: Erase the existing information about what packages are available.
pt: Apaga a informação existente sobre que pacotes estão disponíveis.

note: type: textblock
en: Get list of package selections, and write it to stdout.  Without a pattern, non-installed packages (i.e. those which have been previously purged) will not be shown.
pt: Obtém lista de selecções de pacotes, e escreve-a no stdout. Sem um padrão, os pacotes não-instalados (isto é, aqueles que foram previamente purgados) não serão mostrados.

note: type: textblock
en: Set package selections using file read from stdin.  This file should be in the format “I<package> I<state>”, where state is one of B<install>, B<hold>, B<deinstall> or B<purge>.  Blank lines and comment lines beginning with ‘B<#>’ are also permitted.
pt: Define selecções de pacotes usando um ficheiro a partir de stdin. Este ficheiro deve estar no formato “I<package> I<state>”, onde state é um de B<install>, B<hold>, B<deinstall> ou B<purge>. São também permitidas linhas vazias e linhas de comentários começando com ‘B<#>’.

note: type: textblock
en: The I<available> file needs to be up-to-date for this command to be useful, otherwise unknown packages will be ignored with a warning.  See the B<--update-avail> and B<--merge-avail> commands for more information.
pt: O ficheiro I<available> precisa de estar actualizado para que este comando seja útil, caso contrário os pacotes desconhecidos serão ignorados com um aviso. Veja os comandos B<--update-avail> e B<--merge-avail> para mais informação.

note: type: textblock
en: Set the requested state of every non-essential package to deinstall (since dpkg 1.13.18).  This is intended to be used immediately before B<--set-selections>, to deinstall any packages not in list given to B<--set-selections>.
pt: Define o estado requerido de todos os pacotes não-essenciais para "desinstalar" (desde dpkg 1.13.18). Isto destina-se a ser usado imediatamente antes de B<--set-selections>, para desinstalar quaisquer pacotes que não estejam na lista fornecida ao B<--set-selections>.

note: type: textblock
en: Searches for packages selected for installation, but which for some reason still haven't been installed.
pt: Procura por pacotes selecionados para instalação, mas que por alguma razão ainda não foram instalados.

note: type: textblock
en: B<Note>: This command makes use of both the available file and the package selections.
pt: B<Nota>: Este comando faz uso de ambos o ficheiro disponível e das selecções do pacote.

note: type: textblock
en: Print a single package which is the target of one or more relevant pre-dependencies and has itself no unsatisfied pre-dependencies.
pt: Escreve um pacote único que é o alvo de uma ou mais pré-dependências relevantes e tem ele próprio pré-dependências não satisfeitas.

note: type: textblock
en: If such a package is present, output it as a Packages file entry, which can be massaged as appropriate.
pt: Se tal pacote estiver presente, escreve-o como uma entrada no ficheiro Packages, o qual pode ser tratado como apropriado.

note: type: textblock
en: Returns 0 when a package is printed, 1 when no suitable package is available and 2 on error.
pt: Retorna 0 quando um pacote é escrito, 1 quando nenhum pacote apropriado está disponível e 2 em caso de erro.

note: type: textblock
en: Add I<architecture> to the list of architectures for which packages can be installed without using B<--force-architecture> (since dpkg 1.16.2).  The architecture B<dpkg> is built for (i.e. the output of B<--print-architecture>)  is always part of that list.
pt: Adiciona I<architecture> à lista de arquitecturas para quais pacotes podem ser instalados sem se usar B<--force-architecture> (desde dpkg 1.16.2). A arquitectura para qual o B<dpkg> é compilado (isto é, o resultado de B<--print-architecture>)  faz sempre parte dessa lista.

note: type: textblock
en: Remove I<architecture> from the list of architectures for which packages can be installed without using B<--force-architecture> (since dpkg 1.16.2).  If the architecture is currently in use in the database then the operation will be refused, except if B<--force-architecture> is specified.  The architecture B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never be removed from that list.
pt: Remove I<architecture> da lista de arquitecturas para quais pacotes podem ser instalados sem se usar B<--force-architecture> (desde dpkg 1.16.2). Se a arquitectura estiver presentemente em uso na base de dados então a operação será recusada, excepto se B<--force-architecture> for especificado. A arquitectura para qual o B<dpkg> é compilado (isto é, o resultado de B<--print-architecture>)  nunca pode ser removida dessa lista.

note: type: textblock
en: Print architecture of packages B<dpkg> installs (for example, “i386”).
pt: Escreve a arquitectura dos pacotes que o B<dpkg> instala (por exemplo , “i386”).

note: type: textblock
en: Print a newline-separated list of the extra architectures B<dpkg> is configured to allow packages to be installed for (since dpkg 1.16.2).
pt: Escreve uma lista, com separação por novas linhas, de arquitecturas extra que o B<dpkg> tem configurado para permitir instalar pacotes para elas (desde dpkg 1.16.2).

note: type: textblock
en: Give help about the B<--assert->I<feature> options (since dpkg 1.21.0).
pt: Oferece ajuda acerca das opções B<--assert->I<feature> (desde dpkg 1.21.0).

note: type: textblock
en: Asserts that B<dpkg> supports the requested feature.  Returns 0 if the feature is fully supported, 1 if the feature is known but B<dpkg> cannot provide support for it yet, and 2 if the feature is unknown.  The current list of assertable features is:
pt: Afirma que o B<dpkg> suporta a funcionalidade requerida. Retorna 0 se a funcionalidade é totalmente suportada. 1 se a funcionalidade é conhecida mas o B<dpkg> ainda não pode suporta-la, e 2 se a funcionalidade é desconhecida. A lista actual de funcionalidades afirmáveis é:

note: type: textblock
en: Supports the B<Pre-Depends> field (since dpkg 1.1.0).
pt: Suporta o campo B<Pre-Depends> (desde dpkg 1.1.0).

note: type: textblock
en: Supports epochs in version strings (since dpkg 1.4.0.7).
pt: Suporta épocas em strings de versão (desde dpkg 1.4.0.7).

note: type: textblock
en: Supports long filenames in L<deb(5)> archives (since dpkg 1.4.1.17).
pt: Suporta nomes de ficheiros longos em arquivos L<deb(5)> (desde dpkg 1.4.1.17).

note: type: textblock
en: Supports multiple B<Conflicts> and B<Replaces> (since dpkg 1.4.1.19).
pt: Suporta múltiplos B<Conflicts> e B<Replaces> (desde dpkg 1.4.1.19).

note: type: textblock
en: Supports multi-arch fields and semantics (since dpkg 1.16.2).
pt: Suporta campos multi-arch e semânticas (desde dpkg 1.16.2).

note: type: textblock
en: Supports versioned B<Provides> (since dpkg 1.17.11).
pt: Suporta B<Provides> com versão  (desde dpkg 1.17.11).

note: type: textblock
en: Supports the B<Protected> field (since dpkg 1.20.1).
pt: Suporta o campo B<Protected> (desde dpkg 1.20.1).

note: type: textblock
en: Validate that the I<thing> I<string> has a correct syntax (since dpkg 1.18.16).  Returns 0 if the I<string> is valid, 1 if the I<string> is invalid but might be accepted in lax contexts, and 2 if the I<string> is invalid.  The current list of validatable I<thing>s is:
pt: Valida que a I<thing> I<string> tem a sintaxe correcta (desde dpkg 1.18.16). Retorna 0 se a I<string> for válida, 1 se a I<string> é inválida mas pode ser aceite em contextos lax, e 2 se a I<string> é inválida. A lista actual de I<thing> validáveis é:

note: type: textblock
en: Validates the given package name (since dpkg 1.18.16).
pt: Valida o nome de pacote fornecido (desde dpkg 1.18.16).

note: type: textblock
en: Validates the given trigger name (since dpkg 1.18.16).
pt: Valida o nome de gatinho fornecido (desde dpkg 1.18.16).

note: type: textblock
en: Validates the given architecture name (since dpkg 1.18.16).
pt: Valida o nome de arquitectura fornecido (desde dpkg 1.18.16).

note: type: textblock
en: Validates the given version (since dpkg 1.18.16).
pt: Valida a versão fornecida (desde dpkg 1.18.16).

note: type: textblock
en: Compare version numbers, where I<op> is a binary operator.  B<dpkg> returns true (B<0>) if the specified condition is satisfied, and false (B<1>) otherwise.  There are two groups of operators, which differ in how they treat an empty I<ver1> or I<ver2>.  These treat an empty version as earlier than any version: B<lt le eq ne ge gt>.  These treat an empty version as later than any version: B<lt-nl le-nl ge-nl gt-nl>.  These are provided only for compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>>.  The B<E<lt>> and B<E<gt>> operators are obsolete and should B<not> be used, due to confusing semantics.  To illustrate: B<0.1 E<lt> 0.1> evaluates to true.
pt: Compara números de versão, onde I<op> é um operador binário. B<dpkg> retorna verdadeiro (B<0>) se a condição especificada for satisfeita, e falso (B<1>) caso contrário. Existe dois grupos de operadores, que diferem em como eles tratam um I<ver1> ou I<ver2> vazio. Estes tratam uma versão vazia mais cedo que qualquer versão: B<lt le eq ne ge gt>. Estes tratam uma versão vazia mais tarde que qualquer versão: B<lt-nl le-nl ge-nl gt-nl>. Estes são fornecidos apenas para compatibilidade com sintaxe de ficheiros de controle: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>>. Os operadores B<E<lt>> e B<E<gt>> estão obsoletos e B<não> devem ser usados, devido a semânticas confusas. Para ilustrar: B<0.1 E<lt> 0.1> avalia para verdadeiro.

note: type: =end
en: disabled
pt: desactivado

note: type: textblock
en: Accept a series of commands on input file descriptor I<n>.
pt: Aceita uma série de comandos no descritor de ficheiro de entrada I<n>.

note: type: textblock
en: B<Note>: Additional options set on the command line, and through this file descriptor, are not reset for subsequent commands executed during the same run.
pt: B<Nota>: Opções adicionais definidas na linha de comandos, e através deste descritor de ficheiro, não são reposições para comandos subsequentes executados durante a mesma corrida.

note: type: textblock
en: Display a brief help message.
pt: Mostra uma mensagem de ajuda breve.

note: type: textblock
en: Give help about the B<--force->I<thing> options.
pt: Oferece ajuda acerca das opções B<--force->I<qualquer-coisa>.

note: type: textblock
en: Give help about debugging options.
pt: Oferece ajuda acerca de opções de depuração.

note: type: textblock
en: Display B<dpkg> version information.
pt: Mostra informação de versão do B<dpkg>.

note: type: textblock
en: When used with B<--robot>, the output will be the program version number in a dotted numerical format, with no newline.
pt: Quando usado com B<--robot>, o resultado será o número de versão de programa num formato numérico pontuado, sem nenhuma nova linha.

note: type: textblock
en: See L<dpkg-deb(1)> for more information about the following actions, and other actions and options not exposed by the B<dpkg> front-end.
pt: Veja L<dpkg-deb(1)> para mais informações acerca das seguintes acções, e outras acções e opções não expostas pelo front-end do B<dpkg>.

note: type: textblock
en: Build a deb package.
pt: Compila um pacote deb.

note: type: textblock
en: List contents of a deb package.
pt: Lista o conteúdo de um pacote deb.

note: type: textblock
en: Extract control-information from a package.
pt: Extrai informação-controle de um pacote.

note: type: textblock
en: Extract the files contained by package.
pt: Extrai os ficheiros contidos por um pacote.

note: type: textblock
en: Extract and display the filenames contained by a package.
pt: Extrai e mostra os nomes de ficheiros contidos por um pacote.

note: type: textblock
en: Display control field(s) of a package.
pt: Mostra campo(s) de controle de um pacote.

note: type: textblock
en: Output the control tar-file contained in a Debian package.
pt: Resulta o ficheiro tar de controle contido num pacote Debian.

note: type: textblock
en: Output the filesystem tar-file contained by a Debian package.
pt: Resulta o ficheiro tar de sistema de ficheiros contido num pacote Debian.

note: type: textblock
en: Show information about a package.
pt: Mostra informação acerca de um pacote.

note: type: textblock
en: See L<dpkg-query(1)> for more information about the following actions, and other actions and options not exposed by the B<dpkg> front-end.
pt: Veja L<dpkg-query(1)> para mais informações acerca das seguintes acções, e outras acções e opções não expostas pelo front-end do B<dpkg>.

note: type: textblock
en: List packages matching given pattern.
pt: Lista pacotes que correspondem ao padrão dado.

note: type: textblock
en: Report status of specified package.
pt: Reporta estado do pacote especificado.

note: type: textblock
en: List files installed to your system from I<package-name>.
pt: Lista ficheiros instalados no seu sistema a partir de I<package-name>.

note: type: textblock
en: Search for a filename from installed packages.
pt: Procura por um nome de ficheiro a partir de pacotes instalados.

note: type: textblock
en: Display details about I<package-name>, as found in I<%ADMINDIR%/available>.  Users of APT-based frontends should use B<apt show> I<package-name> instead.
pt: Mostra detalhes acerca de I<package-name>, como encontrado em I<%ADMINDIR%/available>. Os utilizadores de frontends baseados no APT devem usar B<apt show> I<package-name> em vez disto.

note: type: textblock
en: All options can be specified both on the command line and in the B<dpkg> configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration directory I<%PKGCONFDIR%/dpkg.cfg.d/>.  Each line in the configuration file is either an option (exactly the same as the command line option but without leading hyphens) or a comment (if it starts with a ‘B<#>’).
pt: Todas as opções pode ser especificadas em ambos linha de comandos e no ficheiro de configuração do B<dpkg> I<%PKGCONFDIR%/dpkg.cfg> ou em ficheiros fragmento (com nomes a corresponder a este padrão de shell "[0-9a-zA-Z_-]*') no directório de configuração I<%PKGCONFDIR%/dpkg.cfg.d/>. Cada linha no ficheiro de configuração é ou uma opção (exatamente igual a uma opção de linha de comandos mas sem os hífens iniciais) ou um comentário (se começar com ‘B<#>’).

note: type: textblock
en: Change after how many errors B<dpkg> will abort.  The default is 50.
pt: Altera o após quantos erros o B<dpkg> irá abortar. A predefinição é 50.

note: type: textblock
en: When a package is removed, there is a possibility that another installed package depended on the removed package.  Specifying this option will cause automatic deconfiguration of the package which depended on the removed package.
pt: Quando um pacote é removido, existe a possibilidade que outro pacote instalado dependa do pacote removido. Especificar esta opção irá provocar a desconfiguração automática do pacote que dependia do pacote removido.

note: type: textblock
en: Switch debugging on.  I<octal> is formed by bitwise-ORing desired values together from the list below (note that these values may change in future releases).  B<-Dh> or B<--debug=help> display these debugging values.
pt: Liga a depuração. I<octal> é formado por valores bitwise-ORing desejados juntos da lista em baixo (note que estes valores podem mudar em lançamentos futuros). B<-Dh> ou B<--debug=help> mostram estes valores de depuração.

note: type: verbatim
en:     Number   Description
             1   Generally helpful progress information
             2   Invocation and status of maintainer scripts
            10   Output for each file processed
           100   Lots of output for each file processed
            20   Output for each configuration file
           200   Lots of output for each configuration file
            40   Dependencies and conflicts
           400   Lots of dependencies/conflicts output
         10000   Trigger activation and processing
         20000   Lots of output regarding triggers
         40000   Silly amounts of output regarding triggers
          1000   Lots of drivel about for example the dpkg/info dir
          2000   Insane amounts of drivel
pt:     Número   Descrição
             1   Informação de progresso geralmente útil
             2   Invocação e estado dos scripts do maintainer
            10   Resultado de cada ficheiro processado
           100   Montes de resultados de cada ficheiro processado
            20   Resultado para cada ficheiro de configuração
           200   Montes de resultados de cada ficheiro de configuração
            40   Dependências e conflitos
           400   Montes de resultados de dependências/conflitos
         10000   Activação de gatilhos e processamento
         20000   Montes de resultados relativos a gatilhos
         40000   Quantidades tolas de resultados relativos a gatilhos
          1000   Lotes de drivel acerca por exemplo do directório dpkg/info
          2000   Lotes tolos de drivel

note: type: textblock
en: Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some things.  I<things> is a comma separated list of things specified below.  B<--force-help> displays a message describing them.  Things marked with (*) are forced by default.
pt: Força ou recusa (B<no-force> e B<refuse> significa a mesma coisa) para fazer algumas coisas. I<things> é uma lista separada por vírgulas de coisas especificadas em baixo. B<--force-help> mostra uma mensagem que as descreve. Coisas marcadas com (*) são forçadas por predefinição.

note: type: textblock
en: Install a package, even if newer version of it is already installed.
pt: Instala um pacote, mesmo que já esteja instalada uma versão dele mais recente.

note: type: textblock
en: B<Warning>: At present B<dpkg> does not do any dependency checking on downgrades and therefore will not warn you if the downgrade breaks the dependency of some other package.  This can have serious side effects, downgrading essential system components can even make your whole system unusable.  Use with care.
pt: I<Aviso>: Presentemente o B<dpkg> não efetua nenhuma verificação de dependência em downgrades e por isso não irá avisa-lo se o downgrade quebrar a dependência de algum outro pacote. Isto pode ter sérios efeitos secundários, o downgrade de componentes essenciais do sistema pode até inutilizar todo o seu sistema. Use com cuidado.

note: type: textblock
en: Configure also any unpacked but unconfigured packages on which the current package depends.
pt: Configura também quaisquer pacotes desempacotados mas não configurados nos quais o pacote actual depende.

note: type: textblock
en: Allow automatic installs, upgrades or removals of packages even when marked to be on “hold”.  B<Note>: When these actions are requested explicitly, the “hold” package selection state always gets ignored.
pt: Permite instalações, actualizações e remoções automáticas mesmo quando marcado para estar em “hold”.  B<Nota>: Quando estas acções são requisitadas explicitamente, o estado "hold" de selecção de pacote é sempre ignorado.

note: type: textblock
en: Remove a package, even if it's broken and marked to require reinstallation.  This may, for example, cause parts of the package to remain on the system, which will then be forgotten by B<dpkg>.
pt: Remove um pacote, mesmo se estiver quebrado e marcado a requerer reinstalação. Isto pode, por exemplo, causar que partes do pacote fiquem no sistema, que serão depois esquecidos pelo B<dpkg>.

note: type: textblock
en: Remove, even if the package is considered protected (since dpkg 1.20.1).  Protected packages contain mostly important system boot infrastructure or are used for custom system-local meta-packages.  Removing them might cause the whole system to be unable to boot or lose required functionality to operate, so use with caution.
pt: Remove, mesmo se o pacote for considerado protegido (desde dpkg 1.20.1).  Os pacotes protegidos contêm maioritariamente a importante infraestrutura de arranque do sistema ou são usados por meta-pacotes personalizados locais-do-sistema. Remove-los pode causar que todo o sistema seja incapaz de arrancar ou perca funcionalidades requeridas para operar, portanto use com muito cuidado.

note: type: textblock
en: Remove, even if the package is considered essential.  Essential packages contain mostly very basic Unix commands, required for the packaging system, for the operation of the system in general or during boot (although the latter should be converted to protected packages instead).  Removing them might cause the whole system to stop working, so use with caution.
pt: Remove, mesmo se o pacote for considerado essencial. Os pacotes essenciais contêm maioritariamente comandos Unix mais básicos, requeridos para o sistema de empacotamento, para a operação do sistema em geral ou durante o arranque (apesar do último dever ser alterado para pacotes protegidos em vez disto). Remove-los pode causar que todo o sistema pare de funcionar, por isso use com cuidado.

note: type: textblock
en: Turn all dependency problems into warnings.  This affects the B<Pre-Depends> and B<Depends> fields.
pt: Torna todos os problemas de dependências em avisos. Isto afecta os campos B<Pre-Depends> and B<Depends>.

note: type: textblock
en: Don't care about versions when checking dependencies.  This affects the B<Pre-Depends> and B<Depends> fields.
pt: Não se interessa pelas versões quando verifica as dependências. Isto afecta os campos B<Pre-Depends> and B<Depends>.

note: type: textblock
en: Install, even if this would break another package (since dpkg 1.14.6).  This affects the B<Breaks> field.
pt: Instala, mesmo que isto danifique outro pacote (desde dpkg 1.14.6). Isto afecta o campo B<Breaks>.

note: type: textblock
en: Install, even if it conflicts with another package.  This is dangerous, for it will usually cause overwriting of some files.  This affects the B<Conflicts> field.
pt: Instala, mesmo que fique em conflito com outro pacote. Isto é perigoso, pois geralmente causa a sobreposição de alguns ficheiros. Isto afecta o campo B<Conflicts>.

note: type: textblock
en: Always install the missing conffile without prompting.  This is dangerous, since it means not preserving a change (removing) made to the file.
pt: Instala sempre o ficheiro de configuração em falta sem avisar. Isto é perigoso, pois isto significa não preservar uma alteração feita no ficheiro de configuração (removendo-a).

note: type: textblock
en: If a conffile has been modified and the version in the package did change, always install the new version without prompting, unless the B<--force-confdef> is also specified, in which case the default action is preferred.
pt: Se um ficheiro de configuração foi modificado e a versão do pacote mudou, instala sempre a nova versão sem avisar, a menos que seja também especificado B<--force-confdef>, que neste caso é preferida a acção predefinida.

note: type: textblock
en: If a conffile has been modified and the version in the package did change, always keep the old version without prompting, unless the B<--force-confdef> is also specified, in which case the default action is preferred.
pt: Se um ficheiro de configuração foi modificado e a versão do pacote mudou, mantém sempre a versão antiga sem avisar, a menos que seja também especificado B<--force-confdef>, que neste caso é preferida a acção predefinida.

note: type: textblock
en: If a conffile has been modified and the version in the package did change, always choose the default action without prompting.  If there is no default action it will stop to ask the user unless B<--force-confnew> or B<--force-confold> is also given, in which case it will use that to decide the final action.
pt: Se um conffile foi modificado e a versão no pacote alterou, escolhe sempre a acção predefinida sem perguntar. Se não existir acção predefinida irá parar para pedir ao utilizador a menos que B<--force-confnew> ou B<--force-confold> sejam também fornecidos, nesse caso irá usar isso para decidir a acção final.

note: type: textblock
en: If a conffile has been modified always offer to replace it with the version in the package, even if the version in the package did not change (since dpkg 1.15.8).  If any of B<--force-confnew>, B<--force-confold>, or B<--force-confdef> is also given, it will be used to decide the final action.
pt: Se um conffile foi modificado oferece-se sempre para o substituir pela versão no pacote, mesmo que a versão no pacote não tenha mudado (desde dpkg 1.15.8).  Se algum de B<--force-confnew>, B<--force-confold>, ou B<--force-confdef> forem também fornecidos, será usado para decidir a acção final.

note: type: textblock
en: Overwrite one package's file with another's file.
pt: Sobrescreve um ficheiro de um pacote por um ficheiro de outro.

note: type: textblock
en: Overwrite one package's directory with another's file.
pt: Sobrepõe um directório de um pacote com ficheiros de outro.

note: type: textblock
en: Overwrite a diverted file with an undiverted version.
pt: Sobrescreve a ficheiro divergido com uma versão não-divergida.

note: type: textblock
en: Do not perform safe I/O operations when unpacking (since dpkg 1.15.8.6).  Currently this implies not performing file system syncs before file renames, which is known to cause substantial performance degradation on some file systems, unfortunately the ones that require the safe I/O on the first place due to their unreliable behaviour causing zero-length files on abrupt system crashes.
pt: Não executa operações I/O seguras quando desempacota (desde dpkg 1.15.8.6). Actualmente isto implica não executar sincronismos do sistema antes de renomear ficheiros, o que é conhecido por causar uma degradação substancial de performance em alguns sistemas de ficheiros, infelizmente são esses que requerem o I/O seguro em primeiro lugar devido ao seu comportamento não fiável que provoca ficheiros de comprimento-zero em crashes abruptos do sistema.

note: type: textblock
en: I<Note>: For ext4, the main offender, consider using instead the mount option B<nodelalloc>, which will fix both the performance degradation and the data safety issues, the latter by making the file system not produce zero-length files on abrupt system crashes with any software not doing syncs before atomic renames.
pt: I<Nota>: Para ext4, o principal ofensor, considere usar a opção de montagem B<nodelalloc>, o que irá corrigir ambos a degradação de performance e os problemas de segurança de dados, o último ao tornar o sistema de ficheiros não produtor de ficheiros de zero-tamanho em crashes abruptos do sistema com qualquer software que não faça sincronismos antes de renomeações atómicas.

note: type: textblock
en: B<Warning>: Using this option might improve performance at the cost of losing data, use with care.
pt: I<Aviso>: Usar esta opção pode melhorar a performance a custo de perda de dados, use com cuidado.

note: type: textblock
en: Run maintainer scripts without L<chroot(2)>ing into B<instdir> even if the package does not support this mode of operation (since dpkg 1.18.5).
pt: Corre os scripts de maintainer sem fazer L<chroot(2)> em B<instdir> mesmo que o pacote não suporte este modo de operação (desde dpkg 1.18.5).

note: type: textblock
en: B<Warning>: This can destroy your host system, use with extreme care.
pt: I<Aviso>: Isto pode destruir o seu sistema, use com extremo cuidado.

note: type: textblock
en: Process even packages with wrong or no architecture.
pt: Processa pacotes mesmo da arquitectura errada ou sem nenhuma.

note: type: textblock
en: Process even packages with wrong versions (since dpkg 1.16.1).
pt: Processa pacotes mesmo com versões erradas (desde dpkg 1.16.1).

note: type: textblock
en: B<PATH> is missing important programs, so problems are likely.
pt: B<PATH> tem em falta programas importantes, portanto é provável haver problemas.

note: type: textblock
en: Try to (de)install things even when not root.
pt: Tenta (des)instalar coisas mesmo não sendo root.

note: type: textblock
en: Install a package even if it fails authenticity check.
pt: Instala um pacote mesmo que este falhe no teste de autenticidade.

note: type: textblock
en: Ignore dependency-checking for specified packages (actually, checking is performed, but only warnings about conflicts are given, nothing else).  This affects the B<Pre-Depends>, B<Depends> and B<Breaks> fields.
pt: Ignora verificação de dependências para pacotes específicos (na verdade, a verificação é executada, mas são apenas dados avisos sobre conflitos, nada ,mais). Isto afecta os campos B<Pre-Depends>, B<Depends> e B<Breaks>.

note: type: textblock
en: Do everything which is supposed to be done, but don't write any changes.  This is used to see what would happen with the specified action, without actually modifying anything.
pt: Faz tudo o que é suposto ser feito, mas não escreve quaisquer alterações. Isto é usado para se ver o que acontecia com uma acção específica, sem modificar nada na realidade.

note: type: textblock
en: Be sure to give B<--no-act> before the action-parameter, or you might end up with undesirable results (e.g. B<dpkg --purge foo --no-act> will first purge package “foo” and then try to purge package ”--no-act”, even though you probably expected it to actually do nothing).
pt: Certifique-se de fornecer B<--no-act> antes do parâmetro da acção, ou poderá acabar com resultados não desejáveis (ex. B<dpkg --purge foo --no-act> irá primeiro purgar o pacote "foo" e depois tentará purgar o pacote "--no-act", mesmo pensando que provavelmente não vai fazer nada).

note: type: textblock
en: Recursively handle all regular files matching pattern B<*.deb> found at specified directories and all of its subdirectories.  This can be used with B<-i>, B<-A>, B<--install>, B<--unpack> and B<--record-avail> actions.
pt: Lida recursivamente com todos os ficheiros regulares que correspondem ao padrão B<*.deb> encontrados em directórios especificados e em todos os seus sub-directórios. Isto pode ser usado com as acções B<-i>, B<-A>, B<--install>, B<--unpack> e B<--record-avail>.

note: type: textblock
en: Don't install a package if a newer version of the same package is already installed.  This is an alias of B<--refuse-downgrade>.
pt: Não instala um pacote se uma versão mais recente do mesmo pacote já estiver instalada. Isto é um nome alternativo de B<--refuse-downgrade>.

note: type: textblock
en: Set the administrative directory to I<directory>.  This directory contains many files that give information about status of installed or uninstalled packages, etc.  Defaults to «I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set.
pt: Define o directório administrativo para I<directory>. Este directório contem muitos ficheiros que fornecem informação acerca do estado de pacotes instalados ou desinstalados, etc. A predefinição é «I<%ADMINDIR%>» se B<DPKG_ADMINDIR> não estiver definido.

note: type: textblock
en: Set the installation directory, which refers to the directory where packages are to be installed.  B<instdir> is also the directory passed to L<chroot(2)> before running package's installation scripts, which means that the scripts see B<instdir> as a root directory.  Defaults to «I</>».
pt: Define o directório de instalação, o que se refere ao directório onde os pacotes vão ser instalados. B<instdir> é também o directório passado ao L<chroot(2)> antes de correr scripts de instalação dos pacotes, o que significa que os vêm B<instdir> como o directório raiz. A predefinição é «I</>».

note: type: textblock
en: Set the root directory to B<directory>, which sets the installation directory to «I<dir>» and the administrative directory to «I<dir>B<%ADMINDIR%>».
pt: Define o directório raiz para B<directory>, o que define o directório de instalação para «I<dir>» e o directório administrativo para «I<dir>B<%ADMINDIR%>».

note: type: textblock
en: Only process the packages that are selected for installation.  The actual marking is done with B<dselect> or by B<dpkg>, when it handles packages.  For example, when a package is removed, it will be marked selected for deinstallation.
pt: Apenas processa os pacotes que estão selecionados para instalação. A marcação real é feita com B<dselect> ou pelo B<dpkg>, quando lida com pacotes. Por exemplo, quando um pacote é removido, será marcado selecionado para desinstalação.

note: type: textblock
en: Don't install the package if the same version and architecture of the package is already installed.
pt: Não instala o pacote se a mesma versão e arquitectura do pacote já estiver instalada.

note: type: textblock
en: Since dpkg 1.21.10, the architecture is also taken into account, which makes it possible to cross-grade packages or install additional co-installable instances with the same version, but different architecture.
pt: Desde dpkg 1.21.10, a arquitectura é também tida em conta, o que torna possível cruzar o grau dos pacotes ou instalar instâncias co-instaláveis adicionais com a mesma versão, mas arquitectura diferente.

note: type: textblock
en: Set an invoke hook I<command> to be run via “%DPKG_DEFAULT_SHELL% -c” before or after the B<dpkg> run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, I<remove> and I<purge> actions (since dpkg 1.15.4), and I<add-architecture> and I<remove-architecture> actions (since dpkg 1.17.19).  This option can be specified multiple times.  The order the options are specified is preserved, with the ones from the configuration files taking precedence.  The environment variable B<DPKG_HOOK_ACTION> is set for the hooks to the current B<dpkg> action.
pt: Define um I<command> hook de invocação para ser corrido via “%DPKG_DEFAULT_SHELL% -c” antes ou depois de o B<dpkg> correr para as acções I<unpack>, I<configure>, I<install>, I<triggers-only>, I<remove>, e I<purge> (desde dpkg 1.15.4), e as acções I<add-architecture> e I<remove-architecture> (desde dpkg 1.17.19). Esta opção pode ser especificada várias vezes. A ordem que as opções são especificadas é preservada, com aquelas dos ficheiros de configuração a tomar precedência. A variável de ambiente B<DPKG_HOOK_ACTION> é definida para os hooks para a acção actual do B<dpkg>.

note: type: textblock
en: B<Note>: Front-ends might call B<dpkg> several times per invocation, which might run the hooks more times than expected.
pt: B<Nota>: Front-ends podem chamar B<dpkg> várias vezes por invocação, o que pode fazer correr os hooks mais vezes do que o esperado.

note: type: textblock
en: Set I<glob-pattern> as a path filter, either by excluding or re-including previously excluded paths matching the specified patterns during install (since dpkg 1.15.8).
pt: Define I<glob-pattern> como um filtro de caminho, seja por excluir ou re-incluir caminhos previamente excluídos que correspondem aos padrões especificados durante a instalação (desde dpkg 1.15.8).

note: type: textblock
en: B<Warning>: Take into account that depending on the excluded paths you might completely break your system, use with caution.
pt: I<Aviso>: Tenha em conta que ao depender de caminhos excluídos você pode danificar completamente o seu sistema, use com cuidado.

note: type: textblock
en: The glob patterns use the same wildcards used in the shell, were ‘*’ matches any sequence of characters, including the empty string and also ‘/’.  For example, «I</usr/*/READ*>» matches «I</usr/share/doc/package/README>».  As usual, ‘?’ matches any single character (again, including ‘/’).  And ‘[’ starts a character class, which can contain a list of characters, ranges and complementations.  See L<glob(7)> for detailed information about globbing.  B<Note>: The current implementation might re-include more directories and symlinks than needed, in particular when there is a more specific re-inclusion, to be on the safe side and avoid possible unpack failures; future work might fix this.
pt: Os padrões glob usam as mesmas wildcards usadas na shell, onde ‘*’ corresponde a qualquer sequência de caracteres, incluindo a string vazia e também ‘/’. Por exemplo, «I</usr/*/READ*>» corresponde a «I</usr/share/doc/package/README>».  Como normal, ‘?’ corresponde a qualquer caractere único (mais uma vez, incluindo ‘/’). E ‘[’ começa uma classe de caractere, o qual pode conter uma lista de caracteres, gamas e complementações. Veja L<glob(7)> para informação detalhada acerca de globbing. B<Nota>: A implementação actual pode re-incluir mais directivas e links simbólicos do que necessário, em particular quando existe uma re-inclusão mais específica. para estar no lado seguro e evitar possíveis falhas de desempacotamento, trabalho futuro poderá corrigir isto.

note: type: textblock
en: This can be used to remove all paths except some particular ones; a typical case is:
pt: Isto pode ser usado para remover todos os caminhos excepto alguns particulares; um caso típico é:

note: type: textblock
en: to remove all documentation files except the copyright files.
pt: para remover todos os ficheiros de documentação excepto os ficheiros de copyright.

note: type: textblock
en: These two options can be specified multiple times, and interleaved with each other.  Both are processed in the given order, with the last rule that matches a file name making the decision.
pt: Estas duas opções pode ser especificadas várias vezes, e intercaladas entre elas. Ambas são processadas na ordem fornecida, com a última regra corresponde a um nome de ficheiro a marcar a decisão.

note: type: textblock
en: The filters are applied when unpacking the binary packages, and as such only have knowledge of the type of object currently being filtered (e.g. a normal file or a directory) and have not visibility of what objects will come next.  Because these filters have side effects (in contrast to L<find(1)> filters), excluding an exact pathname that happens to be a directory object like I</usr/share/doc> will not have the desired result, and only that pathname will be excluded (which could be automatically reincluded if the code sees the need).  Any subsequent files contained within that directory will fail to unpack.
pt: Os filtros são aplicados quando se desempacota os pacotes binários, e como tal apenas têm conhecimento do tipo de objecto actualmente a ser filtrado (ex. um ficheiro normal num directório) e não têm visibilidade dos outros objetos que virão a seguir. Porque estes filtros têm efeitos secundários (em contraste aos filtros L<find(1)>), excluir um nome de caminho exacto que acontece ser um objecto directório como I</usr/share/doc> não irá ter o resultado desejado, e apenas esse nome de caminho será excluído (que poderá ser automaticamente re-incluído se o código vir a necessidade). Quaisquer ficheiros subsequentes contidos dentro desse directório irão falhar ao desempacotar.

note: type: textblock
en: B<Hint>: make sure the globs are not expanded by your shell.
pt: B<Dica>: certifique-se que os globs não são expandidos pela sua shell.

note: type: textblock
en: Sets the output format for the B<--verify> command (since dpkg 1.17.2).
pt: Define o formato dos resultados para o comando B<--verify> (desde dpkg 1.17.2).

note: type: textblock
en: The only currently supported output format is B<rpm>, which consists of a line for every path that failed any check.  These lines have the following format:
pt: O único formato de saída actualmente suportado é B<rpm>, o qual consiste de uma linha para cada caminho que falhou qualquer verificação. Estas linhas têm o seguinte formato:

note: type: textblock
en: The first 9 characters are used to report the checks result, either a literal B<missing> when the file is not present or its metadata cannot be fetched, or one of the following special characters that report the result for each check:
pt: Os primeiros 9 caracteres são usados para reportar o resultado das verificações, seja um B<missing> literal quando o ficheiro não está presente ou os seus meta-dados não puderam ser obtidos, ou um dos seguintes caracteres especiais que reportam o resultado para cada verificação:

note: type: textblock
en: Implies the check could not be done (lack of support, file permissions, etc).
pt: Implica que a verificação não pôde ser feita (falta de suporte, permissões do ficheiro, etc).

note: type: textblock
en: Implies the check passed.
pt: Implica que a verificação passou.

note: type: textblock
en: Implies a specific check failed.  The following positions and alphanumeric characters are currently supported:
pt: Implica que uma verificação especifica falhou. As seguinte posições e caracteres alfanuméricos são actualmente suportados:

note: type: textblock
en: These checks are currently not supported, will always be ‘B<?>’.
pt: Estas verificações actualmente não são suportadas, serão sempre ‘B<?>’.

note: type: textblock
en: The file mode check failed (since dpkg 1.21.0).  Because pathname metadata is currently not tracked, this check can only be partially emulated via a very simple heuristic for pathnames that have a known digest, which implies they should be regular files, where the check will fail if the pathname is not a regular file on the filesystem.  This check will currently never succeed as it does not have enough information available.
pt: A verificação de modo de ficheiro falhou (desde dpkg 1.21.0). Porque os meta-dados do nome de caminho não estão actualmente seguidos, esta verificação só pode ser parcialmente emulada via heurística muito simples para nomes de caminho que têm um resumo conhecido, o que implica que devem ser ficheiros regulares, onde a verificação irá falhar se o nome de caminho não for um ficheiro regular no sistema de ficheiros. Esta verificação nunca irá actualmente ter sucesso pois não tem informação suficiente disponível.

note: type: textblock
en: The digest check failed, which means the file contents have changed.  This is only an integrity check and should not be considered as any kind of security verification.
pt: A verificação de resumo falhou, o que significa que o conteúdo do ficheiro foi modificado. Isto é apenas uma verificação de integridade e não deve ser considerada como nenhum tipo de verificação de segurança.

note: type: textblock
en: The line is followed by a space and an attribute character.  The following attribute character is supported:
pt: A linha é seguida por um espaço e um caractere de atributo. O seguinte caractere de atributo é suportado:

note: type: textblock
en: The pathname is a conffile.
pt: O nome-de-caminho é um conffile.

note: type: textblock
en: Finally followed by another space and the pathname.
pt: Finalmente seguido por outro espaço e o nome de caminho.

note: type: textblock
en: In case the entry was of the B<missing> type, and the file was not actually present on the filesystem, then the line is followed by a space and the error message enclosed within parenthesis.
pt: No caso da entrada ser do tipo B<missing>, e o ficheiro não estava realmente presente no sistema de ficheiros, então a linha é seguida por um espaço e a mensagem de erro entre parêntesis.

note: type: textblock
en: Send machine-readable package status and progress information to file descriptor I<n>.  This option can be specified multiple times.  The information is generally one record per line, in one of the following forms:
pt: Envia o estado do pacote em linguagem de máquina e informação de progresso para o descritor de ficheiro I<n>. Esta opção pode ser especificada várias vezes. A informação é geralmente um registo por linha, em um dos seguintes formatos:

note: type: textblock
en: Package status changed; I<status> is as in the status file.
pt: Status do pacote alterado; I<status> está como no ficheiro de status.

note: type: textblock
en: An error occurred.  Any possible newlines in I<extended-error-message> will be converted to spaces before output.
pt: Ocorreu um erro. Quaisquer possíveis novas linhas em I<extended-error-message> irão ser convertidas para espaços antes do resultado.

note: type: textblock
en: User is being asked a conffile question.
pt: Está a ser perguntado ao utilizador uma questão de ficheiro de configuração.

note: type: textblock
en: Sent just before a processing stage starts.  I<stage> is one of B<upgrade>, B<install> (both sent before unpacking), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge>.
pt: Enviado apenas antes de um estado de processamento começar. I<stage> é um de B<upgrade>, B<install> (ambos enviados antes do desempacotamento), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge>.

note: type: textblock
en: Send machine-readable package status and progress information to the shell I<command>'s standard input, to be run via “%DPKG_DEFAULT_SHELL% -c” (since dpkg 1.16.0).  This option can be specified multiple times.  The output format used is the same as in B<--status-fd>.
pt: Envia o estado do pacote em linguagem de máquina e informação de progresso para a entrada standard de I<command> de shell, para ser corrido via “%DPKG_DEFAULT_SHELL% -c” (desde dpkg 1.16.0). Esta opção pode ser especificada várias vezes. O formato de resultados usado é o mesmo que em B<--status-fd>.

note: type: textblock
en: Log status change updates and actions to I<filename>, instead of the default I<%LOGDIR%/dpkg.log>.  If this option is given multiple times, the last filename is used.  Log messages are of the form:
pt: Regista actualizações de alteração de estado e acções em I<filename>, em vez da predefinição I<%LOGDIR%/dpkg.log>. Se esta opção for dada várias vezes, é usado o último nome de ficheiro. As mensagens registadas estão no formato:

note: type: textblock
en: For each dpkg invocation where I<type> is B<archives> (with a I<command> of B<unpack> or B<install>) or B<packages> (with a I<command> of B<configure>, B<triggers-only>, B<remove> or B<purge>).
pt: Para cada invocação do dpkg onde I<type> é B<archives> (com um I<command> de B<unpack> ou B<install>) ou B<packages> (com um I<command> de B<configure>, B<triggers-only>, B<remove> ou B<purge>).

note: type: textblock
en: For status change updates.
pt: Par actualizações de mudança de estado.

note: type: textblock
en: For actions where I<action> is one of B<install>, B<upgrade>, B<configure>, B<trigproc>, B<disappear>, B<remove> or B<purge>.
pt: Para acções onde I<action> é um de B<install>, B<upgrade>, B<configure>, B<trigproc>, B<disappear>, B<remove> ou B<purge>.

note: type: textblock
en: For conffile changes where I<decision> is either B<install> or B<keep>.
pt: Para alterações de conffile onde I<decision> ou é B<install> ou é B<keep>.

note: type: textblock
en: Use a machine-readable output format.  This provides an interface for programs that need to parse the output of some of the commands that do not otherwise emit a machine-readable output format.  No localization will be used, and the output will be modified to make it easier to parse.
pt: Usa um formato de resultados em linguagem máquina. Este fornece uma interface para programas que precisam de analisar os resultados de alguns dos comandos que de outro modo não emitem um formato de resultados em linguagem máquina. Nenhuma localização será usada, e os resultados serão modificados para os tornar mais fácil de analisar.

note: type: textblock
en: The only currently supported command is B<--version>.
pt: O único comando actualmente suportado é B<--version>.

note: type: textblock
en: Do not try to verify package signatures.
pt: Não tenta verificar as assinaturas dos pacotes.

note: type: textblock
en: Do not run any triggers in this run (since dpkg 1.14.17), but activations will still be recorded.  If used with B<--configure> I<package> or B<--triggers-only> I<package> then the named package postinst will still be run even if only a triggers run is needed.  Use of this option may leave packages in the improper B<triggers-awaited> and B<triggers-pending> states.  This can be fixed later by running: B<dpkg --configure --pending>.
pt: Não corre nenhum gatilho nesta execução (desde dpkg 1.14.17), mas as activações serão na mesma gravadas. Se usado com B<--configure> I<package> ou B<--triggers-only> I<package> então o postinst do pacote nomeado irá mesmo assim ser corrido mesmo que apenas seja necessário correr um gatilho. O uso desta opção pode deixar pacotes em estados B<triggers-awaited> e B<triggers-pending> impróprios. Isto pode ser corrigido mais tarde ao correr: B<dpkg --configure --pending>.

note: type: textblock
en: Cancels a previous B<--no-triggers> (since dpkg 1.14.17).
pt: Cancela um B<--no-triggers> anterior (desde dpkg 1.14.17).

note: type: textblock
en: This variable is expected to be defined in the environment and point to the system paths where several required programs are to be found.  If it's not set or the programs are not found, B<dpkg> will abort.
pt: Esta variável é esperada estar definida no ambiente e apontar para os caminhos do sistema onde vários programas requeridos se encontram. Se não estiver definida, ou os programas não forem encontrados, o B<dpkg> irá abortar.

note: type: textblock
en: If set, B<dpkg> will use it as the directory from which to read the user specific configuration file.
pt: Se definido, o B<dpkg> irá usa-lo como o directório de onde ler o ficheiro de configuração específico do utilizador.

note: type: textblock
en: If set, B<dpkg> will use it as the directory in which to create temporary files and directories.
pt: Se definido, o B<dpkg> irá usa-lo como o directório onde criar os ficheiros e directórios temporários.

note: type: textblock
en: The program B<dpkg> will execute when starting a new interactive shell, or when spawning a command via a shell.
pt: O programa que o B<dpkg> irá executar quando iniciar uma nova shell interactiva, ou quando multiplica um comando via shell.

note: type: textblock
en: The program B<dpkg> will execute when running a pager, which will be executed with «B<$SHELL -c>», for example when displaying the conffile differences.  If B<SHELL> is not set, «B<%DPKG_DEFAULT_SHELL%>» will be used instead.  The B<DPKG_PAGER> overrides the B<PAGER> environment variable (since dpkg 1.19.2).
pt: O programa que o B<dpkg> irá executar quando correr um paginador, o qual será executado com «B<$SHELL -c>», por exemplo quando mostrar as diferenças do conffile. Se B<SHELL> não estiver definida, será usado «B<%DPKG_DEFAULT_SHELL%>» em vez deste. O B<DPKG_PAGER> sobrepõe a variável de ambiente B<PAGER> (desde dpkg 1.19.2).

note: type: textblock
en: Sets the debug mask (since dpkg 1.21.10) from an octal value.  The currently accepted flags are described in the B<--debug> option.
pt: Define a máscara de depuração (desde dpkg 1.21.10) a partir dum valor octal. As bandeiras presentemente aceites estão descritas na opção B<--debug>.

note: type: textblock
en: Sets the force flags (since dpkg 1.19.5).  When this variable is present, no built-in force defaults will be applied.  If the variable is present but empty, all force flags will be disabled.
pt: Define as bandeiras de forçar (desde dpkg 1.19.5). Quando esta variável está presente, nenhuma predefinição de forçar embutida será aplicada. Se a variável esta presente mas vazia, todas as bandeiras de forçar serão desactivadas.

note: type: textblock
en: If set and the B<--admindir> or B<--root> options have not been specified, it will be used as the B<dpkg> administrative directory (since dpkg 1.20.0).
pt: Se definido e as opções B<--admindir> ou B<--root> não foram especificadas, será usado como o directório administrativo do B<dpkg> (desde dpkg 1.20.0).

note: type: textblock
en: Set by a package manager frontend to notify dpkg that it should not acquire the frontend lock (since dpkg 1.19.1).
pt: Definido pelo frontend de gestão de pacotes para notificar o dpkg que não deve adquirir o bloqueio do frontend (desde dpkg 1.19.1).

note: type: textblock
en: Defined by B<dpkg> to “B<-FRSXMQ>”, if not already set, when spawning a pager (since dpkg 1.19.2).  To change the default behavior, this variable can be preset to some other value including an empty string, or the B<PAGER> or B<DPKG_PAGER> variables can be set to disable specific options with «B<-+>», for example B<DPKG_PAGER="less -+F">.
pt: Definido pelo B<dpkg> para “B<-FRSXMQ>”, Se não já definido, quando cria um paginador (desde dpkg 1.19.2). Para modificar o comportamento predefinido, esta variável por ser pré-ajustada para qualquer outro valor incluindo uma string vazia, ou as variáveis B<PAGER> ou B<DPKG_PAGER> podem ser definidas para desactivar opções específicas com «B<-+>», por exemplo B<DPKG_PAGER="less -+F">.

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to indicate which installation to act on (since dpkg 1.18.5).  The value is intended to be prepended to any path maintainer scripts operate on.  During normal operation, this variable is empty.  When installing packages into a different B<instdir>, B<dpkg> normally invokes maintainer scripts using L<chroot(2)> and leaves this variable empty, but if B<--force-script-chrootless> is specified then the L<chroot(2)> call is skipped and B<instdir> is non-empty.
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para indicar em qual instalação devem actuar (desde 1.18.5). O valor destina-se a ser adicionado ao inicio de qualquer caminho em que os scripts de maintainer operam. Durante uma operação normal, esta variável está vazia. Ao instalar pacotes numa B<instdir> diferente, o B<dpkg> normalmente invoca scripts do maintainer usando L<chroot(2)> e deixa esta variável vazia, mas se B<--force-script-chrootless> for especificado então a chamada L<chroot(2)> é saltada e B<instdir> fica não-vazia.

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to indicate the B<dpkg> administrative directory to use (since dpkg 1.16.0).  This variable is always set to the current B<--admindir> value.
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para indicar o directório administrativo do B<dpkg> a usar (desde dpkg 1.16.0). Esta variável está sempre definida para o valor actual B<--admindir>.

note: type: textblock
en: Defined by B<dpkg> on the subprocesses environment to all the currently enabled force option names separated by commas (since dpkg 1.19.5).
pt: Definido pelo B<dpkg> no ambiente de sub-processos para todos os nomes de opções de forçar, actualmente activos, separados por vírgulas (desde dpkg 1.19.5).

note: type: textblock
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation (since dpkg 1.15.6).  Current valid value: B<conffile-prompt>.
pt: Definido pelo B<dpkg> na shell criada no incitar do conffile para examinar a situação (desde dpkg 1.15.6). Valor válido actual: B<conffile-prompt>.

note: type: textblock
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation (since dpkg 1.15.6).  Contains the path to the old conffile.
pt: Definido pelo B<dpkg> na shell criada no incitar do conffile para examinar a situação (desde dpkg 115.6). Contém o caminho do conffile antigo.

note: type: textblock
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation (since dpkg 1.15.6).  Contains the path to the new conffile.
pt: Definido pelo B<dpkg> na shell criada no incitar do conffile para examinar a situação (desde dpkg 115.6). Contém o caminho do conffile novo.

note: type: textblock
en: Defined by B<dpkg> on the shell spawned when executing a hook action (since dpkg 1.15.4).  Contains the current B<dpkg> action.
pt: Definido pelo B<dpkg> na shell criada quando executa uma acção hook (desde dpkg 1.15.4). Contém a acção actual do B<dpkg>.

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to the version of the currently running B<dpkg> instance (since dpkg 1.14.17).
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para a versão da instância do B<dpkg> actualmente a correr (desde dpkg 1.14.17).

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to the (non-arch-qualified) package name being handled (since dpkg 1.14.17).
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para o nome do pacote (qualificado-não-arquitectura) a ser manuseado (desde dpkg 1.14.17).

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to the package reference count, i.e. the number of package instances with a state greater than B<not-installed> (since dpkg 1.17.2).
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para a contagem de referência de pacotes, isto é, o número de instâncias de pacotes com um estado maior que B<not-installed> (desde dpkg 1.17.2).

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to the architecture the package got built for (since dpkg 1.15.4).
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para a arquitectura que o pacote foi compilado (desde dpkg 1.15.4).

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to the name of the script running, one of B<preinst>, B<postinst>, B<prerm> or B<postrm> (since dpkg 1.15.7).
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para o nome do script a correr, um de B<preinst>, B<postinst>, B<prerm> or B<postrm> (desde dpkg 1.15.7).

note: type: textblock
en: Defined by B<dpkg> on the maintainer script environment to a value (‘B<0>’ or ‘B<1>’) noting whether debugging has been requested (with the B<--debug> option) for the maintainer scripts (since dpkg 1.18.4).
pt: Definido pelo B<dpkg> no ambiente de scripts do maintainer para um valor (‘B<0>’ ou ‘B<1>’) que indica se a depuração foi requisitada (com a opção B<--debug>) para os scripts do maintainer (desde dpkg 1.18.4).

note: type: textblock
en: Configuration fragment files (since dpkg 1.15.4).
pt: Ficheiros de fragmentos de configuração (desde dpkg 1.15.4).

note: type: textblock
en: Configuration file with default options.
pt: Ficheiro de configuração com as opções predefinidas.

note: type: textblock
en: Default log file (see I<%PKGCONFDIR%/dpkg.cfg> and option B<--log>).
pt: Ficheiro de relatório predefinido (veja I<%PKGCONFDIR%/dpkg.cfg> e a opção B<--log>).

note: type: textblock
en: The other files listed below are in their default directories, see option B<--admindir> to see how to change locations of these files.
pt: Os outros ficheiros listados em baixo estão nos seus directórios predefinidos, veja a opção B<--admindir> para saber como modificar as localizações destes ficheiros.

note: type: textblock
en: List of available packages.
pt: Lista dos pacotes disponíveis.

note: type: textblock
en: Statuses of available packages.  This file contains information about whether a package is marked for removing or not, whether it is installed or not, etc.  See section L</INFORMATION ABOUT PACKAGES> for more info.
pt: Estados dos pacotes disponíveis. Este ficheiro contem informação acerca de se um pacote está marcado para remoção ou não, se está instalado ou não, etc. Veja a secção L</INFORMAÇÃO ACERCA DE PACOTES> para mais informação.

note: type: textblock
en: The status file is backed up daily in I<%BACKUPSDIR%>.  It can be useful if it's lost or corrupted due to filesystems troubles.
pt: O ficheiro status é salvaguardado diariamente em I<%BACKUPSDIR%>. Pode ser útil se for perdido ou corrompido devido a problemas com o sistema de ficheiros.

note: type: textblock
en: The format and contents of a binary package are described in L<deb(5)>.
pt: O formato e conteúdo de um pacote binário está descrito em L<deb(5)>.

note: type: =head2
en: Filesystem filenames
pt: Nomes de ficheiros do sistema de ficheiros

note: type: textblock
en: During unpacking and configuration B<dpkg> uses various filenames for backup and rollback purposes.  The following is a simplified explanation of how these filenames get used during package installation.
pt: Durante o desempacotar e configurar o B<dpkg> usa vários nomes de ficheiros para objectivos de salvaguarda e reposição. O seguinte é uma explicação simplificada de como estes nomes de ficheiros são usados durante a instalação de um pacote.

note: type: textblock
en: During unpack, B<dpkg> extracts new filesystem objects into I<pathname>B<.dpkg-new> (except for existing directories or symlinks to directories which get skipped), once that is done and after having performed backups of the old objects, the objects get renamed to I<pathname>.
pt: Durante o desempacotar. o B<dpkg> extrai os novos objectos do sistema de ficheiros em I<pathname>B<.dpkg-new> (excepto para directórios existentes ou links simbólicos a directórios que são saltados), após isso estar feito e após ter feito salvaguardas dos objectos antigos, os objectos são renomeados para I<pathname>.

note: type: textblock
en: During unpack, B<dpkg> makes backups of the old filesystem objects into I<pathname>B<.dpkg-tmp> after extracting the new objects.  These backups are performed as either a rename for directories (but only if they switch file type), a new symlink copy for symlinks, or a hard link for any other filesystem object, except for conffiles which get no backups because they are processed at a later stage.
pt: Durante o desempacotar. o B<dpkg> cria salvaguardas dos antigos objectos do sistema de ficheiros em I<pathname>B<.dpkg-tmp> após extrair os novos objectos. Estas salvaguardas são executadas seja ou ao renomear os directórios (mas apenas se mudarem de tipo de ficheiro), uma nova cópia de link simbólico para os links simbólicos, ou um hard link para qualquer outro objecto de sistema de ficheiros, excepto para ficheiros de configuração os quais não têm salvaguardas porque serão processados num estágio posterior.

note: type: textblock
en: In case of needing to rollback, these backups get used to restore the previous contents of the objects.  These get removed automatically after the installation is complete.
pt: No caso de necessidade de reposição, estas salvaguardas são usadas para restaurar os conteúdos anteriores dos objectos. Estas são removidas automaticamente após a instalação estar completa.

note: type: textblock
en: During configuration, when installing a new version, B<dpkg> can make a backup of the previous modified conffile into I<pathname>B<.dpkg-old>.
pt: Durante a configuração, quando instala a nova versão, o B<dpkg> consegue fazer uma salvaguarda do ficheiro de configuração modificado anteriormente em I<pathname>B<.dpkg-old>.

note: type: textblock
en: During configuration, when keeping the old version, B<dpkg> can make a backup of the new unmodified conffile into I<pathname>B<.dpkg-dist>.
pt: Durante a configuração, e ao manter a versão antiga, o B<dpkg> consegue fazer uma salvaguarda do novo ficheiro de configuração não modificado em I<pathname>B<.dpkg-dist>.

note: type: textblock
en: Any operation that needs write access to the database or the filesystem is considered a privileged operation that might allow root escalation.  These operations must never be delegated to an untrusted user or be done on untrusted packages, as that might allow root access to the system.
pt: Qualquer operação que precise de acesso de escrita à base de dados ou ao sistema de ficheiro é considerada uma operação privilegiada que pode permitir escalada a root. Estas operações nunca devem ser delegadas a um utilizador não-confiável ou serem feitas em pacotes não-confiáveis, pois isso pode permitir acesso de root ao sistema.

note: type: textblock
en: Some operations (such as package verification) might need root privileges to be able to access files on the filesystem that would otherwise be inaccessible due to restricted permissions, but should otherwise work normally and produce appropriate messages in those cases.
pt: Algumas operações (tais como verificação do pacote) podem precisar de privilégios de root para serem capazes de aceder a ficheiros no sistema de ficheiros que caso contrário seriam inacessíveis devido a restrição de permissões, mas por outro lado devem funcionar normalmente e produzir mensagens apropriadas nesses casos.

note: type: textblock
en: See also the B<SECURITY> section of the L<dpkg-deb(1)> and L<dpkg-split(1)> manual pages.
pt: Veja também a secção B<SECURITY> dos manuais L<dpkg-deb(1)> e L<dpkg-split(1)>.

note: type: textblock
en: B<--no-act> usually gives less information than might be helpful.
pt: B<--no-act> geralmente dá menos informação do que poderia ser útil.

note: type: textblock
en: To list installed packages related to the editor L<vi(1)> (note that B<dpkg-query> does not load the I<available> file anymore by default, and the B<dpkg-query> B<--load-avail> option should be used instead for that):
pt: Para listar pacotes instalados relacionados com o editor L<vi(1)> (note que B<dpkg-query> já não carrega o ficheiro I<available> por predefinição, e para isso deve ser usada a opção B<dpkg-query> B<--load-avail>):

note: type: textblock
en: To see the entries in I<%ADMINDIR%/available> of two packages:
pt: Para ver as entradas em I<%ADMINDIR%/available> de dois pacotes:

note: type: textblock
en: To search the listing of packages yourself:
pt: Para procurar você próprio na listagem de pacotes:

note: type: textblock
en: To remove an installed neovim package:
pt: Para remover um pacote neovim instalado:

note: type: textblock
en: To install a package, you first need to find it in an archive or media disc.  When using an archive based on a pool structure, knowing the archive area and the name of the package is enough to infer the pathname:
pt: Para instalar um pacote, primeiro você precisa de encontra-lo num arquivo ou disco de media. Quando se usa um arquivo baseado numa estrutura pool, conhecer a área do arquivo e o nome do pacote é suficiente para inferir o nome de de caminho:

note: type: textblock
en: To make a local copy of the package selection states:
pt: Para fazer uma cópia local do estado de selecção de pacotes:

note: type: textblock
en: You might transfer this file to another computer, and after having updated the I<available> file there with your package manager frontend of choice (see L<https://wiki.debian.org/Teams/Dpkg/FAQ#set-selections> for more details), for example:
pt: Você poderá transferir este ficheiro para outro computador, e depois de ter actualizado lá o ficheiro I<available> com o seu frontend elegido de gestão de pacotes (veja L<https://wiki.debian.org/Teams/Dpkg/FAQ#set-selections> para mais detalhes), por exemplo:

note: type: textblock
en: you can install it with:
pt: você pode instala-lo com:

note: type: textblock
en: Note that this will not actually install or remove anything, but just set the selection state on the requested packages.  You will need some other application to actually download and install the requested packages.  For example, run B<apt-get dselect-upgrade>.
pt: Note que isto não irá realmente instalar ou remover nada, mas apenas definir o estado de selecção nos pacotes requeridos. Você irá precisar de alguma outra aplicação para realmente descarregar e instalar os pacotes requeridos. Por exemplo, correr B<apt-get dselect-upgrade>.

note: type: textblock
en: Ordinarily, you will find that L<dselect(1)> provides a more convenient way to modify the package selection states.
pt: Normalmente, você irá descobrir que o L<dselect(1)> fornece um método mais conveniente de modificar os estados de selecção de pacotes.

note: type: =head1
en: ADDITIONAL FUNCTIONALITY
pt: FUNCIONALIDADES ADICIONAIS

note: type: textblock
en: Additional functionality can be gained by installing any of the following packages: B<apt>, B<aptitude> and B<debsig-verify>.
pt: Podem ser ganhas funcionalidades adicionais ao instalar qualquer um dos seguintes pacotes: B<apt>, B<aptitude> e B<debsig-verify>.

note: type: textblock
en: L<aptitude(8)>, L<apt(8)>, L<dselect(1)>, L<dpkg-deb(1)>, L<dpkg-query(1)>, L<deb(5)>, L<deb-control(5)>, L<dpkg.cfg(5)>, and L<dpkg-reconfigure(8)>.
pt: L<aptitude(8)>, L<apt(8)>, L<dselect(1)>, L<dpkg-deb(1)>, L<dpkg-query(1)>, L<deb(5)>, L<deb-control(5)>, L<dpkg.cfg(5)>, e L<dpkg-reconfigure(8)>.

note: type: =head1
en: AUTHORS
pt: AUTORES

note: type: textblock
en: See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to B<dpkg>.
pt: Veja I<%PKGDOCDIR%/THANKS> para a lista de pessoas que contribuíram para o B<dpkg>.

note: type: textblock
en: dsc - Debian source package control file format
pt: dsc - formato Debian de ficheiro de controle de pacotes fonte

note: type: textblock
en: Each Debian source package is composed of a .dsc control file, which contains a number of fields, in L<deb822(5)> format.
pt: Cada pacote fonte Debian é composto de um ficheiro .dsc, o qual contém um número de campos, em formato L<deb822(5)>.

note: type: textblock
en: Each field begins with a tag, such as B<Source> or B<Binary> (case insensitive), followed by a colon, and the body of the field (case sensitive unless stated otherwise).  Fields are delimited only by field tags.  In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in case of the multiline fields B<Package-List>, B<Files>, B<Checksums-Sha1> and B<Checksums-Sha256>, see below).
pt: Cada campo começa com uma etiqueta, tal como B<Source> ou B<Binary> (insensível a maiúsculas/minúsculas), seguida do símbolo dois pontos, e o corpo do campo (sensível a maiúsculas/minúsculas a menos que declarado o contrário). Os campos são delimitados apenas por etiquetas de campos. Por outras palavras, o texto do campo pode ter várias linhas de comprimento, mas as ferramentas de instalação irão geralmente juntar as linhas quando processam o corpo do campo (excepto no caso de B<Package-List>, B<Files>, B<Checksums-Sha1> e B<Checksums-Sha256> de múltiplos campos, ver abaixo).

note: type: textblock
en: The value of this field declares the format version of the source package.  The field value is used by programs acting on a source package to interpret the list of files in the source package and determine how to unpack it.  The syntax of the field value is a numeric major revision (“0-9”), a period (“.”), a numeric minor revision (“0-9”), and then an optional subtype after whitespace (“ \t”), which if specified is a lowercase alphanumeric (“a-z0-9”) word in parentheses (“()”).  The subtype is optional in the syntax but may be mandatory for particular source format revisions.
pt: O valor deste campo declara a versão de formato do pacote fonte. O valor do campo é usado por programas que actuam no pacote fonte para interpretar a lista de ficheiros no pacote fonte e determinar como desempacota-los. A sintaxe do valor do campo é uma revisão maior numérica (“0-9”), um ponto (“.”), uma revisão menor numérica (“0-9”), e depois um subtipo opcional após um espaço em branco (“ \t”), o qual é especificado numa palavra alfanumérica em minúsculas (“a-z0-9”) em parêntesis (“()”).  O subtipo é opcional na sintaxe mas pode ser obrigatória para revisões particulares de formato fonte.

note: type: textblock
en: The source formats currently supported by B<dpkg> are B<1.0>, B<2.0>, B<3.0 (native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> and B<3.0 (custom)>.  See L<dpkg-source(1)> for their description.
pt: Os formatos fonte actualmente suportados pelo B<dpkg> são B<1.0>, B<2.0>, B<3.0 (native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> e B<3.0 (custom)>. Veja L<dpkg-source(1)> para as suas descrições.

note: type: =item
en: B<Source:> I<source-name> (required)
pt: B<Source:> I<source-name> (necessário)

note: type: textblock
en: This folded field lists binary packages which this source package can produce, separated by commas.
pt: Este campo dobrado lista pacotes binários, separados por vírgulas, que este pacote fonte pode produzir.

note: type: textblock
en: This field has now been superseded by the B<Package-List> field, which gives enough information about what binary packages are produced on which architecture, build-profile and other involved restrictions.
pt: Este campo está agora a ser suplantado pelo campo B<Package-List>, o qual fornece informação suficiente sobre que pacotes binários são produzidos em qual arquitectura, perfil de compilação e outras restrições envolvidas.

note: type: =item
en: B<Architecture:> I<arch-list> (recommended)
pt: B<Architecture:> I<arch-list> (recomendado)

note: type: textblock
en: A list of architectures and architecture wildcards separated by spaces which specify the type of hardware this package can be compiled for.  Common architecture names and architecture wildcards are B<amd64>, B<armel>, B<i386>, B<linux-any>, B<any-amd64>, etc.
pt: Uma lista de arquitecturas e wildcards de arquitecturas separadas por espaços que especificam o tipo de hardware para o qual este pacote por ser compilado. Nomes de arquitecturas comuns são B<amd64>, B<armel>, B<i386>, B<linux-any>, B<any-amd64>, etc.

note: type: textblock
en: Note that the B<all> value is meant for packages that are architecture independent, and B<any> for packages that are architecture dependent.  The list may include (or consist solely of) the special value B<all>.  When the list contains the architecture wildcard B<any>, the only other value allowed in the list is B<all>.
pt: Note que o valor B<all> destina-se a pacotes que são independentes da arquitectura, e B<any> a pacotes que são dependentes da arquitectura. A lista pode incluir (ou consistir apenas de) o valor especial B<all>.  Quando a lista contem a wildcard de arquitectura B<any>, o outro único valor permitido na lista é B<all>.

note: type: textblock
en: The field value is generally generated from B<Architecture> fields from in the I<debian/control> in the source package.
pt: O valor do campo é geralmente gerado a partir de campos B<Architecture> a partir de I<debian/control> no pacote fonte.

note: type: =item
en: B<Standards-Version:> I<version-string> (recommended)
pt: B<Standards-Version:> I<version-string> (recomendado)

note: type: textblock
en: These fields declare the I<url> of the Version Control System repository used to maintain this package.  See L<deb-src-control(5)> for more details.
pt: Estes campos declaram o I<url> do repositório do Sistema de Controle de Versão usado para manter este pacote. Veja L<deb-src-control(5)> para mais detalhes.

note: type: textblock
en: This field declares that the source package contains the specified test suites.  The value is a comma-separated list of test suites.  If the B<autopkgtest> value is present, a I<debian/tests/control> is expected to be present, if the file is present but not the value, then B<dpkg-source> will automatically add it, preserving previous values.
pt: Este campo declara que o pacote fonte contem as suites de teste especificadas. O valor é uma lista de suites de teste separadas por vírgulas. Se o valor B<autopkgtest> estiver presente, espera-se a presença de um I<debian/tests/control>, se o ficheiro está presente mas não o valor, então B<dpkg-source> irá automaticamente adiciona-lo, preservando valores anteriores.

note: type: textblock
en: This field declares the comma-separated union of all test dependencies (B<Depends> fields in I<debian/tests/control> file), with all restrictions removed, and OR dependencies flattened (that is, converted to separate AND relationships), except for binaries generated by this source package and its meta-dependency equivalent B<@>.
pt: Este campo declara a união de todas as dependências de todos os testes, separadas por espaços (campos B<Depends> no ficheiro I<debian/tests/control>), com todas as restrições removidas, e dependências OU achatadas (isto é, convertidas para relações E separadas), excepto para binários gerados por este pacote fonte e seus equivalentes de meta-dependência B<@>.

note: type: textblock
en: B<Rationale>: this field is needed because otherwise to be able to get the test dependencies, each source package would need to be unpacked.
pt: B<Fundamento>: este campo é necessário porque caso contrário, para puderem obter as dependências de teste, cada pacote fonte teria que ser desempacotado.

note: type: textblock
en: These fields declare relationships between the source package and packages used to build it.  They are discussed in the L<deb-src-control(5)> manual page.
pt: Estes campos declaram relacionamentos entre o pacote fonte e pacotes usados para o construir. Eles são discutidos no manual L<deb-src-control(5)>.

note: type: textblock
en: This multiline field contains a list of binary packages generated by this source package.
pt: Este campo multi-linha contem uma lista de pacotes binários gerados por este pacote fonte.

note: type: textblock
en: The I<package> is the binary package name.
pt: O I<package> é o nome do pacote binário.

note: type: textblock
en: The I<package-type> is the binary package type, usually B<deb>, another common value is B<udeb>.
pt: O I<package-type> é o tipo de pacote binário, normalmente B<deb>, outro valor comum é B<udeb>.

note: type: textblock
en: The I<section> and I<priority> match the binary package fields of the same name.
pt: I<section> e I<priority> correspondem aos campos do pacote binário do mesmo nome.

note: type: textblock
en: The I<key-value-list> is a space separated I<key>B<=>I<value> list, and the currently known optional keys are:
pt: A I<key-value-list> é uma lista is de I<key>B<=>I<value> separados por espaços, a as chaves opcionais actualmente conhecidas são:

note: type: textblock
en: The architecture restriction from the binary package B<Architecture> field, with spaces converted to ‘,’.
pt: A restrição de arquitectura do campo B<Architecture> do pacote binário, com espaços convertidos para ‘,’.

note: type: textblock
en: The normalized build-profile restriction formula from the binary package B<Build-Profile> field, with ORs converted to ‘+’ and ANDs to ‘,’.
pt: A fórmula de restrição do perfil-de-compilação normalizada a partir do campo B<Build-Profile> do pacote binário, com os ORs convertidos para ‘+’ e os ANDs para ‘,’.

note: type: textblock
en: If the binary package is protected, this key will contain the value of the B<Protected> field, that is a B<yes> value.
pt: Se o pacote binário for protegido, esta chave irá conter o valor do campo B<Protected>, que é um valor B<yes>.

note: type: textblock
en: If the binary package is essential, this key will contain the value of the B<Essential> field, that is a B<yes> value.
pt: Se o pacote binário for essencial,esta chave ir+a conter o valor do campo B<Essential>, que é um valor B<yes>.

note: type: textblock
en: These multiline fields contain a list of files with a checksum and size for each one.  These fields have the same syntax and differ only in the checksum algorithm used: MD5 for B<Files>, SHA-1 for B<Checksums-Sha1> and SHA-256 for B<Checksums-Sha256>.
pt: Estes campos multi-linha contêm uma lista de ficheiros com um sumário de verificação e tamanho para cada um deles. Estes campos têm a mesma sintaxe e diferem apenas no algoritmo de checksum usado: MD5 para B<Files>, SHA-1 para B<Checksums-Sha1> e SHA-256 para B<Checksums-Sha256>.

note: type: textblock
en: The first line of the field value (the part on the same line as the field name followed by a colon) is always empty.  The content of the field is expressed as continuation lines, one line per file.  Each line consists of the checksum, a space, the file size, a space, and the file name.
pt: A primeira linha do campo valor (a parte na mesma linha que tem o campo nome seguido de dois pontos) é sempre vazia. O conteúdo do campo é expressado como linhas de continuação, uma linha por ficheiro. Cada linha consiste do checksum, um espaço, o tamanho do ficheiro, um espaço, e o nome do ficheiro.

note: type: textblock
en: These fields list all files that make up the source package.  The list of files in these fields must match the list of files in the other related fields.
pt: Estes campos listam todos os ficheiros que fazem o pacote fonte. A lista de ficheiros nestes campos tem de corresponder à lista de ficheiros nos outros campos relacionados.

note: type: textblock
en: The B<Format> field conflates the format for the B<.dsc> file itself and the format of the extracted source package.
pt: O campo B<Format> field conflui o formato para o próprio ficheiro B<.dsc> e o formato do pacote fonte extraído.

note: type: textblock
en: dselect.cfg - dselect configuration file
pt: dselect.cfg - ficheiro de configuração do dselect

note: type: textblock
en: This file contains default options for dselect.  Each line contains a single option which is exactly the same as a normal command line option for dselect except for the leading hyphens which are not used here.  Quotes surrounding option values are stripped.  Comments are allowed by starting a line with a hash sign (‘B<#>’).
pt: Este ficheiro contém opções predefinidas para o dselect. Cada linha contém uma opção única a qual é exactamente a mesma que uma opção de linha de comandos normal para o dselect excepto pelos hífens iniciais que aqui não são usados. As citações em redor os valores das opções são retiradas. Os comentários são permitidos ao iniciar a linha com sinal cardinal (‘B<#>’).

note: type: textblock
en: dselect - Debian package management frontend
pt: dselect - frontend de gestão de pacotes Debian

note: type: textblock
en: B<dselect> is one of the primary user interfaces for managing packages on a Debian system.  At the B<dselect> main menu, the system administrator can:
pt: B<dselect> é uma das interfaces de utilizador primárias para gerir pacotes num sistema Debian. No menu principal do B<dselect>, o administrador do sistema pode:

note: type: textblock
en: Update the list of available package versions,
pt: Actualizar a lista de versões de pacotes disponíveis,

note: type: textblock
en: View the status of installed and available packages,
pt: Visualizar o estado dos pacotes instalados e disponíveis,

note: type: textblock
en: Alter package selections and manage dependencies,
pt: Alterar selecções de pacotes e gerir dependências,

note: type: textblock
en: Install new packages or upgrade to newer versions.
pt: Instalar novos pacotes ou actualiza-los para novas versões.

note: type: textblock
en: B<dselect> operates as a front-end to L<dpkg(1)>, the low-level Debian package handling tool.  It features a full-screen package selections manager with package depends and conflicts resolver.  When run with administrator privileges, packages can be installed, upgraded and removed.  Various access methods can be configured to retrieve available package version information and installable packages from package repositories.  Depending on the used access method, these repositories can be public archive servers on the internet, local archive servers or media discs.  The recommended access method is I<apt>, which is provided by the package L<apt(8)>.
pt: B<dselect> opera como um front-end para o L<dpkg(1)>, a ferramenta de baixo nível de manuseamento de pacotes de Debian. Apresenta um gestor de selecção de pacotes de ecrã-total com ferramenta de resolver dependências e conflitos de pacotes. Quando corrido com privilégios de administrador, os pacotes podem ser instalados, actualizados ou removidos. Podem ser configurados vários métodos de acesso para obter informação da versão dos pacotes disponíveis e instaláveis dos repositórios de pacotes. Dependendo do método de acesso usado, estes repositórios podem ser servidores de arquivo público na internet, servidores de arquivo local ou discos de media. O método de acesso recomendado é o I<apt>, o qual é fornecido pelo pacote L<apt(8)>.

note: type: textblock
en: Normally B<dselect> is invoked without parameters.  An interactive menu is presented, offering the user a list of commands.  If a command is given as argument, then that command is started immediately.  Several command line parameters are still available to modify the running behaviour of B<dselect> or show additional information about the program.
pt: Normalmente o B<dselect> é invocado sem parâmetros. Um menu interactivo é apresentado, oferecendo uma lista de comandos ao utilizador. Se um comando for dado como um argumento, então esse comando é arrancado imediatamente. Estão ainda disponíveis vários parâmetros de linha de comandos para modificar o comportamento de funcionamento do B<dselect> ou mostrar informação adicional acerca do programa.

note: type: textblock
en: All options can be specified both on the command line and in the B<dselect> configuration file I<%PKGCONFDIR%/dselect.cfg> or the files on the configuration directory I<%PKGCONFDIR%/dselect.cfg.d/>.  Each line in the configuration file is either an option (exactly the same as the command line option but without leading hyphens) or a comment (if it starts with a ‘B<#>’).
pt: Todas as opções podem ser especificadas tanto na linha de comandos como no ficheiro de configuração do B<dselect> I<%PKGCONFDIR%/dselect.cfg> ou nos ficheiros do directório de configuração I<%PKGCONFDIR%/dselect.cfg.d/>. Cada linha no ficheiro de configuração é ou uma opção (exactamente igual à opção de linha de comandos mas sem o hífen inicial) ou um comentário (se começar com um ‘B<#>’).

note: type: textblock
en: Changes the directory where the dpkg ‘I<status>’, ‘I<available>’ and similar files are located.  Defaults to I<%ADMINDIR%> if B<DPKG_ADMINDIR> has not been set.
pt: Muda o directório onde os ficheiros ‘I<status>’, ‘I<available>’ e semelhantes do dpkg estão localizados. A predefinição é I<%ADMINDIR%> se B<DPKG_ADMINDIR> não estiver definido.

note: type: textblock
en: Set the installation directory, which refers to the directory where packages get installed (since dpkg 1.21.2).  Defaults to «I</>» if B<DPKG_ROOT> has not been set.
pt: Define o directório de instalação, o que se refere ao directório onde os pacotes são instalados (desde dpkg 1.19.2). A predefinição é «I</>» se B<DPKG_ROOT> não estiver definido.

note: type: textblock
en: Set the root directory to I<directory>, which sets the installation directory to «I<directory>» and the administrative directory to «I<directory>%ADMINDIR%» (since dpkg 1.21.0).
pt: Define o directório raiz para I<directory>, o que define o directório de instalação para «I<directory>» e o directório administrativo para «I<directory>%ADMINDIR%>» (desde dpkg 1.21.0).

note: type: textblock
en: Turn on debugging.  Debugging information is sent to I<file>.
pt: Liga a depuração. A informação de depuração é enviada para I<ficheiro>.

note: type: textblock
en: Turns on expert mode, i.e. doesn't display possibly annoying help messages.
pt: Liga o modo de  expert, isto é, não o aborrece com mensagens de ajuda.

note: type: textblock
en: Configures screen colors.  This works only if your display supports colors.  This option may be used multiple times (and is best used in I<dselect.cfg>).  Each use changes the color (and optionally, other attributes) of one part of the screen.  The parts of the screen (from top to bottom) are:
pt: Configura as cores do ecrã. Isto só funciona se o seu ecrã suportar cores. Esta opção pode ser usada várias vezes (e é melhor usada em I<dselect.cfg>). Cada utilização muda a cor (e opcionalmente, outros atributos) de uma parte do ecrã. As partes do ecrã (do topo para fundo) são:

note: type: textblock
en: The screen title.
pt: O título do ecrã.

note: type: textblock
en: The header line above the list of packages.
pt: A linha de cabeçalho por cima da lista de pacotes.

note: type: textblock
en: The scrolling list of packages (and also some help text).
pt: A lista de pacotes com deslocamento (e também algum texto de ajuda).

note: type: textblock
en: The selected item in the list.
pt: O item seleccionado na lista.

note: type: textblock
en: In the list of packages, the text indicating the current state of each package.
pt: Na lista de pacotes, o texto indicador do estado actual de cada pacote.

note: type: textblock
en: In the list of packages, the text indicating the current state of the currently selected package.
pt: Na lista de pacotes, o texto que indica o estado actual do pacote actualmente selecionado.

note: type: textblock
en: The header line that displays the state of the currently selected package.
pt: A linha de cabeçalho que mostra o estado do pacote actualmente seleccionado.

note: type: textblock
en: The package's short description.
pt: A descrição curta do pacote.

note: type: textblock
en: Used to display package info such as the package's description.
pt: Usado para mostrar informações do pacote tal como a descrição do pacote.

note: type: textblock
en: The last line of the screen when selecting packages.
pt: A última linha do ecrã quando seleciona pacotes.

note: type: textblock
en: Used to display query lines
pt: Usado para mostrar linhas de consulta.

note: type: textblock
en: Color of help screens.
pt: Cor dos ecrãs de ajuda.

note: type: textblock
en: After the part of the screen comes a colon and the color specification.  You can specify either the foreground color, the background color, or both, overriding the compiled-in colors.  Use standard curses color names.
pt: Após a parte do ecrã vem um símbolo de dois pontos e a especificação da cor. Você pode especificar tanto a cor frontal, a cor de fundo, ou ambas, sobrepondo as cores compiladas. Usa nomes de cores standard de curses.

note: type: textblock
en: Optionally, after the color specification is another colon, and an attribute specification.  This is a list of one or more attributes, separated by plus (‘+’) characters.  Available attributes include (not all of these will work on all terminals): B<normal>, B<standout>, B<underline>, B<reverse>, B<blink>, B<bright>, B<dim>, B<bold>
pt: Opcionalmente, após a especificação da cor ficam outros dois pontos, e uma especificação de atributo. Isto é uma lista de uma ou mais atributos, separados por caracteres mais (‘+’). Atributos disponíveis incluem (nem todos estes irão trabalha em todos os terminais): B<normal>, B<standout>, B<underline>, B<reverse>, B<blink>, B<bright>, B<dim>, B<bold>

note: type: textblock
en: Print a brief help text and exit successfully.
pt: Escreve um texto de ajuda breve e termina com sucesso.

note: type: textblock
en: Print version information and exit successfully.
pt: Escreve informação de versão e termina com sucesso.

note: type: textblock
en: When B<dselect> is started it can perform the following commands, either directly if it was specified on the command line or by prompting the user with a menu of available commands if running interactively:
pt: Quando o B<dselect> é iniciado pode executar os seguintes comandos, seja directamente se foi especificado na linha de comandos ou ao questionar o utilizador com um menu de comandos disponíveis se corrido em modo interactivo:

note: type: textblock
en: Choose and configure an access method to access package repositories.
pt: Escolha e configure um método de acesso para aceder aos repositórios de pacotes.

note: type: textblock
en: By default, B<dselect> provides several methods such as I<media>, I<file> or I<ftp>, but other packages may provide additional methods, for example the I<apt> access method provided by the L<apt(8)> package.
pt: Por predefinição, B<dselect> fornece vários métodos tais como I<media>, I<file> ou I<ftp>, mas outros pacotes podem disponibilizar outros métodos, por exemplo o método de acesso I<apt> disponibilizado pelo pacote L<apt(8)>.

note: type: textblock
en: The use of the I<apt> access method is strongly recommended.
pt: O uso do método de acesso do I<apt> é fortemente recomendado.

note: type: textblock
en: Refresh the available packages database.
pt: Refresca a base de dados de pacotes disponíveis.

note: type: textblock
en: Retrieves a list of available package versions from the package repository, configured for the current access method, and update the dpkg database.  The package lists are commonly provided by the repository as files named I<Packages> or I<Packages.gz>.  These files can be generated by repository maintainers, using the program L<dpkg-scanpackages(1)>.
pt: Obtém uma lista de versões de pacotes disponíveis a partir de um repositório de pacotes, configurado para o método de acesso actual, e actualiza a base de dados do dpkg. As listas de pacotes são geralmente fornecidas pelo repositório como ficheiros chamados I<Packages> ou I<Packages.gz>. Estes ficheiros podem ser gerados por maintainers do repositório, usando o programa L<dpkg-scanpackages(1)>.

note: type: textblock
en: Details of the update command depend on the access method's implementation.  Normally the process is straightforward and requires no user interaction.
pt: Detalhes do comando de actualização dependem da implementação do método de acesso. Normalmente o processo é direto e não requer interação do utilizador.

note: type: textblock
en: View or manage package selections and dependencies.
pt: Ver ou gerir selecções de pacotes e dependências.

note: type: textblock
en: This is the main function of B<dselect>.  In the select screen, the user can review a list of all available and installed packages.  When run with administrator privileges, it is also possible to interactively change packages selection state.  B<dselect> tracks the implications of these changes to other depending or conflicting packages.
pt: Esta é a função principal do B<dselect>. no ecrã de selecção, o utilizador pode rever uma lista de todos os pacotes disponíveis e instalados. Quando corre com privilégios de administrador, é também possível alterar o estado da selecção de pacotes interactivamente. B<dselect> acompanha as implicações destas alterações com outros pacotes que dependem ou criam conflitos.

note: type: textblock
en: When a conflict or failed depends is detected, a dependency resolution subscreen is prompted to the user.  In this screen, a list of conflicting or depending packages is shown, and for each package listed, the reason for its listing is shown.  The user may apply the suggestions proposed by B<dselect>, override them, or back out all the changes, including the ones that created the unresolved depends or conflicts.
pt: Quando é detetado um conflito ou falha de dependências, é mostrado ao utilizador um sub-ecrã de resolução de dependências. Neste ecrã, é mostrada uma lista de pacotes em conflito ou dependentes, e para cada pacote listado, é mostrada a razão de este estar na lista. O utilizador pode aplicar as sugestões propostas pelo B<dselect>, sobrepor-las, ou retroceder todas as alterações, incluindo aquelas que criaram as dependências ou conflitos não resolvidos.

note: type: textblock
en: The use of the interactive package selections management screen is explained in more detail below.
pt: O uso do ecrã de gestão de selecção de pacotes interactiva está explicado com mais detalhes em baixo.

note: type: textblock
en: Installs selected packages.
pt: Instala os pacotes selecionados.

note: type: textblock
en: The configured access method will fetch installable or upgradable packages from the relevant repositories and install these using B<dpkg>.  Depending on the implementation of the access method, all packages can be prefetched before installation, or fetched when needed.  Some access methods may also remove packages that were marked for removal.
pt: O método de acesso configurado irá obter pacotes instaláveis ou actualizáveis a partir dos repositórios relevantes e instalar estes usando o B<dpkg>. Dependendo da implementação do método de acesso, todos os pacotes podem ser pré-obtidos antes da instalação, ou obtidos quando necessários. Alguns métodos de acesso podem também remover pacotes que foram marcados para remoção.

note: type: textblock
en: If an error occurred during install, it is usually advisable to run install again.  In most cases, the problems will disappear or be solved.  If problems persist or the installation performed was incorrect, please investigate into the causes and circumstances, and file a bug in the Debian bug tracking system.  Instructions on how to do this can be found at L<https://bugs.debian.org/> or by reading the documentation for L<bug(1)> or L<reportbug(1)>, if these are installed.
pt: Se ocorrer um erro durante a instalação, é normalmente aconselhável repetir a instalação. Na maioria dos casos, os problemas irão desaparecer ou ser resolvidos. Se os problemas persistirem ou a execução da instalação foi incorrecta, por favor investigue as causas e circunstâncias, e preencha um relatório de bug no sistema de acompanhamento de bugs de Debian. As instruções em como fazer isto podem ser encontradas em L<https://bugs.debian.org/> ou ao ler a documentação para L<bug(1)> ou L<reportbug(1)>, se esta estiver instalada.

note: type: textblock
en: Details of the install command depend on the access method's implementation.  The user's attention and input may be required during installation, configuration or removal of packages.  This depends on the maintainer scripts in the package.  Some packages make use of the L<debconf(1)> library, allowing for more flexible or even automated installation setups.
pt: Detalhes do comando de instalação dependem da implementação do método de acesso. Pode ser requerida a atenção do utilizador e entradas deste durante a instalação., configuração ou remoção de pacotes. Isto depende dos scripts de maintainer no pacote. Alguns pacotes fazem uso da biblioteca L<debconf(1)>, permitindo configurações de instalação mais flexíveis ou mesmo automatizadas.

note: type: textblock
en: Configures any previously installed, but not fully configured packages.
pt: Configura quaisquer pacotes previamente instalados, mas não totalmente configurados.

note: type: textblock
en: Removes or purges installed packages, that are marked for removal.
pt: Remove ou purga pacotes instalados, que estão marcados para remoção.

note: type: textblock
en: Quit B<dselect>.
pt: Termina o B<dselect>.

note: type: textblock
en: Exits the program with zero (successful) error code.
pt: Termina o programa com código de erro zero (com sucesso).

note: type: =head1
en: PACKAGE SELECTIONS MANAGEMENT
pt: GESTÃO DE SELECÇÕES DE PACOTES

note: type: =head2
en: Introduction
pt: Introdução

note: type: textblock
en: B<dselect> directly exposes the administrator to some of the complexities involved with managing large sets of packages with many interdependencies.  For a user who is unfamiliar with the concepts and the ways of the Debian package management system, it can be quite overwhelming.  Although B<dselect> is aimed at easing package management and administration, it is only instrumental in doing so and cannot be assumed to be a sufficient substitute for administrator skill and understanding.  The user is required to be familiar with the concepts underlying the Debian packaging system.  In case of doubt, consult the L<dpkg(1)> manual page and the distribution policy.
pt: B<dselect> expõe directamente o administrador a algumas das complexidades envolvidas com a gestão de grandes conjuntos de pacotes com muitas inter-dependências. Para um utilizador que não está familiarizado com os conceitos e as maneiras do sistema de gestão de pacotes Debian, pode ser esmagador. Apesar do B<dselect> estar apontado a facilitar a gestão de pacotes e a administração, é apenas instrumental a fazê-lo e nãos e pode assumir que seja um substituto suficiente para a perícia e conhecimentos de um administrador. É necessário que o utilizador esteja familiarizado com os conceitos básicos do sistemas de pacotes Debian. Em caso de dúvidas, consulte o manual do L<dpkg(1)> e a política de distribuição.

note: type: textblock
en: Unless B<dselect> is run in expert or immediate mode, a help screen is first displayed when choosing this command from the menu.  The user is I<strongly> advised to study all of the information presented in the online help screens, when one pops up.  The online help screens can at any time be invoked with the ‘B<?>’ key.
pt: A menos que o B<dselect> seja corrido em modo de esperto ou imediato, é primeiro mostrado um ecrã de ajuda quando se escolhe este comando do menu. O utilizador é I<fortemente> aconselhado a estudar toda a informação apresentada nos ecrãs de ajuda online, sempre que aparece um. Os ecrãs de ajuda online podem ser invocados a qualquer altura coma tecla ‘B<?>’.

note: type: =head2
en: Screen layout
pt: Disposição do ecrã

note: type: textblock
en: The select screen is by default split in a top and a bottom half.  The top half shows a list of packages.  A cursor bar can select an individual package, or a group of packages, if applicable, by selecting the group header.  The bottom half of the screen shows some details about the package currently selected in the top half of the screen.  The type of detail that is displayed can be varied.
pt: O ecrã de selecção está por predefinição dividido em metade de topo e de fundo. A metade do topo mostra uma lista de pacotes. Uma barra de cursor pode seleccionar um pacote individual, ou um grupo de pacotes, se aplicável, ao seleccionar o cabeçalho do grupo. A metade do fundo o ecrã mostra alguns detalhes acerca do pacote actualmente seleccionado na metade de topo do ecrã. O tipo de detalhes que é mostrado pode variar.

note: type: textblock
en: Pressing the ‘B<I>’ key toggles a full-screen display of the packages list, an enlarged view of the package details, or the equally split screen.
pt: Pressionando a tecla ‘B<I>’ altera entre amostragem de ecrã total da lista de pacotes, e visão alargada dos detalhes do pacote, ou o ecrã dividido igualmente.

note: type: =head2
en: Package details view
pt: Vista de detalhes de pacote

note: type: textblock
en: The package details view by default shows the extended package description for the package that is currently selected in the packages status list.  The type of detail can be toggled by pressing the ‘B<i>’ key.  This alternates between:
pt: A vista de detalhes do pacote por predefinição mostra a descrição extensa do pacote que está actualmente seleccionado na lista de estados de pacotes. O tipo de detalhes pode ser comutado ao pressionar a tecla ‘B<i>’. Isto alterna entre:

note: type: textblock
en: the extended description
pt: a descrição extensa

note: type: textblock
en: the control information for the installed version
pt: a informação de controle para a versão instalada

note: type: textblock
en: the control information for the available version
pt: a informação de controle para a versão disponível

note: type: textblock
en: In a dependency resolution screen, there is also the possibility of viewing the specific unresolved depends or conflicts related to the package and causing it to be listed.
pt: Num ecrã de resolução de dependência, há também a possibilidade de visualizar as dependências não resolvidas específicas ou conflitos relacionados ao pacote e a causarem que seja listado.

note: type: =head2
en: Packages status list
pt: Lista de estados dos pacotes

note: type: textblock
en: The main select screen displays a list of all packages known to the Debian package management system.  This includes packages installed on the system and packages known from the available packages database.
pt: O ecrã de selecção principal mostra uma lista de todos os pacotes conhecidos ao sistema de gestão de pacotes Debian. Isto inclui pacotes instalados no sistema e pacotes conhecidos a partir da base de dados de pacotes disponíveis.

note: type: textblock
en: For every package, the list shows the package's status, priority, section, installed and available architecture, installed and available versions, the package name and its short description, all in one line.  By pressing the ‘B<A>’ key, the display of the installed and available architecture can be toggled between on an off.  By pressing the ‘B<V>’ key, the display of the installed and available version can be toggled between on an off.  By pressing the ‘B<v>’ key, the package status display is toggled between verbose and shorthand.  Shorthand display is the default.
pt: Para cada pacote, a lista mostra o estado do pacote, prioridade, secção, arquitectura instalada e disponível, versões instalada e disponível, o nome do pacote, e a sua descrição curta, tudo numa linha. Ao pressionar a tecla ‘B<A>’, o mostrador da arquitectura instalada e disponível pode ser comutado entre ligado e desligado. Ao pressionar a tecla ‘B<V>’, o mostrador da versão instalada e disponível pode ser ligado e desligado. Ao pressionar a tecla ‘B<v>’, o mostrador do estado do pacote por ser comutado entre detalhado e abreviado. A amostragem abreviada é a predefinida.

note: type: textblock
en: The shorthand status indication consists of four parts: an error flag, which should normally be clear, the current status, the last selection state and the current selection state.  The first two relate to the actual state of the package, the second pair are about the selections set by the user.
pt: A indicação de estado abreviado consiste de quatro partes: uma bandeira de erro, o qual deve normalmente estar limpa, o estado actual, o estado da última selecção e o estado da selecção actual. Os dois primeiros estão relacionados com o actual estado do pacote, o segundo par são sobre as selecções feitas pelo utilizador.

note: type: textblock
en: These are the meanings of the shorthand package status indicator codes:
pt: Estes são os significados das abreviaturas de códigos indicadores de estado de pacotes:

note: type: textblock
en: Error flag:
pt: Bandeira de erro:

note: type: =item
en: I<empty> no error
pt: I<empty> nenhum erro

note: type: =item
en: B<R> serious error, needs reinstallation;
pt: B<R> erro sério, precisa de re-instalação;

note: type: textblock
en: Installed state:
pt: Estado de instalação:

note: type: =item
en: I<empty> not installed;
pt: I<empty> não instalado;

note: type: =item
en: B<*> fully installed and configured;
pt: B<*> totalmente instalado e configurado;

note: type: =item
en: B<-> not installed but some config files may remain;
pt: B<-> não instalado mas podem permanecer alguns ficheiros de configuração;

note: type: =item
en: B<U> unpacked but not yet configured;
pt: B<U> desempacotado mas ainda não configurado;

note: type: =item
en: B<C> half-configured (an error happened);
pt: B<C> meio-configurado (ocorreu um erro);

note: type: =item
en: B<I> half-installed (an error happened).
pt: B<I> meio-instalado (ocorreu um erro);

note: type: textblock
en: Current and requested selections:
pt: Selecções actuais e requisitadas:

note: type: =item
en: B<*> marked for installation or upgrade;
pt: B<*> marcada para instalação ou actualização;

note: type: =item
en: B<-> marked for removal, configuration files remain;
pt: B<-> marcado para remoção, mantendo ficheiros de configuração;

note: type: =item
en: B<=> on hold: package will not be processed at all;
pt: B<=> em espera: o pacote não será processado de todo;

note: type: =item
en: B<_> marked for purge, also remove configuration;
pt: B<_> marcado para purga, também remove configuração;

note: type: =item
en: B<n> package is new and has yet to be marked.
pt: B<n> pacote é novo e ainda está por ser marcado.

note: type: =head2
en: Cursor and screen movement
pt: Cursor e movimento do ecrã

note: type: textblock
en: The package selection list and the dependency conflict resolution screens can be navigated using motion commands mapped to the following keys:
pt: A lista de selecção de pacotes e os ecrãs de resolução de conflitos de dependências podem ser navegados usando comandos de movimento mapeados às seguintes teclas:

note: type: =item
en: B<p, Up, k> move cursor bar up
pt: B<p, Up, k> move barra de cursor para cima

note: type: =item
en: B<n, Down, j> move cursor bar down
pt: B<n, Down, j> move barra de cursor para baixo

note: type: =item
en: B<P, Pgup, Backspace> scroll list 1 page up
pt: B<P, Pgup, Backspace> desloca lista 1 página para cima

note: type: =item
en: B<N, Pgdn, Space> scroll list 1 page down
pt: B<N, Pgdn, Space>  desloca lista 1 página para baixo

note: type: =item
en: B<^p> scroll list 1 line up
pt: B<^p>  desloca lista 1 linha para cima

note: type: =item
en: B<^n> scroll list 1 line down
pt: B<^n> desloca lista 1 linha para baixo

note: type: =item
en: B<t, Home> jump to top of list
pt: B<t, Home> salta para o topo da lista

note: type: =item
en: B<e, End> jump to end of list
pt: B<e, End> salta para o fim da lista

note: type: =item
en: B<u> scroll info 1 page up
pt: B<u> desloca informação 1 página para cima

note: type: =item
en: B<d> scroll info 1 page down
pt: B<d> desloca informação 1 página para baixo

note: type: =item
en: B<^u> scroll info 1 line up
pt: B<^u> desloca informação 1 linha para cima

note: type: =item
en: B<^d> scroll info 1 line down
pt: B<^d> desloca informação 1 linha para baixo

note: type: =item
en: B<B, Left-arrow> pan display 1/3 screen left
pt: B<B, Left-arrow> amostragem panorâmica 1/3 ecrã esquerda

note: type: =item
en: B<F, Right-arrow> pan display 1/3 screen right
pt: B<F, Right-arrow> amostragem panorâmica 1/3 ecrã direita

note: type: =item
en: B<^b> pan display 1 character left
pt: B<^b> amostragem panorâmica 1 caractere esquerda

note: type: =item
en: B<^f> pan display 1 character right
pt: B<^f> amostragem panorâmica 1 caractere direita

note: type: =head2
en: Searching and sorting
pt: Procurar e ordenar

note: type: textblock
en: The list of packages can be searched by package name.  This is done by pressing ‘B</>’, and typing a simple search string.  The string is interpreted as a L<regex(7)> regular expression.  If you add ‘B</d>’ to the search expression, dselect will also search in descriptions.  If you add ‘B</i>’ the search will be case insensitive.  You may combine these two suffixes like this: ‘B</id>’.  Repeated searching is accomplished by repeatedly pressing the ‘B<n>’ or ‘B<\>’ keys, until the wanted package is found.  If the search reaches the bottom of the list, it wraps to the top and continues searching from there.
pt: A lista de pacotes pode ser pesquisada pelo nome do pacote. Isto é feito ao pressionar ‘B</>’, e escrever uma string simples de procura. A string é interpretada como uma expressão regular L<regex(7)>. Se você adicionar ‘B</d>’ à expressão de procura, o dselect irá também procurar nas descrições. Se você adicionar ‘B</i>’ a procura será sensível a maiúsculas/minúsculas. Você pode combinar estes dois sufixos assim: ‘B</id>’. Busca repetida é conseguida ao pressionar repetidamente as teclas ‘B<n>’ ou ‘B<\>’, até encontrar o pacote desejado. Se a pesquisa atingir o fundo da lista, rebobina para o topo e continua a busca a partir de lá.

note: type: textblock
en: The list sort order can be varied by pressing the ‘B<o>’ and ‘B<O>’ keys repeatedly.  The following nine sort orderings can be selected:
pt: A ordenação da lista pode ser variada ao pressionar as teclas ‘B<o>’ e ‘B<O>’ repetidamente. Podem ser selecionadas as seguintes nove ordenações:

note: type: =item
en: B<alphabet>
pt: B<alfabeto>

note: type: =item
en: B<priority+section>
pt: B<prioridade+secção>

note: type: =item
en: B<section+priority>
pt: B<secção+prioridade>

note: type: =item
en: B<available>
pt: B<disponibilidade>

note: type: =item
en: B<available+priority>
pt: B<disponibilidade+prioridade>

note: type: =item
en: B<available+section>
pt: B<disponibilidade+secção>

note: type: =item
en: B<status>
pt: B<estado>

note: type: =item
en: B<status+priority>
pt: B<estado+prioridade>

note: type: =item
en: B<status+section>
pt: B<estado+secção>

note: type: textblock
en: Where not listed above explicitly, alphabetic order is used as the final subordering sort key.
pt: Onde não listado em cima explicitamente, a ordem alfabética é usada como a chave se sub-ordenação final.

note: type: =head2
en: Altering selections
pt: Alterar selecções

note: type: textblock
en: The requested selection state of individual packages may be altered with the following commands:
pt: O estado de selecção requerido de pacotes individuais pode ser alterado com os seguintes comandos:

note: type: =item
en: B<+, Insert> install or upgrade
pt: B<+, Insert> instala ou actualiza

note: type: =item
en: B<=, H> hold in present state and version
pt: B<=, H> manter no estado e versão presente

note: type: =item
en: B<:, G> unhold: upgrade or leave uninstalled
pt: B<:, G> retira o manter: actualiza ou deixa desinstalado

note: type: =item
en: B<-, Delete> remove, but leave configuration
pt: B<-, Delete> remove, mas deixa configuração

note: type: =item
en: B<_> remove & purge configuration
pt: B<_> remove & purga a configuração

note: type: textblock
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen.  This will be further explained below.
pt: Quando o pedido de alteração resulta em uma ou mais dependências não satisfeitas ou conflitos, o B<dselect> questiona o utilizador com um ecrã de resolução de dependências. Isto será melhor explicado em baixo.

note: type: textblock
en: It is also possible to apply these commands to groups of package selections, by pointing the cursor bar onto a group header.  The exact grouping of packages is dependent on the current list ordering settings.
pt: É também possível aplicar estes comandos a selecções de grupos de pacotes, ao apontar a barra de cursor ao cabeçalho do grupo. O agrupamento exacto de pacotes está dependente das definições actuais de ordenação da lista.

note: type: textblock
en: Proper care should be taken when altering large groups of selections, because this can instantaneously create large numbers of unresolved depends or conflicts, all of which will be listed in one dependency resolution screen, making them very hard to handle.  In practice, only hold and unhold operations are useful when applied to groups.
pt: Deve ser tomado o cuidado apropriado quando se alteram grandes grupos de selecções, porque isto pode instantaneamente criar grandes números de dependências ou conflitos não resolvidos, todos os quais irão ser listados nu ecrã de resolução de dependências, tornando isso de lide muito difícil. Na prática, apenas as operações de manter e não-manter são úteis quando aplicadas a grupos.

note: type: =head2
en: Resolving depends and conflicts
pt: Resolver dependências e conflitos

note: type: textblock
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen.  First however, an informative help screen is displayed.
pt: Quando o pedido de alteração resulta em uma ou mais dependências ou conflitos não satisfeitos, o B<dselect> questiona o utilizador com um ecrã de resolução de dependências. No entanto, primeiro é mostrado um ecrã de ajuda informativo.

note: type: textblock
en: The top half of this screen lists all the packages that will have unresolved depends or conflicts, as a result of the requested change, and all the packages whose installation can resolve any of these depends or whose removal can resolve any of the conflicts.  The bottom half defaults to show the depends or conflicts that cause the currently selected package to be listed.
pt: A metade do topo deste ecrã lista todos os pacotes que irão ter dependências ou conflitos por resolver, como resultado da alteração pedida, e todos os pacotes cuja instalação pode resolver alguma destas dependências ou cuja remoção pode resolver algum destes conflitos. A metade de baixo por predefinição mostra as dependências ou conflitos que fazem com que o pacote seleccionado esteja na lista.

note: type: textblock
en: When the sublist of packages is displayed initially, B<dselect> may have already set the requested selection status of some of the listed packages, in order to resolve the depends or conflicts that caused the dependency resolution screen to be displayed.  Usually, it is best to follow up the suggestions made by B<dselect>.
pt: Quando a sub-lista de pacote é mostrada inicialmente, o B<dselect> pode já ter definido o estado de selecção requerido de alguns dos pacotes listados, de modo a resolver as dependências ou conflitos que causaram que o ecrã de resolução de dependências fosse mostrado. Geralmente, é melhor seguir as sugestões feitas pelo B<dselect>.

note: type: textblock
en: The listed packages' selection state may be reverted to the original settings, as they were before the unresolved depends or conflicts were created, by pressing the ‘B<R>’ key.  By pressing the ‘B<D>’ key, the automatic suggestions are reset, but the change that caused the dependency resolution screen to be prompted is kept as requested.  Finally, by pressing ‘B<U>’, the selections are again set to the automatic suggestion values.
pt: O estado de selecção dos pacotes listados pode ser revertido às definições originais, como estavam antes de serem criadas as dependências e conflitos não resolvidos, ao pressionar a tecla ‘B<R>’. Ao pressionar a tecla ‘B<D>’, as sugestões automáticas são reiniciadas, mas a alteração que provocou o ecrã de resolução de dependência é mantido como requisitado. Finalmente, ao pressionar B<U>’, as selecções são de novo definidas para os valores da sugestão automática.

note: type: =head2
en: Establishing the requested selections
pt: Estabelecendo as selecções necessárias

note: type: textblock
en: By pressing B<enter>, the currently displayed set of selections is accepted.  If B<dselect> detects no unresolved depends as a result of the requested selections, the new selections will be set.  However, if there are any unresolved depends, B<dselect> will again prompt the user with a dependency resolution screen.
pt: Ao pressionar B<enter>, o conjunto actual de selecções é aceite. Se o B<dselect> não detectar dependências não resolvidas com resultado das selecções requeridas, as novas selecções serão definidas. No entanto, se existir algumas dependências não resolvida, o B<dselect> irá de novo questionar o utilizador com um ecrã de resolução de dependência.

note: type: textblock
en: To alter a set of selections that creates unresolved depends or conflicts and forcing B<dselect> to accept it, press the ‘B<Q>’ key.  This sets the selections as specified by the user, unconditionally.  Generally, don't do this unless you've read the fine print.
pt: Para alterar um conjunto de selecções  que criam dependências e conflitos não resolvidos e forçar o B<dselect> a aceita-las, pressione a tecla 'B<Q>’. Isto define as selecções como especificadas pelo utilizador, incondicionalmente. De modo geral, não faça isto a menos que tenha lido as letras pequenas.

note: type: textblock
en: The opposite effect, to back out any selections change requests and go back to the previous list of selections, is attained by pressing the ‘B<X>’ or B<escape> keys.  By repeatedly pressing these keys, any possibly detrimental changes to the requested package selections can be backed out completely to the last established settings.
pt: O efeito oposto, para voltar atrás em quaisquer alterações requisitadas de selecções e regressar à lista de selecções anterior, pode fazê-lo ao pressionar as teclas 'B<X>’ ou B<escape>. Ao pressionar repetidamente estas teclas, quaisquer alterações possivelmente prejudiciais à selecção de pacotes requerida pode ser puxada atrás completamente até à última definição estabelecida.

note: type: textblock
en: If you mistakenly establish some settings and wish to revert all the selections to what is currently installed on the system, press the ‘B<C>’ key.  This is somewhat similar to using the unhold command on all packages, but provides a more obvious panic button in cases where the user pressed B<enter> by accident.
pt: Se você estabeleceu algumas definições por engano e deseja reverter todas as selecções para o que está actualmente instalado no sistema, pressione a tecla ‘B<C>’. Isto é de certa maneira semelhante a usar o comando unhold em todos os pacotes, mas fornece um botão de pânico mais óbvio em casos que o utilizador pressionou B<enter> por acidente.

note: type: textblock
en: The requested command was successfully performed.
pt: O comando requisitado foi executado com sucesso.

note: type: textblock
en: If set and the B<--instdir> or B<--root> options have not been specified, it will be used as the filesystem root directory (since dpkg 1.21.0).
pt: Se definido e as opções B<--instdir> ou B<--root> não foram especificadas, será usado como o directório raiz do sistema de ficheiros (desde dpkg 1.21.0).

note: type: textblock
en: If set and the B<--admindir> or B<--root> option have not been specified, it will be used as the B<dpkg> database directory (since dpkg 1.21.0).
pt: Se definido e a opção B<--admindir> ou B<--root> for especificada, será usado como o directório de base de dados do B<dpkg> (desde dpkg 1.21.0).

note: type: textblock
en: If set, B<dselect> will use it as the directory from which to read the user specific configuration file.
pt: Se definido, o B<dselect> irá usa-lo como o directório de onde ler o ficheiro de configuração específico do utilizador.

note: type: textblock
en: The B<dselect> package selection interface is confusing to some new users.  Reportedly, it even makes seasoned kernel developers cry.
pt: A interface de selecção de pacotes The B<dselect> é confusa para alguns novos utilizadores. Alegadamente, até faz desenvolvedores de kernel experientes chorarem.

note: type: textblock
en: The documentation is lacking.
pt: A documentação está escassa.

note: type: textblock
en: There is no help option in the main menu.
pt: Não há uma opção de ajuda no menu principal.

note: type: textblock
en: The visible list of available packages cannot be reduced.
pt: A lista visível de pacotes disponíveis não pode ser reduzida.

note: type: textblock
en: The built in access methods can no longer stand up to current quality standards.  Use the access method provided by L<apt(8)>, it is not only not broken, it is also much more flexible than the built in access methods.
pt: Os métodos de acesso embutidos não podem mais acompanhar os standards actuais de qualidade. Use o método de acesso fornecido pelo L<apt(8)>, não é apenas não quebrado, é muito mais flexível que os métodos de acesso embutidos.

note: type: textblock
en: start-stop-daemon - start and stop system daemon programs
pt: start-stop-daemon - inicia e pára programas daemon do sistema

note: type: textblock
en: B<start-stop-daemon> is used to control the creation and termination of system-level processes.  Using one of the matching options, B<start-stop-daemon> can be configured to find existing instances of a running process.
pt: B<start-stop-daemon> é usado para a criação e término de processos de nível-de-sistema. Usando uma destas opções de correspondência, o B<start-stop-daemon> pode ser configurado para procurar instâncias existentes de processos a correr.

note: type: textblock
en: B<Note>: Unless B<--pid> or B<--pidfile> are specified, B<start-stop-daemon> behaves similar to L<killall(1)>.  B<start-stop-daemon> will scan the process table looking for any processes which match the process name, parent pid, uid, and/or gid (if specified).  Any matching process will prevent B<--start> from starting the daemon.  All matching processes will be sent the TERM signal (or the one specified via B<--signal> or B<--retry>) if B<--stop> is specified.  For daemons which have long-lived children which need to live through a B<--stop>, you must specify a pidfile.
pt: B<Nota>: A menos que B<--pid> ou B<--pidfile> sejam especificados, B<start-stop-daemon> comporta-se de modo semelhante a L<killall(1)>. B<start-stop-daemon> irá sondar a tabela de processos em busca de qualquer processo que coincida com o nome de processo, pid parente, uid, e/u gid (se especificado). Quaisquer processos correspondentes irá prevenir um B<--start> de iniciar o daemon. A todos os processos correspondentes será enviado o sinal TERM (ou aquele especificado via B<--signal> ou B<--retry>) se for especificado B<--stop>.Para daemons que têm filhos de vida-longa que precisam sobreviver a um B<--stop>, você tem de especificar um pidfile.

note: type: textblock
en: Check for the existence of a specified process.  If such a process exists, B<start-stop-daemon> does nothing, and exits with error status 1 (0 if B<--oknodo> is specified).  If such a process does not exist, it starts an instance, using either the executable specified by B<--exec> or, if specified, by B<--startas>.  Any arguments given after B<--> on the command line are passed unmodified to the program being started.
pt: Verifica a existência de um processo especificado. Se tal processo existir, o B<start-stop-daemon> não faz nada, e termina com um estado de erro 1 (0 se B<--oknodo> for especificado). Se tal processo não existir, inicia uma instância, usando ou o executável especificado por B<--exec> ou, se especificado, por B<--startas>. Quaisquer argumentos dados após B<--> na linha de comandos são passados sem modificação ao programa que está a ser iniciado.

note: type: textblock
en: Checks for the existence of a specified process.  If such a process exists, B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits with error status 0.  If such a process does not exist, B<start-stop-daemon> exits with error status 1 (0 if B<--oknodo> is specified).  If B<--retry> is specified, then B<start-stop-daemon> will check that the process(es) have terminated.
pt: Verifica a existência de um processo especificado. Se tal processo existir, B<start-stop-daemon> envia o sinal especificado por B<--signal>, e termina com estado de erro 0. Se tal processo não existir, B<start-stop-daemon> termina com estado de erro 1 (0 se B<--oknodo> for especificado). Se for especificado B<--retry> então o B<start-stop-daemon> irá verificar se os processo(s) terminaram.

note: type: textblock
en: Check for the existence of a specified process, and returns an exit status code, according to the LSB Init Script Actions (since version 1.16.1).
pt: Verifica a existência de um processo especificado, e devolve um código de estado de saída, de acordo com as Acções do Script Init do LSB (desde versão 1.16.1).

note: type: textblock
en: Show usage information and exit.
pt: Mostra informação de utilização e termina.

note: type: textblock
en: Show the program version and exit.
pt: Mostra a versão do programa e termina.

note: type: =head2
en: Matching options
pt: Opções de correspondência

note: type: textblock
en: Check for a process with the specified I<pid> (since version 1.17.6).  The I<pid> must be a number greater than 0.
pt: Verifica por um processo com o I<pid> especificado (desde versão 1.17.6). O I<pid> tem de ser um número maior que 0.

note: type: textblock
en: Check for a process with the specified parent pid I<ppid> (since version 1.17.7).  The I<ppid> must be a number greater than 0.
pt: Verifica por um processo com o I<ppid> (pid pai) especificado (desde versão 1.17.7). O I<ppid> tem de ser um número maior que 0.

note: type: textblock
en: Check whether a process has created the file I<pidfile>.
pt: Verifica se um processo criou o ficheiro I<pidfile>.

note: type: textblock
en: B<Note>: Using this matching option alone might cause unintended processes to be acted on, if the old process terminated without being able to remove the I<pidfile>.
pt: B<Nota>: Usar esta opção de correspondência sozinha pode causar que se actue em processos intencionalmente, se o processo antigo terminou sem ser capaz de remover o seu I<pidfile>.

note: type: textblock
en: B<Warning>: Using this match option with a world-writable pidfile or using it alone with a daemon that writes the pidfile as an unprivileged (non-root)  user will be refused with an error (since version 1.19.3) as this is a security risk, because either any user can write to it, or if the daemon gets compromised, the contents of the pidfile cannot be trusted, and then a privileged runner (such as an init script executed as root) would end up acting on any system process.  Using I</dev/null> is exempt from these checks.
pt: B<Aviso>: Usar esta opção de correspondência com um pidfile gravável mundialmente ou usa-la sozinha com um daemon que escreve o pidfile como um utilizador sem privilégios (não-root) irá ser recusada com um erro (desde versão 1.19.3) pois isto é um risco de segurança, porque ou o utilizador consegue escrever nele, ou se o daemon ficar comprometido, não se pode confiar no conteúdo do pidfile, e depois um programa privilegiado (tal como um script de init corrido como root) acabaria a actuar em qualquer processo do sistema. Usar I</dev/null> está isento destas verificações.

note: type: textblock
en: Check for processes that are instances of this I<executable>.  The I<executable> argument should be an absolute pathname.
pt: Verifica por processos que são instâncias deste I<executable>. O argumento I<executable> deve ser um nome de caminho absoluto.

note: type: textblock
en: B<Note>: This might not work as intended with interpreted scripts, as the executable will point to the interpreter.  Take into account processes running from inside a chroot will also be matched, so other match restrictions might be needed.
pt: B<Nota>: Isto pode não funcionar como pretendido com com scripts de interpretação, pois o executável irá apontar para o interpretador. Tendo em conta que processos que correm dentro de uma chroot também irão corresponder, então poderão ser necessárias outras restrições de correspondência.

note: type: textblock
en: Check for processes with the name I<process-name>.  The I<process-name> is usually the process filename, but it could have been changed by the process itself.
pt: Verifica por processos com o nome I<process-name>. O I<process-name> é geralmente o nome de ficheiro do processo, mas pode ter sido modificado pelo próprio processo.

note: type: textblock
en: B<Note>: On most systems this information is retrieved from the process comm name from the kernel, which tends to have a relatively short length limit (assuming more than 15 characters is non-portable).
pt: B<Nota>: Na maioria dos sistemas esta informação é obtida a partir do nome de comunicação do processo a partir do kernel, o que tem tendência a ter um limite de comprimento relativamente curto (assumir mais de 15 caracteres é não-portável).

note: type: textblock
en: Check for processes owned by the user specified by I<username> or I<uid>.
pt: Verifica por processos cujo dono é o utilizador especificado por I<username> ou I<uid>.

note: type: textblock
en: B<Note>: Using this matching option alone will cause all processes matching the user to be acted on.
pt: B<Nota>: usar só esta opção de correspondência irá causar com que seja actuado em todos os processos que correspondem ao utilizador.

note: type: =head2
en: Generic options
pt: Opções genéricas

note: type: textblock
en: Change to I<group> or I<gid> when starting the process.
pt: Altera para I<grupo> ou I<gid> quando inicia o processo.

note: type: textblock
en: With B<--stop>, specifies the signal to send to processes being stopped (default TERM).
pt: Com B<--stop>, especifica o sinal a enviar aos processos a serem parados (predefinição TERM).

note: type: textblock
en: With B<--stop>, specifies that B<start-stop-daemon> is to check whether the process(es)  do finish.  It will check repeatedly whether any matching processes are running, until none are.  If the processes do not exit it will then take further action as determined by the schedule.
pt: Com B<--stop>, especifica que B<start-stop-daemon> deve verificar se o(s) processo(s) terminam mesmo. Irá verificar repetidamente se qualquer processo correspondente está a correr, até que nenhum esteja. Se os processos não terminarem irá então tomar mais acções como determinado pelo agendamento.

note: type: textblock
en: If I<timeout> is specified instead of I<schedule>, then the schedule I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the signal specified with B<--signal>.
pt: Se for especificado I<timeout> em vez de I<schedule>, então agenda I<signal>B</>I<timeout>B</KILL/>I<timeout> é usada, onde I<signal> é o sinal especificado com B<--signal>.

note: type: textblock
en: I<schedule> is a list of at least two items separated by slashes (B</>); each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means to send that signal, or I<timeout>, which means to wait that many seconds for processes to exit, or B<forever>, which means to repeat the rest of the schedule forever if necessary.
pt: I<schedule> é uma lista de pelo menos dois itens separados por barras (B</>); cada item pode ser B<->I<signal-number> ou [B<->]I<signal-name>, o que significa enviar esse sinal, ou I<timeout>, o que significa esperar esses tantos segundos para que os processos terminem, ou B<forever>, o que significa repetir o resto da agenda para sempre se necessário.

note: type: textblock
en: If the end of the schedule is reached and B<forever> is not specified, then B<start-stop-daemon> exits with error status 2.  If a schedule is specified, then any signal specified with B<--signal> is ignored.
pt: Se o fim da agenda for atingido e não foi especificado B<forever>, então B<start-stop-daemon> termina com o estado de erro 2. Se for especificada uma agenda então qualquer sinal especificado com B<--signal> é ignorado.

note: type: textblock
en: With B<--start>, start the process specified by I<pathname>.  If not specified, defaults to the argument given to B<--exec>.
pt: Com B<--start>, inicia o processo especificado por I<nome-de-caminho>. Se não especificado, usa por predefinição o argumento dado a B<--exec>.

note: type: textblock
en: Print actions that would be taken and set appropriate return value, but take no action.
pt: Escreve as acções que seriam tomadas e define valores de retorno apropriados, mas não toma nenhuma acção.

note: type: textblock
en: Return exit status 0 instead of 1 if no actions are (would be) taken.
pt: Retorna o estado de saída 0 em vez de 1 se nenhuma acção foi (será) tomada.

note: type: textblock
en: Do not print informational messages; only display error messages.
pt: Não escreve mensagens informativas, apenas mostra mensagens de erro.

note: type: textblock
en: Change to this username/uid before starting the process.  You can also specify a group by appending a B<:>, then the group or gid in the same way as you would for the L<chown(1)> command (I<user>B<:>I<group>).  If a user is specified without a group, the primary GID for that user is used.  When using this option you must realize that the primary and supplemental groups are set as well, even if the B<--group> option is not specified.  The B<--group> option is only for groups that the user isn't normally a member of (like adding per process group membership for generic users like B<nobody>).
pt: Muda para este nome-utilizador/uid antes de arrancar o processo. Você também pode especifica um grupo ao anexar B<:>, e depois o grupo ou gid do mesmo modo que faria com o comando L<chown(1)> (I<user>B<:>I<group>).  Se for especificado um utilizador sem um grupo, é usado o GID primários para esse utilizador. Quando usa esta opção você tem de compreender que os grupos primário e suplementar são também definidos, mesmo que a opção B<--group> não seja especificada. A opção B<--group> é apenas para grupos em que o utilizador não é normalmente um membro dele (tal como adicionar sociedade de grupo por-processo para utilizadores genéricos tipo B<nobody>).

note: type: textblock
en: Change directory and chroot to I<root> before starting the process.  Please note that the pidfile is also written after the chroot.
pt: Muda directório e chroot para I<root> antes de iniciar o processo. Por favor note que o pidfile é também escrito após o chroot.

note: type: textblock
en: Change directory to I<path> before starting the process.  This is done after the chroot if the B<-r>|B<--chroot> option is set.  When not specified, B<start-stop-daemon> will change directory to the root directory before starting the process.
pt: Muda directório para I<caminho> antes de iniciar o processo. Isto é feito depois de chroot se a opção B<-r>|B<--chroot> estiver definida. Quando não especificado, o B<start-stop-daemon> irá mudar o directório para o directório raiz antes de iniciar o processo.

note: type: textblock
en: Typically used with programs that don't detach on their own.  This option will force B<start-stop-daemon> to fork before starting the process, and force it into the background.
pt: Tipicamente usado com programas que não se desanexam deles próprios. Esta opção irá forçar o B<start-stop-daemon> a bifurcar antes de iniciar o processo, e a força-lo para os bastidores.

note: type: textblock
en: B<Warning>: B<start-stop-daemon> cannot check the exit status if the process fails to execute for B<any> reason.  This is a last resort, and is only meant for programs that either make no sense forking on their own, or where it's not feasible to add the code for them to do this themselves.
pt: B<Aviso>: B<start-stop-daemon> não pode verificar o estado de saída se o processo falhar ao executar por B<qualquer> razão. Este é o último recurso, e destina-se apenas a programas que ou não fazem sentido a bifurcarem por si só, ou onde não é praticável adicionar-lhes o código para fazerem isto eles próprios.

note: type: textblock
en: Wait for the background process to send a readiness notification before considering the service started (since version 1.19.3).  This implements parts of the systemd readiness protocol, as specified in the L<sd_notify(3)> manual page.  The following variables are supported:
pt: Espera pelo processo nos bastidores que envie uma notificação de prontidão antes de considerar o serviço arrancado (desde versão 1.19.3). Isto implementa partes do protocolo de prontidão do systemd, como especificado no manual L<sd_notify(3)>. As seguintes variáveis são suportadas:

note: type: textblock
en: The program is ready to give service, so we can exit safely.
pt: O programa está pronto a dar serviço, portanto é seguro sair-mos.

note: type: textblock
en: The program requests to extend the timeout by I<number> microseconds.  This will reset the current timeout to the specified value.
pt: O programa pede para estender o limite de tempo em by I<number> milissegundos. Isto irá reiniciar o tempo limite actual para o valor especificado.

note: type: textblock
en: The program is exiting with an error.  Do the same and print the user-friendly string for the B<errno> value.
pt: O programa está a terminar com um erro. Faça o mesmo e escreva a string amiga-do-utilizador para o valor B<errno>.

note: type: textblock
en: Set a timeout for the B<--notify-await> option (since version 1.19.3).  When the timeout is reached, B<start-stop-daemon> will exit with an error code, and no readiness notification will be awaited.  The default is B<60> seconds.
pt: Define o tempo limite para a opção B<--notify-await> (desde versão 1.19.3). Quando o tempo limite é atingido, o B<start-stop-daemon> irá terminar com um código de erro, e não é esperada nenhuma notificação de prontidão. A predefinição é B<60> segundos.

note: type: textblock
en: Do not close any file descriptor when forcing the daemon into the background (since version 1.16.5).  Used for debugging purposes to see the process output, or to redirect file descriptors to log the process output.  Only relevant when using B<--background>.
pt: Não fecha nenhum descritor de ficheiro quando força o daemon para os bastidores (desde versão 1.16.5). Usado para objectivos de depuração para ver o resultado dos processos, ou para redirecionar os descritores de ficheiros para registar o resultado dos processos. Apenas relevante quando se usa B<--background>.

note: type: textblock
en: Redirect B<stdout> and B<stderr> to I<pathname> when forcing the daemon into the background (since version 1.20.6).  Only relevant when using B<--background>.
pt: Redireciona B<stdout> e B<stderr> para I<pathname> quando força o daemon a funcionar em segundo plano (desde versão 1.20.6). Apenas relevante quando se usa B<--background>.

note: type: textblock
en: This alters the priority of the process before starting it.
pt: Isto altera a prioridade do processo antes de o iniciar.

note: type: textblock
en: This alters the process scheduler policy and priority of the process before starting it (since version 1.15.0).  The priority can be optionally specified by appending a B<:> followed by the value.  The default I<priority> is 0.  The currently supported policy values are B<other>, B<fifo> and B<rr>.
pt: Isto altera a política de agendamento de processos e a prioridade dos processos antes de os iniciar (desde versão 1.15.0). A prioridade pode ser opcionalmente especificada ao anexar um B<:> seguido de um valor. A predefinição de I<priority> é 0. Os valores de política actualmente suportados são B<other>, B<fifo> e B<rr>.

note: type: textblock
en: This option might do nothing on some systems, where POSIX process scheduling is not supported.
pt: Esta opção pode não fazer anda em alguns sistemas, onde o agendamento de processos POSIX não é suportado.

note: type: textblock
en: This alters the IO scheduler class and priority of the process before starting it (since version 1.15.0).  The priority can be optionally specified by appending a B<:> followed by the value.  The default I<priority> is 4, unless I<class> is B<idle>, then I<priority> will always be 7.  The currently supported values for I<class> are B<idle>, B<best-effort> and B<real-time>.
pt: Isto altera a classe de agendamento IO e a prioridade dos processos antes de os iniciar (desde versão 1.15.0). A prioridade pode ser opcionalmente especificada ao anexar um B<:> seguido de um valor. A predefinição de I<priority> é 4, a menos que I<class> seja B<idle>, então I<priority> será sempre 7. Os valores actualmente suportados para I<class> são B<idle>, B<best-effort> e B<real-time>.

note: type: textblock
en: This option might do nothing on some systems, where Linux IO scheduling is not supported.
pt: Esta opção pode não fazer anda em alguns sistemas, onde o agendamento de processos Linux IO não é suportado.

note: type: textblock
en: This sets the umask of the process before starting it (since version 1.13.22).
pt: Isto define o umask do processo antes de o iniciar (desde a versão 1.13.22).

note: type: textblock
en: Used when starting a program that does not create its own pid file.  This option will make B<start-stop-daemon> create the file referenced with B<--pidfile> and place the pid into it just before executing the process.  Note, the file will only be removed when stopping the program if B<--remove-pidfile> is used.
pt: Usado quando se inicia um programa que não cria o seu próprio ficheiro pid. Esta opção irá fazer o B<start-stop-daemon> criar o ficheiro referenciado com B<--pidfile> e colocar o pid nele mesmo antes de executar o processo. Nota, o ficheiro só será removido quando se pára o programa se for usado B<--remove-pidfile>.

note: type: textblock
en: B<Note>: This feature may not work in all cases.  Most notably when the program being executed forks from its main process.  Because of this, it is usually only useful when combined with the B<--background> option.
pt: B<Nota>: Esta funcionalidade pode não funcionar em todos os casos. Mais notavelmente quando o programa a ser executar bifurca do seu processo principal. Devido a isto, é geralmente apenas útil quando combinado com a opção B<--background>.

note: type: textblock
en: Used when stopping a program that does not remove its own pid file (since version 1.17.19).  This option will make B<start-stop-daemon> remove the file referenced with B<--pidfile> after terminating the process.
pt: Usado para parar um programa que não remove o seu próprio ficheiro pid (desde versão 1.17.19). Esta opção irá fazer o B<start-stop-daemon> remover o ficheiro referenciado com B<--pidfile> após terminar o processo.

note: type: textblock
en: Print verbose informational messages.
pt: Escreve mensagens de informação detalhadas.

note: type: textblock
en: The requested action was performed.  If B<--oknodo> was specified, it's also possible that nothing had to be done.  This can happen when B<--start> was specified and a matching process was already running, or when B<--stop> was specified and there were no matching processes.
pt: A acção requerida foi executada. Se B<--oknodo> foi especificado, é também possível que nada tenha de ser feito. Isto pode acontecer quando B<--start> foi especificado e um processo correspondente já estava a correr, ou quando B<--stop> foi especificado e não há nenhum processo correspondente.

note: type: textblock
en: If B<--oknodo> was not specified and nothing was done.
pt: Se B<--oknodo> não foi especificado e nada foi feito.

note: type: textblock
en: If B<--stop> and B<--retry> were specified, but the end of the schedule was reached and the processes were still running.
pt: Se B<--stop> e B<--retry> foram especificados, mas foi alcançado o fim do agendamento e os processos ainda estavam a correr.

note: type: textblock
en: Any other error.
pt: Qualquer outro erro.

note: type: textblock
en: When using the B<--status> command, the following status codes are returned:
pt: Quando se usa o comando B<--status>, são devolvidos os seguintes códigos de estado:

note: type: textblock
en: Program is running.
pt: Programa está em execução.

note: type: textblock
en: Program is not running and the pid file exists.
pt: Programa não está em execução e o ficheiro pid existe.

note: type: textblock
en: Program is not running.
pt: Programa não está em execução.

note: type: textblock
en: Unable to determine program status.
pt: Incapaz de determinar o estado do programa.

note: type: textblock
en: Start the B<food> daemon, unless one is already running (a process named food, running as user food, with pid in food.pid):
pt: Inicia o daemon B<food>, a menos que um já esteja a correr (um processo chamado food, a correr como utilizador food, com pid em food.pid):

note: type: textblock
en: Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:
pt: Envia B<SIGTERM> para B<food> e espera até 5 segundos para que pare:

note: type: textblock
en: Demonstration of a custom schedule for stopping B<food>:
pt: Demonstração dum agendamento personalizado para parar o B<food>:

note: type: textblock
en: update-alternatives - maintain symbolic links determining default commands
pt: update-alternatives - mantém links simbólicos que determinam os comandos predefinidos

note: type: textblock
en: B<update-alternatives> creates, removes, maintains and displays information about the symbolic links comprising the alternatives system.
pt: B<update-alternatives> cria, remove, mantêm e mostra informação acerca dos links simbólicos que abrangem o sistema de alternativos.

note: type: textblock
en: It is possible for several programs fulfilling the same or similar functions to be installed on a single system at the same time.  For example, many systems have several text editors installed at once.  This gives choice to the users of a system, allowing each to use a different editor, if desired, but makes it difficult for a program to make a good choice for an editor to invoke if the user has not specified a particular preference.
pt: É possível para vários programas realizarem o mesmo ou funções semelhantes para serem instalados num único sistema ao mesmo tempo. Por exemplo, muitos sistemas têm vários editores de texto instalados ao mesmo tempo. Isto dá escolha aos utilizadores do sistema, permitindo que cada um use um editor diferente, se o desejar, mas torna difícil para um programa fazer uma boa escolha no editor a invocar se o utilizador não especificou a sua preferência particular.

note: type: textblock
en: The alternatives system aims to solve this problem.  A generic name in the filesystem is shared by all files providing interchangeable functionality.  The alternatives system and the system administrator together determine which actual file is referenced by this generic name.  For example, if the text editors L<ed(1)> and L<nvi(1)> are both installed on the system, the alternatives system will cause the generic name I</usr/bin/editor> to refer to I</usr/bin/nvi> by default.  The system administrator can override this and cause it to refer to I</usr/bin/ed> instead, and the alternatives system will not alter this setting until explicitly requested to do so.
pt: O sistema de alternativas destina-se a resolver este problema. Um nome genérico no sistema de ficheiros é partilhado por todos os ficheiros que fornecem funcionalidades intercambiáveis. O sistema de alternativas e o administrador do sistema juntamente determinam qual ficheiro real é referenciado por este nome genérico. Por exemplo, se os editores de texto L<ed(1)>  e L<nvi(1)> estiverem ambos instalados no sistema, o sistema de alternativas irá fazer com que o nome genérico I</usr/bin/editor> se refira a I</usr/bin/nvi> por predefinição. O administrador do sistema pode sobrepor isto e fazê-lo referir-se a I</usr/bin/ed> em vez do primeiro, e o sistema de alternativas não irá alterar esta definição até que lhe seja requerido explicitamente fazê-lo.

note: type: textblock
en: The generic name is not a direct symbolic link to the selected alternative.  Instead, it is a symbolic link to a name in the I<alternatives> I<directory>, which in turn is a symbolic link to the actual file referenced.  This is done so that the system administrator's changes can be confined within the I<%CONFDIR%> directory: the FHS (q.v.) gives reasons why this is a Good Thing.
pt: O nome genérico não é um link simbólico directo para a alternativa selecionada. Em vez disso, é um link simbólico para um nome no I<directório> I<alternatives>, o qual por sua vez é um link simbólico para o ficheiro real referenciado. Isto é feito deste modo para que as alterações do administrador do sistema fiquem confinadas dentro do directório I<%CONFDIR%>: a FHS (q.v.) explica o porquê isto ser uma Coisa Boa.

note: type: textblock
en: When each package providing a file with a particular functionality is installed, changed or removed, B<update-alternatives> is called to update information about that file in the alternatives system.  B<update-alternatives> is usually called from the following Debian package maintainer scripts, B<postinst> (configure) to install the alternative and from B<prerm> and B<postrm> (remove) to remove the alternative.  B<Note>: in most (if not all) cases no other maintainer script actions should call B<update-alternatives>, in particular neither of B<upgrade> nor B<disappear>, as any other such action can lose the manual state of an alternative, or make the alternative temporarily flip-flop, or completely switch when several of them have the same priority.
pt: Quando cada pacote que fornece um ficheiro com uma determinada funcionalidade é instalado, modificado ou removido, o B<update-alternatives> é chamado para actualizar a informação sobre esse ficheiro no sistema de alternativas. O B<update-alternatives> é geralmente chamado a partir dos seguintes scripts de maintainer de pacote Debian, B<postinst> (configurar) para instalar a alternativa e a partir de B<prerm> e B<postrm> (remover) para remover a alternativa.  B<Nota>: na maioria dos casos (se não todos) nenhuma outra acção de script de maintainer deverá chamar B<update-alternatives>, em particular nenhum de B<upgrade> nem B<disappear>, pois outra acção do tipo pode perder o estado manual da alternativa, ou fazer a alternativa inverter temporariamente, ou comutar completamente quando várias têm a mesma prioridade.

note: type: textblock
en: It is often useful for a number of alternatives to be synchronized, so that they are changed as a group; for example, when several versions of the L<vi(1)> editor are installed, the manual page referenced by I</usr/share/man/man1/vi.1> should correspond to the executable referenced by I</usr/bin/vi>.  B<update-alternatives> handles this by means of I<master> and I<slave> links; when the master is changed, any associated slaves are changed too.  A master link and its associated slaves make up a I<link> I<group>.
pt: Isto é muitas vezes útil para se sincronizar várias alternativas, para que sejam mudadas como um grupo; por exemplo, quando estão instaladas várias versões do editor L<vi(1)>, o manual referenciado por I</usr/share/man/man1/vi.1> deve corresponder ao executável referenciado por I</usr/bin/vi>. B<update-alternatives> lida com isto por meio de  links I<master> e I<slave>; quando o mestre é mudado, quaisquer slaves associados são também mudados. Um link mestre e os seus slaves associados fazem um I<group> de I<link>.

note: type: textblock
en: Each link group is, at any given time, in one of two modes: automatic or manual.  When a group is in automatic mode, the alternatives system will automatically decide, as packages are installed and removed, whether and how to update the links.  In manual mode, the alternatives system will retain the choice of the administrator and avoid changing the links (except when something is broken).
pt: Cada grupo de links é, a qualquer altura, em um ou dois modos: automático ou manual. Quando um grupo está em modo automático, o sistema de alternativas irá decidir automaticamente, quando os pacotes são instalados ou removidos, em como actualizar os links. Em modo manual, o sistema de alternativas irá reter a escolha do administrador e evitar alterar os links (excepto quando algum quebrar).

note: type: textblock
en: Link groups are in automatic mode when they are first introduced to the system.  If the system administrator makes changes to the system's automatic settings, this will be noticed the next time B<update-alternatives> is run on the changed link's group, and the group will automatically be switched to manual mode.
pt: Grupos de links ficam em modo automático quando são introduzidos pela primeira vez no sistema. Se o administrador do sistema fizer alterações nas definições automáticas do sistema, isso será notificado na próxima vez que o B<update-alternatives> correr no grupo de links alterado, e o grupo será automaticamente comutado para modo manual.

note: type: textblock
en: Each alternative has a I<priority> associated with it.  When a link group is in automatic mode, the alternatives pointed to by members of the group will be those which have the highest priority.
pt: Cada alternativa tem uma I<priority> associada. Quando um grupo de links está em modo automático, as alternativas apontadas pelos membros do grupo serão aquelas que têm aprioridade mais alta.

note: type: textblock
en: When using the B<--config> option, B<update-alternatives> will list all of the choices for the link group of which given I<name> is the master alternative name.  The current choice is marked with a ‘*’.  You will then be prompted for your choice regarding this link group.  Depending on the choice made, the link group might no longer be in I<auto> mode.  You will need to use the B<--auto> option in order to return to the automatic mode (or you can rerun B<--config> and select the entry marked as automatic).
pt: Quando se usa a opção B<--config>, o B<update-alternatives> irá listar todas as opções para o grupo de links do qual o I<nome> dado é o nome alternativo mestre. A escolha actual é marcada com um ‘*’. Você será depois questionado sobre a sua escolha em relação a este grupo de links. Dependendo da escolha feita, o grupo de link pode não mais ficar em modo I<auto>. Você precisa usar a opção B<--auto> de modo a regressar ao modo automático (ou pode voltar a correr B<--config> e escolher a entrada marcada como automática).

note: type: textblock
en: If you want to configure non-interactively you can use the B<--set> option instead (see below).
pt: Se desejar configurar não interactivamente, em vez disto pode usar a opção B<--set> (veja em baixo).

note: type: textblock
en: Different packages providing the same file need to do so B<cooperatively>.  In other words, the usage of B<update-alternatives> is B<mandatory> for all involved packages in such case.  It is not possible to override some file in a package that does not employ the B<update-alternatives> mechanism.
pt: Pacotes diferentes que forneçam o mesmo ficheiro precisam de fazê-lo B<cooperativamente>. Por outras palavras, o uso de B<update-alternatives> é B<obrigatório> para todos os pacotes envolvidos em tal caso. Não é possível sobrepor qualquer ficheiro de um pacote em que não se empregue o mecanismo B<update-alternatives>.

note: type: =head1
en: TERMINOLOGY
pt: TERMINOLOGIA

note: type: textblock
en: Since the activities of B<update-alternatives> are quite involved, some specific terms will help to explain its operation.
pt: Como as atividades de B<update-alternatives> estão bastante envolvidas, alguns termos específicos irão ajudar a explicar a sua operação.

note: type: =item
en: generic name (or alternative link)
pt: nome genérico (ou link alternativo)

note: type: textblock
en: A name, like I</usr/bin/editor>, which refers, via the alternatives system, to one of a number of files of similar function.
pt: Um nome, como I</usr/bin/editor>, o qual refere, via sistema de alternativos, a um de um número de ficheiros de função semelhante.

note: type: =item
en: alternative name
pt: nome alternativo

note: type: textblock
en: The name of a symbolic link in the alternatives directory.
pt: O nome do links simbólico no directório de alternativos.

note: type: =item
en: alternative (or alternative path)
pt: alternativo (ou caminho alternativo)

note: type: textblock
en: The name of a specific file in the filesystem, which may be made accessible via a generic name using the alternatives system.
pt: O nome de um ficheiro especifico no sistema de ficheiros, que pode ser tornado acessível via um nome genérico usando o sistema de alternativos.

note: type: =item
en: alternatives directory
pt: directório de alternativos

note: type: textblock
en: A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks.
pt: Um directório, por predefinição I<%CONFDIR%/alternatives>, que contém os links simbólicos.

note: type: =item
en: administrative directory
pt: directório administrativo

note: type: textblock
en: A directory, by default I<%ADMINDIR%/alternatives>, containing B<update-alternatives>' state information.
pt: Um directório, por predefinição I<%ADMINDIR%/alternatives>, que contém informações de estado do B<update-alternatives>.

note: type: =item
en: link group
pt: grupo de links

note: type: textblock
en: A set of related symlinks, intended to be updated as a group.
pt: Um conjunto de links simbólicos relacionados, destinados a serem actualizados como um grupo.

note: type: =item
en: master link
pt: link mestre

note: type: textblock
en: The alternative link in a link group which determines how the other links in the group are configured.
pt: O link alternativo num grupo de links que determina como os outros links no grupo são configurados.

note: type: =item
en: slave link
pt: link escravo

note: type: textblock
en: An alternative link in a link group which is controlled by the setting of the master link.
pt: Um link alternativo num grupo de links que é controlado pela definição do link mestre.

note: type: =item
en: automatic mode
pt: modo automático

note: type: textblock
en: When a link group is in automatic mode, the alternatives system ensures that the links in the group point to the highest priority alternative appropriate for the group.
pt: Quando um grupo de links está em modo automático, o sistema de alternativas assegura que os links do grupo apontam para a alternativa apropriada de prioridade mais alta para o grupo.

note: type: =item
en: manual mode
pt: modo manual

note: type: textblock
en: When a link group is in manual mode, the alternatives system will not make any changes to the system administrator's settings.
pt: Quando um grupo de links está em modo manual, o sistema de alternativas não irá fazer nenhumas alterações às definições do administrador do sistema.

note: type: textblock
en: Add a group of alternatives to the system.  I<link> is the generic name for the master link, I<name> is the name of its symlink in the alternatives directory, and I<path> is the alternative being introduced for the master link.  The arguments after B<--slave> are the generic name, symlink name in the alternatives directory and the alternative path for a slave link.  Zero or more B<--slave> options, each followed by three arguments, may be specified.  Note that the master alternative must exist or the call will fail.  However if a slave alternative doesn't exist, the corresponding slave alternative link will simply not be installed (a warning will still be displayed).  If some real file is installed where an alternative link has to be installed, it is kept unless B<--force> is used.
pt: Adiciona um grupo de alternativas ao sistema. I<link> é o nome genérico para o link mestre, I<name> é o nome do seu link simbólico no directório de alternativas, e I<path> é a alternativa a ser introduzida para o link mestre. Os argumentos após B<--slave> são o ome genérico, nome do link simbólico no directório de alternativas e o caminho alternativo para um link slave. Podem ser especificadas zero ou mais opções B<--slave>, cada uma seguida de três argumentos. Note que a alternativa mestre tem de existir ou a chamada irá falhar. No entanto se uma alternativa slave não existir, o link de alternativa slave correspondente simplesmente não irá ser instalado (mesmo assim é mostrado um aviso). Se estiver instalado um ficheiro real no lugar onde um link simbólico deve ser instalado, este é mantido a menos que seja usado B<--force>.

note: type: textblock
en: If the alternative name specified exists already in the alternatives system's records, the information supplied will be added as a new set of alternatives for the group.  Otherwise, a new group, set to automatic mode, will be added with this information.  If the group is in automatic mode, and the newly added alternatives' priority is higher than any other installed alternatives for this group, the symlinks will be updated to point to the newly added alternatives.
pt: Se o nome alternativo especificado já existir nos registos do sistema de alternativas, a informação fornecida será adicionada como um novo conjunto de alternativas para o grupo. Caso contrário, será adicionado um novo grupo, definido para modo automático, com esta informação. Se o grupo estiver em modo automático, e as prioridade das alternativas recentes adicionadas é mais alta que as outras alternativas instaladas para este grupo, os links simbólicos serão actualizados para apontarem às novas alternativas adicionadas.

note: type: textblock
en: Set the program I<path> as alternative for I<name>.  This is equivalent to B<--config> but is non-interactive and thus scriptable.
pt: Define o programa I<path> como alternativa para I<name>. Isto é equivalente a B<--config> mas não é interactivo e assim apropriado para usar em scripts.

note: type: textblock
en: Remove an alternative and all of its associated slave links.  I<name> is a name in the alternatives directory, and I<path> is an absolute filename to which I<name> could be linked.  If I<name> is indeed linked to I<path>, I<name> will be updated to point to another appropriate alternative (and the group is put back in automatic mode), or removed if there is no such alternative left.  Associated slave links will be updated or removed, correspondingly.  If the link is not currently pointing to I<path>, no links are changed; only the information about the alternative is removed.
pt: Remove uma alternativa e todos os seus links slave associados. I<name> é um nome no directório de alternativas, e I<path> é um nome de ficheiro absoluto para o qual I<name> poderá estar vinculado. Se I<name> está de facto vinculado a I<path>, I<name> será actualizado para apontar para outra alternativa apropriada (e o grupo é colocado de novo em modo automático), ou removido se não existir mais nenhuma alternativa. Os links slave associados serão actualizados ou removidos, correspondentemente. Se o link não está actualmente a apontar para I<path>, nenhum link é alterado, apenas é removida a informação sobre a alternativa.

note: type: textblock
en: Remove all alternatives and all of their associated slave links.  I<name> is a name in the alternatives directory.
pt: Remove todos os alternativos e todos os seus links escravos associados. I<name> é um nome no directório de alternativos.

note: type: textblock
en: Call B<--config> on all alternatives.  It can be usefully combined with B<--skip-auto> to review and configure all alternatives which are not configured in automatic mode.  Broken alternatives are also displayed.  Thus a simple way to fix all broken alternatives is to call B<yes '' | update-alternatives --force --all>.
pt: Chama  B<--config> em todas as alternativas. Pode ser útil combinado com B<--skip-auto> para rever e configurar todas as alternativas que não estão configuradas em modo automático. São também mostradas as alternativas quebradas. Assim um modo simples de corrigir todas as alternativas quebradas é chamar B<yes '' | update-alternatives --force --all>.

note: type: textblock
en: Switch the link group behind the alternative for I<name> to automatic mode.  In the process, the master symlink and its slaves are updated to point to the highest priority installed alternatives.
pt: Comuta o grupo de link por detrás da alternativa para I<name> para modo automático. No processo, o link simbólico mestre e os seus slaves são actualizados par apontar para a alternativa instalada de prioridade mais alta.

note: type: textblock
en: Display information about the link group.  Information displayed includes the group's mode (auto or manual), the master and slave links, which alternative the master link currently points to, what other alternatives are available (and their corresponding slave alternatives), and the highest priority alternative currently installed.
pt: Mostra informação sobre o grupo de link. A informação ,mostrada inclui o modo do grupo (auto ou manual), os links mestre e slave, a qual alternativa o link mestre presentemente aponta, que outras alternativas estão disponíveis (a as suas alternativas slave correspondentes), e a alternativa de prioridade mais alta presentemente instalada.

note: type: textblock
en: List all master alternative names (those controlling a link group)  and their status (since version 1.15.0).  Each line contains up to 3 fields (separated by one or more spaces).  The first field is the alternative name, the second one is the status (either B<auto> or B<manual>), and the last one contains the current choice in the alternative (beware: it's a filename and thus might contain spaces).
pt: Lista todos os nomes de alternativa mestre (aqueles que controlam um grupo link) e os seus estados (desde versão 1.15.0). Cada linha contém até 3 campos (separados por um ou mais espaços). O primeiro campo é o nome da alternativa, o segundo é o estado (se B<auto> ou B<manual>), e o último contem a escolha actual na alternativa (cuidado: é um nome de ficheiro, e pode conter espaços).

note: type: textblock
en: Read configuration of alternatives on standard input in the format generated by B<--get-selections> and reconfigure them accordingly (since version 1.15.0).
pt: Lê a configuração de alternativas na entrada standard no formato gerado por B<--get-selections> e reconfigura-as adequadamente (desde versão 1.15.0).

note: type: textblock
en: Display information about the link group like B<--display> does, but in a machine parseable way (since version 1.15.0, see section L</QUERY FORMAT> below).
pt: Mostra informação acerca do grupo link como o B<--display> faz mas num modo analisável por máquina (desde versão 1.15.0, Veja secção L</FORMATO DE CONSULTA> abaixo.

note: type: textblock
en: Display all targets of the link group.
pt: Mostra todas as metas do grupo de links.

note: type: textblock
en: Show available alternatives for a link group and allow the user to interactively select which one to use.  The link group is updated.
pt: Mostra as alternativas disponíveis para um grupo de links e permite ao utilizador seleccionar interactivamente qual delas usar. O grupo de links é actualizado.

note: type: textblock
en: Specifies the alternatives directory, when this is to be different from the default.  Defaults to «I<%CONFDIR%/alternatives>».
pt: Especifica o directório alternativo, quando é suposto este ser diferente do predefinido. A predefinição é «I<%CONFDIR%/alternatives>».

note: type: textblock
en: Specifies the administrative directory, when this is to be different from the default.  Defaults to «I<%ADMINDIR%/alternatives>» if B<%ADMINDIR_ENVVAR%> has not been set.
pt: Especifica o directório administrativo, quando este deve ser diferente do predefinido. A predefinição é «I<%ADMINDIR%/alternatives>» se B<%ADMINDIR_ENVVAR%> não estiver definido.

note: type: textblock
en: Specifies the installation directory where alternatives links will be created (since version 1.20.1).  Defaults to «I</>» if B<%INSTDIR_ENVVAR%> has not been set.
pt: Especifica o directório de instalação onde os links alternativos serão criados (desde versão 1.20.1). A predefinição é «I</>» se B<%INSTDIR_ENVVAR%> não estiver definido.

note: type: textblock
en: Specifies the root directory (since version 1.20.1).  This also sets the alternatives, installation and administrative directories to match.  Defaults to «I</>» if B<%INSTDIR_ENVVAR%> has not been set.
pt: Especifica o directório raiz (desde 1.20.1). Isto também define alternativas, directórios de instalação e administração para corresponder. A predefinição é «I</>» se B<%INSTDIR_ENVVAR%> não estiver definido.

note: type: textblock
en: Specifies the log file (since version 1.15.0), when this is to be different from the default (%LOGDIR%/alternatives.log).
pt: Especifica o ficheiro de relatório (desde a versão 1.15.0), quando este é suposto ser diferente do predefinido (%LOGDIR%/alternatives.log).

note: type: textblock
en: Allow replacing or dropping any real file that is installed where an alternative link has to be installed or removed.
pt: Permite substituir ou largar qualquer ficheiro real que está instalado quando um link alternativo tem de ser instalado ou removido.

note: type: textblock
en: Skip configuration prompt for alternatives which are properly configured in automatic mode.  This option is only relevant with B<--config> or B<--all>.
pt: Salta o aviso de configuração para alternativas que as quais já estão correctamente configuradas em modo automático. Esta opção é apenas relevante com B<--config> ou B<--all>.

note: type: textblock
en: Do not generate any comments unless errors occur.
pt: Não gera nenhuns comentários, a menos que ocorram erros.

note: type: textblock
en: Generate more comments about what is being done.
pt: Gera mais comentários acerca do que está a ser feito.

note: type: textblock
en: Generate even more comments, helpful for debugging, about what is being done (since version 1.19.3).
pt: Gera ainda mais comentários, úteis para depuração, acerca do que está a ser feito (desde versão 1.19.3).

note: type: textblock
en: Problems were encountered whilst parsing the command line or performing the action.
pt: Foram encontrados problemas ao analisar a linha de comandos ou ao executar a acção.

note: type: textblock
en: If set and the B<--admindir> option has not been specified, it will be used as the base administrative directory.
pt: Se definido e se a opção B<--admindir> não foi especificada, será usado como o directório administrativo base.

note: type: textblock
en: The default alternatives directory.  Can be overridden by the B<--altdir> option.
pt: O directório de alternativas predefinido. Pode ser sobreposto pela opção B<--altdir>.

note: type: textblock
en: The default administration directory.  Can be overridden by the B<--admindir> option.
pt: O directório de administração predefinido. Pode ser sobreposto pela opção B<--admindir>.

note: type: =head1
en: QUERY FORMAT
pt: FORMATO DE CONSULTA

note: type: textblock
en: The B<--query> format is using an RFC822-like flat format.  It's made of I<n> + 1 stanzas where I<n> is the number of alternatives available in the queried link group.  The first stanza contains the following fields:
pt: O formato B<--query> está a usar um formato liso tipo RFC822. É composto de I<n> estrofes + 1 onde I<n> é o número e alternativas disponíveis no grupo de link questionado. A primeira estrofe contem os seguintes campos:

note: type: textblock
en: The alternative name in the alternative directory.
pt: O nome alternativo no directório alternativo.

note: type: textblock
en: The generic name of the alternative.
pt: O nome genérico da alternativa.

note: type: textblock
en: When this field is present, the B<next> lines hold all slave links associated to the master link of the alternative.  There is one slave per line.  Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave link.
pt: Quando este campo está presente, as B<próximas> linhas contêm todas os links escravos associados ao link mestre da alternativa. Há um escravo por linha. Cada linha contem um espaço, o nome genérico da alternativa escravo, outro espaço, e o caminho para o link escravo.

note: type: textblock
en: The status of the alternative (B<auto> or B<manual>).
pt: O estado da alternativa (B<auto> ou B<manual>).

note: type: textblock
en: The path of the best alternative for this link group.  Not present if there is no alternatives available.
pt: O caminho da melhor alternativa para este grupo de links. Não presente se não existirem alternativas disponíveis.

note: type: textblock
en: The path of the currently selected alternative.  It can also take the magic value B<none>.  It is used if the link doesn't exist.
pt: O caminho da alternativa seleciona actualmente. Também pode tirar o valor mágico B<none>. É usado quando o link não existe.

note: type: textblock
en: The other stanzas describe the available alternatives in the queried link group:
pt: As outras estrofes descrevem as alternativas disponíveis no grupo de links questionado.

note: type: textblock
en: Path to this stanza's alternative.
pt: Caminho para a alternativa desta estrofe.

note: type: textblock
en: Value of the priority of this alternative.
pt: Valor da prioridade desta alternativa.

note: type: textblock
en: When this field is present, the B<next> lines hold all slave alternatives associated to the master link of the alternative.  There is one slave per line.  Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave alternative.
pt: Quando este campo está presente, as B<próximas> linhas contêm todas as alternativas escravas associadas ao link mestre da alternativa. Há um escrava por linha. Cada linha contem um espaço, o nome genérico da alternativa escravo, outro espaço, e o caminho para a alternativa escravo.

note: type: =head2
en: Example
pt: Exemplo

note: type: textblock
en: With B<--verbose> B<update-alternatives> chatters incessantly about its activities on its standard output channel.  If problems occur, B<update-alternatives> outputs error messages on its standard error channel and returns an exit status of 2.  These diagnostics should be self-explanatory; if you do not find them so, please report this as a bug.
pt: Com B<--verbose> o B<update-alternatives> fala incessantemente acerca das suas atividades no seu canal de saída standard. Se ocorrerem problemas, o B<update-alternatives> envia mensagens de erro no seu canal de erros standard e retorna um estado de saída de 2. Estes diagnósticos deverão ser suficientemente explicativos, se você acha que não o são, por favor reporte isso como um bug.

note: type: textblock
en: There are several packages which provide a text editor compatible with B<vi>, for example B<nvi> and B<vim>.  Which one is used is controlled by the link group B<vi>, which includes links for the program itself and the associated manual page.
pt: Existem vários pacotes que fornecem um editor de texto compatível com o B<vi>, por exemplo e B<nvi> e o B<vim>. Qual deles é o usado é controlado pelo grupo de links B<vi>, que inclui links para o próprio programa e o manual associado.

note: type: textblock
en: To display the available packages which provide B<vi> and the current setting for it, use the B<--display> action:
pt: Para mostrar os pacotes disponíveis que fornecem o B<vi> e a configuração actual para ele, use a acção B<--display>.

note: type: textblock
en: To choose a particular B<vi> implementation, use this command as root and then select a number from the list:
pt: Para escolher uma implementação particular do B<vi>, use este comando como root e depois selecione um número da lista.

note: type: textblock
en: To go back to having the B<vi> implementation chosen automatically, do this as root:
pt: Para voltar atrás e ter a implementação B<vi> escolhida automaticamente, faça isto como root:

note: type: textblock
en: L<ln(1)>, FHS (the Filesystem Hierarchy Standard).
pt: L<ln(1)>, FHS (o Standard de Hierarquia de Sistema de Ficheiros).
