
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

deb822 - Formato Debian de dados de controle RFC822

=head1 DESCRIÇÃO

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).

=head1 SINTAXE

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.

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<->’).

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:

=over 

 Package: dpkg

=back

o nome do campo é B<Package> e o valor do campo é B<dpkg>.

Campos com valores vazios são apenas permitidos em ficheiros de controle de pacotes fonte (I<debian/control>). Tais campos são ignorados.

A stanza must not contain more than one instance of a particular field name.

Existem três tipos de campos:

=over 

=over 

=item B<simple>

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.

=item B<folded>

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.

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.

=item B<multiline>

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.

=back

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.

A presença de objectivo de um campo, e a sintaxe do seu valor pode diferir entre os tipos de ficheiros de controle.

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.

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<.>’).

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 B<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.

Todos os ficheiros de controle têm de estar codificados em UTF-8.

=back

=head1 VEJA TAMBÉM

B<RFC822>, B<RFC5322>.


=head1 TRADUÇÃO

Américo Monteiro

Se encontrar algum erro na tradução deste documento, por favor comunique para
Américo Monteiro <a_monteiro@gmx.com>.
