.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "deb822 5" .TH deb822 5 2024-03-10 1.22.6 "dpkg suite" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOME .IX Header "NOME" deb822 \- Formato Debian de dados de controle RFC822 .SH DESCRI\(,C\(~AO .IX Header "DESCRI\(,C\(~AO" O sistema de gest\(~ao de pacotes manipula dados representados num formato comum, conhecido por \fIcontrol data\fR, guardado em \fIcontrol files\fR. Ficheiros de controle s\(~ao usados para pacotes fonte, pacotes bin\('arios e os ficheiros \fB.changes\fR que controlam a instala\(,c\(~ao dos ficheiros que foram enviados (as bases de dados internas do \fBdpkg\fR est\(~ao num formato semelhante). .SH SINTAXE .IX Header "SINTAXE" Um ficheiro de controle consiste de uma ou mais estrofes de campos (as estrofes s\(~ao tamb\('em por vezes referidos como par\('agrafos). As estrofes s\(~ao separadas por linhas vazias. Os analisadores podem aceitar linhas consistindo apenas de U+0020 \fBSPACE\fR e U+0009 \fBTAB\fR como separadores de estrofes, mas os ficheiros de controle devem usar linhas vazias. Alguns ficheiros de controle permitem apenas uma estrofe; outros permitem v\('arias, em qualquer caso cada estrofe geralmente faz refer\(^encia 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\('arios gerados a partir da fonte). A ordem das estrofes em ficheiros de controle \('e significativa. .PP Cada estrofe consiste numa s\('erie de campos de dados.. Cada campo consiste do nome do campo seguido pelo s\('imbolo dois pontos (U+003A \(oq\fB:\fR\(cq), e depois o dado/valor associado a esse campo. O nome do campo \('e composto de caracteres US-ASCII excluindo caracteres de controle, espa\(,co, e os dois pontos (isto \('e, caracteres (i.e., characters de U+0021 \(oq\fB!\fR\(cq at\('e U+0039 \(oq\fB9\fR\(cq, e U+003B \(oq\fB;\fR\(cq at\('e U+007E \(oq\fB~\fR\(cq, inclusive). Os nomes de campo n\(~ao podem come\(,car com o caractere de comentar (U+0023 \(oq\fB#\fR\(cq), nem com o caractere h\('ifen (U+002D \(oq\fB\-\fR\(cq). .PP O campo termina no fim da linha ou no fim da \('ultima linha de continua\(,c\(~ao (ver abaixo). Espa\(,co em branco horizontal (U+0020 \fBSPACE\fR e U+0009 \fBTAB\fR) pode ocorrer imediatamente antes ou ap\('os do valor e \('e ignorado la; \('e convencional colocar um espa\(,co \('unico ap\('os os dois pontos. Por exemplo, um campo pode ser: .Sp .Vb 1 \& Package: dpkg .Ve .PP o nome do campo \('e \fBPackage\fR e o valor do campo \('e \fBdpkg\fR. .PP Campos com valores vazios s\(~ao apenas permitidos em ficheiros de controle de pacotes fonte (\fIdebian/control\fR). Tais campos s\(~ao ignorados. .PP Uma estrofe n\(~ao pode conter mas do que uma inst\(^ancia (c\('opia) de um nome de campo particular. .PP Existem tr\(^es tipos de campos: .RS 4 .IP \fBsimple\fR 4 .IX Item "simple" O campo, incluindo o seu valor, tem de ser uma linha \('unica. Dobrar o campo n\(~ao \('e permitido. Este \('e o tipo de campo predefinido se a defini\(,c\(~ao do campo n\(~ao especificar um tipo diferente. .IP \fBfolded\fR 4 .IX Item "folded" O valor de um campo dobrado \('e uma linha l\('ogica que pode continuar por v\('arias linhas. As linhas ap\('os a primeira s\(~ao chamadas linha de continua\(,c\(~ao e devem come\(,car com um U+0020 \fBSPACE\fR ou um U+0009 \fBTAB\fR. O espa\(,co em branco, incluindo quaisquer novas linhas, n\(~ao \('e significante nos valores de campo de campos dobrados. .Sp O m\('etodo de dobragem \('e semelhante a RFC5322, permitido aos ficheiros de controle que cont\(^em apenas uma estrofe e nenhum campo multi-linha serem lidos por programas analisadores escritos para RFC5322. .IP \fBmultiline\fR 4 .IX Item "multiline" O valor de um campo multi-linha pode comprometer m\('ultiplas linhas de continua\(,c\(~ao. 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\(~ao adicionadas seguindo a mesma sintaxe que as linhas de continua\(,c\(~ao dos campos dobrados. O espa\(,co em branco, incluindo novas linhas, tem significado nos valores dos campos multi-linha. .RE .RS 4 .Sp Em espa\(,co em branco n\(~ao pode aparecer dentro de nomes (de pacotes, arquitecturas, ficheiros ou tudo o resto) ou n\('umeros de vers\(~ao, ou entre os caracteres de relacionamentos de vers\(~ao multi-caractere. .Sp A presen\(,ca de objectivo de um campo, e a sintaxe do seu valor pode diferir entre os tipos de ficheiros de controle. .Sp Os nomes dos campos n\(~ao s\(~ao sens\('iveis a mai\('usculas/min\('usculas, mas \('e usual capitalizar os nomes dos campos usando misturas como mostrado em baixo. Os valores do campos s\(~ao sens\('iveis a mai\('usculas/min\('usculas excepto se a descri\(,c\(~ao do campo diga o contr\('ario. .Sp Separadores de estrofes (linhas vazias) e linhas consistindo apenas de U+0020 \fBSPACE\fR e U+0009 \fBTAB\fR, n\(~ao s\(~ao permitidos dentro de valores de campo ou entre campos. Linhas vazias em valores de campo s\(~ao normalmente escapadas ao representa-las por um U+0020 \fBSPACE\fR seguido de um ponto (U+002E \(oq\fB.\fR\(cq). .Sp Linhas come\(,cadas com U+0023 \(oq\fB#\fR\(cq, sem nenhum espa\(,co em branco a preceder s\(~ao linhas de coment\('arios que s\(~ao apenas permitidos em ficheiros de controle dos pacotes fonte (\fIdebian/control\fR) e em ficheiros \fBdeb\-origin\fR\|(5). Estas linhas de coment\('arios s\(~ao ignoradas, mesmo entre duas linhas de continua\(,c\(~ao. Elas n\(~ao terminam linhas l\('ogicas. .Sp Todos os ficheiros de controle t\(^em de estar codificados em UTF\-8. .RE .SH "VEJA TAMB\('EM" .IX Header "VEJA TAMB\('EM" \&\fBRFC822\fR, \fBRFC5322\fR. .SH TRADU\(,C\(~AO .IX Header "TRADU\(,C\(~AO" Am\('erico Monteiro .PP Se encontrar algum erro na tradu\(,c\(~ao deste documento, por favor comunique para Am\('erico Monteiro .