Capítulo 1. Prefácio

# Capítulo 1. Prefácio

Se você é um utilizador Debian já com alguma experiência [1], você pode ter encontrado as seguintes situações:

- Você deseja instalar um certo pacote de software que ainda não existe no arquivo Debian.
- Você deseja actualizar um pacote Debian com a versão mais recente do autor.
- Você deseja corrigir bugs num pacote Debian com algumas patches.

Se você quer criar um pacote Debian para preencher essas necessidades e partilhar o seu trabalho com a comunidade, você é a audiência alvo deste guia como um futuro maintainer Debian. [2] Bem vindo à comunidade Debian.

Debian tem muitas regras sociais e técnicas e convenções a seguir, pois é uma grande organização de voluntários com uma história rica. Debian tem também desenvolvido uma extensiva matriz de ferramentas de empacotamento e ferramentas de manutenção de arquivo para compilar conjuntos consistentes de pacotes binários que endereçam muitos objectivos técnicos:

- pacotes têm dependências de pacotes e patches declaradas claramente e compilam corretamente a partir de rascunho num ambiente de compilação limpo (“Secção 6.6, “Ficheiro debian/control””, “Secção 6.9, “Ficheiros debian/patches/*””, “Secção 4.7, “Configuração do sbuild””)
- compilação de pacotes contra muitas arquitecturas (“Secção 9.3, “Variáveis para debian/rules””)
- compilações são reproduzíveis (“Secção 10.7, “Compilação reproduzível””)
- a multi-arquitectura é suportada (“Secção 10.10, “Multiarch””)
- é possível boot strapping para novas arquitecturas (“Secção 10.5, “Bootstrapping””)
- compilações usam bandeiras de compilação específicas para endurecer segurança (“Secção 10.6, “Endurecimento de compilação””)
- pacotes são otimizados ao serem divididos em vários pacotes binários (“Secção 10.11, “Divisão de um pacote binário Debian””)
- nomes de bibliotecas e conteúdos são geridos para assegurar transições suaves nas actualizações (“Secção 10.18, “Transição de biblioteca””)
- instalações usam correntemente perguntas interativas (quando as usam) (“Secção 10.22, “debconf””)
- integração contínua é usada para garantir qualidade (“Secção 10.4, “Integração contínua””)
- …​

Estes factores podem ser um pouco esmagadores para muitos novos futuros maintainers Debian. Este guia destina-se a fornecer pontos de entrada para os ajudar a começar. Ele cobre o seguinte:

- O que você deve saber antes de se envolver com Debian como um futuro responsável de manutenção (maintainer).
- Como é criar um pacote Debian simples.
- Que tipo de regras existem para criar um pacote Debian.
- Dicas para criar o pacote Debian com mínimo esforço.
- Exemplos de criar pacotes Debian em cenários típicos.

O autor reconheceu as limitações ao atualizar o original “Guia de Novos Maintainers” com o pacote dh-make e decidiu criar uma ferramenta alternativa com documentação a acompanhar para endereçar os requerimentos modernos como o multi-arch. Isto resultou no pacote debmake, inicialmente lançado com versão 4.0 em 2013. a versão actual do debmake é 5.1.4. Vem com este “Guia para Maintainers Debian” actualizado no pacote debmake-doc (versão: 1.29-1). (Em 2016, o dh-make foi portado de Perl para Python com funcionalidades actualizadas.)

Muitas tarefas e dicas foram integradas no comando debmake permitindo que este guia seja conciso. Este guia também oferece muitos exemplos em empacotamento para você começar.

| Cuidado
Demora muitas horas a criar e manter apropriadamente pacotes Debian. O maintainer Debian tem de ser tanto competente como diligente tecnicamente para aceitar este desafio.

Alguns tópicos importantes são explicados em detalhes. Enquanto alguns deles podem parecer irrelevantes para si, por favor seja paciente. Certos casos de canto são omitidos, e alguns tópicos são apenas cobertos através de referências externas. Estas são escolhas intencionais para manter este guia simples e passível de manter.

[1] Você precisa saber um pouco sobre programação de Unix mas não precisa ser muito experiente. Você pode aprender sobre manuseamento básico de um sistema Debian consultando “Debian Reference”. Também contém tópicos a aprender sobre programação de Unix.

[2] Se você não está interessado em partilhar o pacote Debian, você pode endereçar as suas necessidades locais ao compilar e instalar o pacote fonte de autor corrigido em /usr/local/.

Guia para Maintainers de Debian |  | Capítulo 2. Visão geral