Vous verrez qu'il y a plusieurs autres fichiers dans le sous-répertoire debian, la plupart d'entre eux avec le suffixe « .ex », ce qui signifie qu'ils sont des exemples. Si vous souhaitez ou devez utiliser une de ces options, examinez-les avec la documentation associée (astuce : le manuel des normes), renommez-les pour enlever le suffixe `.ex', et modifiez-les ainsi que le fichier « rules » si nécessaire. Certains de ces fichiers, les plus utilisés, sont décrits dans les sections suivantes.
Tous les détails ou différences entre le paquet original et votre version debianisée devraient être inclus ici. Voici ce que dh_make crée par défaut :
gentoo for Debian ---------------------- <possible notes regarding this package - if none, delete this file> Josip Rodin <jrodin@jagor.srce.hr>, Wed, 11 Nov 1998 21:02:14 +0100
Nous n'avons rien en particulier à mettre ici - il est permis d'effacer le fichier.
L'une des choses les plus irritantes à propos des logiciels est de consacrer beaucoup de temps et d'efforts pour configurer un programme et de voir une seule mise à jour détruire tous vos changements. Debian résout ce problème en marquant les fichiers de configuration de sorte que quand vous mettez à jour un paquet, il vous sera demandé si vous voulez gardez votre vieille configuration ou pas. Vous faites ceci en entrant le chemin complet de chaque fichier de configuration (en général sous /etc), un par ligne dans un fichier nommé conffiles.
Gentoo a un fichier de configuration, /etc/gentoorc, et nous le mettons dans « conffiles ». Il n'est pas nécessaire d'avoir ce fichier si votre programme n'a pas de fichier de configuration.
Ce fichier spécifie les répertoires dont nous avons besoin mais que la procédure d'installation normale (make install) ne crée pas.
Par défaut, il ressemble à ceci :
usr/bin usr/sbin
Remarquez que le préfixe slash n'est pas inclus. Nous devrions normalement le changer comme ceci :
usr/X11R6/bin usr/X11R6/man/man1
mais ces répertoires sont déjà créés dans Makefile, donc nous n'avons pas besoin de ce fichier, et pouvons l'effacer.
Les fichiers finissant en *.ex sont des exemples pour savoir comment ajouter ce genre de support dans le paquet. Pour utiliser l'un d'entre eux, éditez le et retirez l'extension .ex. Si vous ne voulez pas l'utiliser, effacez-le.
Votre programme devrait avoir une page de manuel. S'il n'en a pas, ceci est un
squelette que vous pouvez remplir. Lisez la page de manuel de
man(7)
pour une brève description de la création d'une page de
manuel. Faites attention de donner à ce fichier le nom du programme et
l'extension de la section dans laquelle il doit aller. Voici une courte liste
:
Section | Description | Notes 1 Commandes utilisateur Commandes ou scripts exécutables. 2 Appel système Fonctions fournies par le noyau. 3 Appel bibliothèque Fonctions des bibliothèques système. 4 Fichiers spéciaux D'ordinaire trouvés dans /dev. 5 Formats de fichiers Par ex. le format /etc/password. 6 Jeux Ou d'autres programmes frivoles. 7 Paquets de macros Comme les macros de man. 8 Administration système Des programmes d'habitude exécutées par root. 9 Routines noyau Appels non standards et routines internes.
Donc, la page de manuel de gentoo devrait être appelée gentoo.1, ou gentoo.1x parce que c'est un programme X11. Il n'y avait pas de page de manuel gentoo.1 dans les sources original, donc j'en ai écrit un à partir de l'exemple et de la documentation amont.
Les utilisateurs de X Window ont un gestionnaire de fenêtres avec un menu qui peut être configuré. S'ils ont installés le paquet 'menu' de Debian, un ensemble de menu pour chaque programme sur le système sera créé pour eux. Ceci n'est pas requis pas le règlement Debian, mais les utilisateurs apprécieront certainement. Nous pouvons ajouter Gentoo aux menus en éditant ce fichier. Voici le défaut que dh_make crée :
?package(gentoo):needs=X11|text|vc|wm section=Apps/see-menu-manual\ title="gentoo" command="/usr/bin/gentoo"
Le premier champ spécifie le genre d'interface dont le programme a besoin (i.e. text ou X11). Le suivant est le menu et le sous-menu dans lesquels l'entrée devrait apparaître. La liste courante des sections se trouve dans /usr/share/doc/debian-policy/menu-policy.html/ch2.html#s2.1. Le troisième est le nom du programme. Le quatrième est l'icône pour le programme ou rien s'il n'en a pas. Le cinquième est le texte réel qui apparaîtra dans le menu. Le sixième est la commande qui lance le programme.
Maintenant nous changeons l'entrée menu en ceci :
?package(gentoo):needs=X11 section=Apps/Misc \ title="Gentoo" command="/usr/X11R6/bin/gentoo"
Voir menufile(5)
, update-menus(1)
et
/usr/share/doc/debian-policy/menu-policy.html/ pour plus d'information.
Vous pouvez utiliser ce fichier en plus des programmes uscan(1)
et
de uupdate(1)
(dans le paquet devscripts) pour surveiller le site
sur lequel vous avez obtenu les sources. Voici ce que j'y ai mis :
# watch control file for uscan # Site Directory Pattern Version Script ftp.obsession.se /gentoo gentoo-(.*)\.tar\.gz debian uupdate
Astuce: connectez-vous à Internet, et essayez d'exécuter 'uscan' dans le répertoire du programme une fois que vous avez créer ce fichier. Et lisez les pages de manuel.
Si votre paquet a de la documentation sous format HTML ou autre (à l'exclusion
des pages de manuel et des documents info), vous devriez utiliser le fichier
`doc-base' pour l'enregistrer, de sorte que l'utilisateur puisse le trouver
avec par exemple dhelp(1)
ou dwww(1)
.
Voici ce à quoi le fichier doc-base de gentoo ressemble :
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
Pour plus d'information sur le format de ce fichier, voir
install-docs(1)
et le manuel de doc-base, dans
/usr/doc/doc-base/doc-base.html/index.html.
Ces fichiers sont nommés scripts de responsable. Ils sont placés dans la zone de contrôle du paquet et sont exécutés par dpkg lorsque votre paquet est installé, mis à jour ou supprimé.
Pour l'instant, vous devriez éviter les scripts de responsable si vous le pouvez parce qu'ils ont tendance à être complexes. Pour plus d'information regardez dans le Manuel de Création de Paquets, et examinez les fichiers d'exemples fournis par dh_make.
Nous sommes maintenant prêt pour construire le paquet.
jrodin@jagor.srce.hr
frederic.dumont@freeworld.be