[ anterior ] [ Conteúdo ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ 8 ] [ 9 ] [ 10 ] [ próximo ]


Guia do Novo Mantenedor Debian
Capítulo 5 - Outros arquivo no debian/


Você pode notar que existem vários outros arquivos no subdiretório debian/, a maioria deles com o sufixo '.ex', o que significa que eles são exemplos. Dê uma olhada em todos eles. Se você deseja, ou precisa, utilizar alguma de suas funcionalidades,

Alguns desses arquivos, os mais utilizados, são explicados nas seções seguintes:


5.1 README.Debian

Quaiquer outros detalhes ou discrepâncias entre o pacote original e a sua versão debianizada deve ser documentada aqui.

O dh_make criou um arquivo padrão, como seguinte:

       gentoo for Debian
       -----------------
     
       <notas possíveis acerca deste pacote - se nenhuma, apague este arquivo.>
     
        -- Josip Rodin <joy-mg@debian.org>, Wed, 11 Nov 1998 21:02:14 +0100

Como não temos nada para colocar aqui, apagaremos o arquivo.


5.2 conffiles.ex

Uma das coisas mais irritantes em software é quando você gasta muito tempo e esforço personalizando o seu programa, e uma nova versão dele desfaz todas as suas mudanças. O Debian resolve esse problema marcando os arquivos de configurações de forma que, quando você atualiza um pacote, você será perguntado se quer manter sua configuração antiga ou não.

O modo se fazer isso num pacote é colocando o caminho completo de cada arquivo de configuração (normalmente em /etc), um por linha, num arquivo chamado conffiles. O gentoo tem um arquivo de configuração, /etc/gentoorc, enós vaos adicioná-lo no arquivo conffiles.

Se o seu programa utiliza arquivos de configuração mas também os sobrescreve por conta própria, é melhor não marcá-los nos 'conffiles' pois senão o dpkg irá perguntar aos usuários se eles querem verificar as mudanças o tempo todo.

Se o programa que você está empacotando precisa que todo usuário modifique o arquivo para funcionar, considere também não marcar o arquivo no 'conffiles'.

Você pode pode utilizar exemplos de arquivos de configuração dos 'scripts de mantenedor'. Para maiores informações veja postinst.ex, preinst.ex, postrm.ex, prerm.ex, Seção 5.12.

Se o seu programa não tem arquivos de configurações, você pode apagar o arquivo conffiles do diretório debian/.


5.3 cron.d.ex

Se o seu pacote precisa agendar tarefas regularmente para funcionar adequadamente, você pode usar este arquivo para definir isso.

Note que isso não inclui rotação de logs; para isso, veja dh_installlogrotate(1) e logrotate(8).

Se não, remova este arquivo.


5.4 dirs

Este arquivo especifica os diretórios que nós precisamos mas o processo de instalação normal (make install), por algum motivo, não cria.

Por padrão, ele é como seguinte:

       usr/bin
       usr/sbin

Note que a barra precedente não é incluída. Nós normalmente teríamos alterado para ficar como seguinte:

       usr/bin
       usr/man/man1

mas estes diretórios já são criados no Makefile, e portanto não precisamos deste arquivo e vamos então apagá-lo.


5.5 docs

Este arquivo especifica os nomes dos arquivos de documentação que o dh_installdocs irá instalar no diretório temporário para nós.

Por padrão, ele incluirá todos os arquivos existentes no topo do diretório-fonte que são chamados 'BUGS', 'README*', 'TODO', etc.

Para o gentoo, eu também incluí mais coisas:

       BUGS
       CONFIG-CHANGES
       CREDITS
       ONEWS
       README
       README.gtkrc
       TODO

Nós podemos também remover este arquivo e listas estes arquivo no comando dh_installdocs do arquivo rules, como seguinte:

             dh_installdocs BUGS CONFIG-CHANGES CREDITS ONEWS README \
                            README.gtkrc TODO

Entretando, infelizmente você pode não ter arquivos deste tipo no código-fonte do seu pacote. Neste caso, você pode remover este arquivo. Mas não remova a invocação do dh_installdocs do arquivo rules pois ele é utilizado para instalar o arquivo de copyright e outras coisas.


5.6 emacsen-*.ex

Se o seu pacote fornece arquivos do Emacs que pode ser 'bytecompilados' no momento da instalação do pacote, você pode utilizar estes arquivos para definir isso.

Eles são instalados no diretório temporário pelo dh_installemacsen(1), portanto não se esqueça de descomentar essa linha no arquivo rules se você quer utilizar isso.

Se você não precisa destes, remova-os.


5.7 init.d.ex

Se o seu pacote é um daemon que precisa ser executado na inicialização do sistema, você obviamente desobedeceu minha recomendação inicial, não é mesmo? :-)

Isto é meramente um esqueleto genérico para um script /etc/init.d/, e você provavelmente terá de editá-lo muito. Ele é instalado no diretório temporário pelo dh_installinit(1).

Se você não precisa disto, remova o arquivo.


5.8 manpage.1.ex, manpage.sgml.ex

Seu(s) programa(s) devem ter manuais. Se não têm, cada um destes arquivos são modelos que você pode preencher.

