deb-changes - Formato Debian de ficheiros de
alterações
Cada envio Debian é composto de um ficheiro de controle
.changes, o qual contém um número de campos em formato
deb822(5).
Cada campo começa com uma etiqueta, tal como Source
ou 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 Description, Changes, Files,
Checksums-Sha1 e Checksums-Sha256 de múltiplos campos,
ver abaixo).
Os dados de controle podem estar inclusos numa assinatura OpenPGP
ASCII Armored, como especificado em RFC4880.
- Format:
format-version (necessário)
- 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 é 1.8.
- Date:
release-date (necessário)
- 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
deb-changelog(5).
O valor deste campo é geralmente extraído do
ficheiro debian/changelog.
- Source:
source-name [(source-version)]
(necessário)
- O nome do pacote fonte. Se a versão de fonte diferir da
versão binária, então o source-name
será seguido por um source-version em parêntesis.
Isto pode acontecer quando o envio ao arquivo é um envio de
não-maintainer apenas-binário.
- Binary:
binary-package-list (necessário em contexto)
- 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).
- Architecture:
arch-list
- Lista as arquitecturas dos ficheiros actualmente a serem enviados ao
arquivo. Arquitecturas comuns são amd64, armel,
i386, etc. Note que o valor 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 source está
também presente. Wildcards de arquitectura nunca devem estar
presentes na lista.
- Version:
string-de-versão (obrigatório)
- 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
deb-version(7).
- Distribution:
distributions (necessário)
- Lista uma ou mais distribuições separadas por espaços
onde esta versão deve ser instalada quando é enviada para o
arquivo.
- Urgency:
urgency (recomendado)
- A urgência do envio. Os valores presentemente conhecidos, em ordem
ascendente de prioridade, são: low, medium,
high, critical e emergency.
- Maintainer:
fullname-email (necessário)
- Deverá estar no formato “Joe Bloggs
<jbloggs@example.org>”, e é tipicamente a pessoa que
criou o pacote, e não o autor do software que foi empacotado.
- Changed-By:
fullname-email
- Deverá estar no formato “Joe Bloggs
<jbloggs@example.org>”, e é tipicamente a pessoa que
preparou as alterações no pacote para este
lançamento.
- Description:
(recomendado)
- binary-package-name -
binary-package-summary
- Este campo multi-linha contem uma lista de nomes de pacotes
binários seguida por um espaço, um traço
(‘-’) a as suas descrições curtas
possivelmente truncadas. Se o envio for apenas-fonte, então o campo
é omitido (desde dpkg 1.19.3).
- Closes:
bug-number-list
- 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.
- Binary-Only:
yes
- Este campo indica que o envio é uma compilação de
não-maintainer apenas-binário. É originado a partir
da chave/valor binary-only=yes da entrada de meta-dados do
changelog.
- Built-For-Profiles:
profile-list
- Este campo especifica uma lista de perfis de compilação
separados por espaços em branco, do que com que este envio foi
compilado.
- Changes:
(necessário)
- changelog-entries
- 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.
- Files:
(necessário)
- md5sum size section priority
filename
- Este campo multi-linha contem uma lista de ficheiros com um md5sum,
tamanho, secção e prioridade para cada um.
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.
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 Checksums relacionados.
- Checksums-Sha1:
(necessário)
- Checksums-Sha256:
(necessário)
- checksum size filename
- 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 Checksums-Sha1 e SHA-256 parar
Checksums-Sha256.
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.
Estes campos listam todos os ficheiros que fizeram o envio. A
lista de ficheiros nestes campos tem de corresponder à lista de
ficheiros no campo Files e aos outros campos Checksums
relacionados.
O campo Files é inconsistente com os outros campos
Checksums. Os campos Changed-By e Maintainer têm
nomes confusos. O campo Distribution contem informação
acerca do que é comum referir-se como uma suite.
Américo Monteiro
Se encontrar algum erro na tradução deste documento,
por favor comunique para Américo Monteiro
<a_monteiro@gmx.com>.