[ anterior ] [ Conteúdo ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ próximo ]

Guia dos Novos Mantenedores Debian
Capítulo 5 - Outros arquivos no debian/


Você verá que existem vários outros arquivos dentro do subdiretório debian/, a maioria deles com o sufixo `.ex', significando que eles são exemplos. Se você deseja ou precisa usar qualquer desses recursos, examine-os e sua documentação relacionada (dica: o Manual de Política), renomeie-os para remover o sufixo `.ex', e modifique-os e o arquivo rules se necessário. Alguns desses arquivos, aqueles comumente usados, são explicados nas seções seguintes.


5.1 README.Debian

Qualquer detalhe extra ou discrepâncias entre o pacote original e sua versão 'debianizada' devem ser documentadas aqui. DH_make cria um padrão, ele é assim:

       gentoo for Debian
       ----------------------
     
       <possible notes regarding this package - if none, delete this file>
     
       Josip Rodin <joy-mg@debian.org>, Wed, 11 Nov 1998 21:02:14 +0100

Já que não temos nada para colocar aqui - é permitida a deleção desse arquivo.


5.2 conffiles

Uma das coisas mais chatas dos softwares é quando você gasta um grande tempo e esforço customizando um programa apenas para vir uma atualização e perder suas mudanças. O Debian resolve esse problema marcando os arquivos de configuração para que quando você atualize um pacote ele pergunte se você quer manter sua velha configuração ou não. Você faz isso entrando o caminho completo de cada arquivo de configuração (eles estão normalmente no /etc) um por linha, num arquivo chamado conffiles.

Gentoo tem um conffile, /etc/gentoorc, e nós iremos colocá-lo no arquivo `conffiles'. Não é necessário atualmente ter aquele arquivo, se seu programa não tem arquivos de configuração.


5.3 dirs

Esse arquivo especifica os diretórios que nós precisamos mas que a instalação normal, por alguma razão, não cria. Por padrão, ele é assim:

       usr/bin
       usr/sbin

Note que a barra inicial não é incluída. Nós normalmente o teríamos modificado para ficar assim:

       usr/X11R6/bin
       usr/X11R6/man/man1

mas esses diretórios já são criados no Makefile, então nós não precisamos desses arquivos, podemos deletá-los.


5.4 manpage.1.ex

Os arquivos que terminam com *.ex são exemplos de como adicionar um tipo de suporte no pacote. Para usar um deles, edite e remova a extensão .ex dele. Se você não quer usá-lo, apenas delete.

Seu programa deve ter uma página de manual. Se não, esse é o esqueleto que você pode preencher. Veja as páginas de manual do man(7) para uma breve descrição do nome do programa de como criar uma página de manual. Esteja certo de renomear esse arquivo para o nome do programa e fazer a extensão dele a seção do manual para que ele deve ir. Aqui uma pequena lista:

       Section |     Description     |     Notes
          1      Comandos do usuário          Comandos executáveis ou scripts.
          2     Chamadas de sistema          Funções providas pelo kernel.
          3     Chamadas de biblioteca      Funções dentro de bibliotecas de sistema.
          4     Arquivos especiais             Normalmente encontrados no /dev.
          5     Formatos de arquivos          Ex: o formato do /etc/passwd
          6     Jogos                                    Ou outros programas do gênero
          7     Pacotes de macro                 Como macros man.
          8     Administração do Sistema  Programas tipicamente rodados pelo root.
          9     Rotinas de Kernel                 Chamadas não-padrão.

Então a página de manual do gentoo deve ser chamada gentoo.1, ou gentoo.1x porque ele é um programa de X. Não havia a página de manual gentoo.1 então eu a escrevi usando informações do exemplo e de documentos externos.


5.5 menu.ex

Usuários de X normalmente têm um gerenciador de janelas com um menu que pode ser customizado para executar programas. Se eles instalaram o pacote "menu" do Debian, um conjunto de menus para cada programa será criado para eles. Isso não é requerido pela Política Debian, mas os usuários vão certamente gostar. Nós podemos adicionar o Gentoo aos menus editando esse arquivo. Aqui está o padrão que o dh_make cria:

       ?package(gentoo):needs=X11|text|vc|wm section=Apps/see-menu-manual\
         title="gentoo" command="/usr/bin/gentoo"

O primeiro campo especifica que tipo de interface o programa precisa (ex: texto ou X11). O próximo é a entrada de menu e submenu que ele deve entrar. A lista atual de seções está em: /usr/share/doc/debian-policy/menu-policy.html/ch2.html#s2.1 O terceiro campo é o nome do programa. O quarto é o ícone para o programa ou nada se não há um. O quinto é o texto que aparecerá no menu. Finalmente, o sexto é o comando que roda o programa.

Vamos mudar a entrada de menu para:

       ?package(gentoo):needs=X11 section=Apps/Misc \
         title="Gentoo" command="/usr/X11R6/bin/gentoo"

Veja menufile(5), update-menus(1) e /usr/share/doc/debian-policy/menu-policy.html/ para maiores informações.


5.6 watch.ex

Você pode usar esse arquivo em adição aos programas uscan(1) e uupdate(1) (no pacote devscripts) para scanear o site de onde você pegou o código original do programa. Aqui está o que eu pus:

       # watch control file for uscan
       # Site		Directory	Pattern			Version	Script
       ftp.obsession.se	/gentoo		gentoo-(.*)\.tar\.gz	debian	uupdate

Dica: conecte à Internet e tente rodar "uscan" no diretório do programa depois de criar esse arquivo. E leia a página de manual.


5.7 ex.doc-base

Se seu pacote tem documentação em HTML ou outro tipo (exceto páginas de manual e documentos de info), você deve usar o arquivo `doc-base' para registrá-lo, então o usuário poderá encontrá-lo com ex: dhelp(1) ou dwww(1).

É assim que o arquivo doc-base do gentoo fica:

       Document: gentoo
       Title: Gentoo Manual
       Author: Emil Brink
       Abstract: This manual describes what Gentoo is, and how it can be used.
       Section: Apps/Tools
     
       Format: HTML
       Index: /usr/share/doc/gentoo/html/index.html
       Files: /usr/share/doc/gentoo/html/*.html

Para informação sobre formato do arquivo, veja install-docs(8) e o manual do doc-base, em /usr/doc/doc-base/doc-base.html/index.html.


5.8 postinst.ex, preinst.ex, postrm.ex, prerm.ex

Esses arquivos são chamados scripts do mantenedor, scripts que são colocados na área de controle do pacote e executadas pelo dpkg quando seu pacote é instalado, atualizado ou removido.

Por agora, você deve tentar evitar editar manualmente scripts de mantenedor se você puder porque eles tendem a se tornar complexos. Para mais informações olhe no Manual de Empacotamento, seção 6, e olhe esses arquivos de exemplo providos pelo dh_make.

Nós devemos agora estar prontos para construir o pacote.


[ anterior ] [ Conteúdo ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ próximo ]

Guia dos Novos Mantenedores Debian

versão 1.0.2, 10 de junho de 2001.

Josip Rodin joy-mg@debian.org
Traduzido por: Gustavo Noronha Silva (KoV) dockov@zaz.com.br
Revisado por: Cristian S. Privat (HellBlade) hellblade@linuxbr.com.br