Manuis são normalmente escritos em nroff(1). O exemplo manpage.1.ex é escrito em nroff também. Você o manual man(7) para uma breve descrição de como editar um destes arquivos.

Se, por outro lado, você prefere escrever em sgml ao invés de nroff, você pode usar o modelo manpage.sgml.ex. Se você for fazer isso, você tem de:

E lembre-se de renomear o arquivo para algo como gentoo.sgml!

O nome do arquivo final do maual deve incluir o nome do programa que está documentando, e portanto nós iremos renomeá-lo de 'manpage' para 'gentoo'. O nome do arquivo também inclui '.1' como o primeiro sufixo, o que significa que é um manual para um comando de usuário. Certifique-se de verificar que seção é, de fato, a correta. Eis uma pequena lista de seções de manuais.

       Section |     Description       |     Notes
          1     Comandos de usuário      Comando executáveis ou scripts.
          2     Chamadas de sistema      Funções fornecidas pelo kernel.
          3     Chamadas de biblioteca   Funções dentro de bibliotecas do sistema.
          4     Arquivos especiais       Normalmente encontrados em /dev
          5     Formatos de arquivo      Ex: o formato do /etc/passwd
          6     Jogos                    Ou outros programas frívolos
          7     Pacotes de Macro         Como macros.
          8     Administração de sistema Programas típicamente executados como root.
          9     Rotinas de Kernel        Chamadas internas e não-padronizadas.

Então o manual do gentoo deve ser chamado gentoo.1. Não existia um manual gentoo.1 no fonte original, então eu o escrevi utilizando a informação do exemplo e da documentação.


5.9 menu.ex

Usuários de sistemas X-Window normalmente tem um manipulador de janelas com um menu que pode ser personalizado para executar programas. Se eles tiverem o pacote do Debian menu, um conjunto de menus para programa no sistema será criado para eles.

Eis o arquivo menu.ex padrão que o dh_make criou:

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

O primeiro campo após o caractere de dois-pontos é 'needs', e especifica que tipo de interface o programa precisa. Mude isto para uma das alternativas listadas, como 'text' ou 'X11'.

O seguinte é 'section', onde as entradas de menu e submenus devem aparecer. A lista atual de seções está em: /usr/share/doc/debian-policy/menu-policy.html/ch2.html#s2.1

O campo 'title' é o nome do programa. Você pode começar este em caixa alta, se quiser, desde que seja curto.

Finalmente, o campo 'command' é o comando que executa o programa.

Agora nós iremos mudar a entrada de menu para o seguinte:

       ?package(gentoo): needs=X11 section=Apps/Tools title="Gentoo" command="gentoo"

Você pode também adicionar outros campos como 'logtitle', 'icon', 'hints', etc. Veja menufile(5), update-menus(1) e /usr/share/doc/debian-policy/menu-policy.html/ para maiores informações.


5.10 watch.ex

Este arquivo é utilizado para configurar os programas uscan(1) e uupdate(1) (no pacote devscripts). Estes são utilizados para monitorar o site de onde você pegou o código-fonte original.

Eis o que eu coloco nele:

       # Arquivo de controle de monitoramento para o uscan
       # Site                Diretório        Padrão                        Versão        Script
       ftp.obsession.se        /gentoo                gentoo-(.*)\.tar\.gz        debian        uupdate

Dica: conecte à internet, e tente rodar o 'uscan' no diretório do programa assim que você criar o arquivo. E leia os manuais! :)


5.11 ex.package.doc-base

Se o seu pacote tem outra documentação fora o manual e info, você deve utilizar o arquivo 'doc-base' para registrá-lo, de forma que o usuário possa encontrá-la com, por exemplo, dhelp(1), dwww(1) ou doccentral(1).

Isto normalmente inclui arquivos HTML, PS ou PDF, distribuídos em /usr/share/doc/nome_do_pacote/

Eis como ficaria o arquivo do doc-base do gentoo:

       Document: gentoo
       Title: Manual do Gentoo
       Author: Emil Brink
       Abstract: Este manual descreve o que o Gentoo é, e como pode ser utilizado.
       Section: Apps/Tools
     
       Format: HTML
       Index: /usr/share/doc/gentoo/html/index.html
       Files: /usr/share/doc/gentoo/html/*.html

Para maiores informações sobre esse formato, veja install-docs(8) e o manual do doc-base, em /usr/share/doc/doc-base/doc-base.html/.


5.12 postinst.ex, preinst.ex, postrm.ex, prerm.ex

Estes arquivos são chamados scripts de mantenção. Eles são scripts que são postos na área de controle do pacote e executados pelo dpkg quando seu pacote é instalado, atualizado ou removido.

Por enquanto, você deve evitar qualquer edição manual dos scripts de manutenção se você puder, pois eles tendem a ficar complexos. Para maiores informações leia o capítulo 6 do Debian-Policy e analise estes arquivos de exemplo fornecidos pelo dh_make.


[ anterior ] [ Conteúdo ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ 8 ] [ 9 ] [ 10 ] [ próximo ]


Guia do Novo Mantenedor Debian

version 1.2, 6 April 2002.

Josip Rodin joy-mg@debian.org
Traduzido por: Mahdi mahdi@dcc.ufmg.br
Revisado por: Priscilla Pimenta priscilla@minaslivre.org