NOME

       deb-changes - Formato Debian de ficheiros de alterações

SINOPSE

       filename.changes

DESCRIÇÃO

       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.

CAMPOS

       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.

BUGS

       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.

VEJA TAMBÉM

       deb822(5), deb-src-control(5), deb-version(7).

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