NOME

       deb822 - Formato Debian de dados de controle RFC822

DESCRIÇÃO

       O sistema de gestão de pacotes manipula dados representados num formato comum, conhecido por control
       data, guardado em control files. Ficheiros de controle são usados para pacotes fonte, pacotes binários e
       os ficheiros .changes que controlam a instalação dos ficheiros que foram enviados (as bases de dados
       internas do dpkg estão num formato semelhante).

SINTAXE

       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 SPACE e U+0009 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.

       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 ‘:’), 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 ‘!’ até U+0039 ‘9’, e U+003B ‘;’ até U+007E ‘~’, inclusive). Os
       nomes de campo não podem começar com o caractere de comentar (U+0023 ‘#’), nem com o caractere hífen
       (U+002D ‘-’).

       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 SPACE e U+0009 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:

        Package: dpkg

       o nome do campo é Package e o valor do campo é dpkg.

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

       Uma estrofe não pode conter mas do que uma instância (cópia) de um nome de campo particular.

       Existem três tipos de campos:

           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.

           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 SPACE ou um
               U+0009 TAB. O espaço em branco, incluindo quaisquer novas linhas, não é significante nos  valores
               de campo de campos dobrados.

               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.

           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.

           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.

           Separadores de estrofes (linhas vazias) e linhas consistindo apenas de U+0020 SPACE e U+0009 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 SPACE seguido de um ponto (U+002E ‘.’).

           Linhas começadas com U+0023 ‘#’, 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 (debian/control) e em ficheiros
           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.

VEJA TAMBÉM

       RFC822, RFC5322.

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

1.22.18                                            2025-04-28                                          deb822(5)