Re: [RFR2] man://make-kpkg
Sylvain Cherrier <sylvain.cherrier@free.fr> écrivait :
« Merci aux deux relecteurs (Olivier.Trichet et Jean-Luc Coulon)
«
« Voici une version qui tient compte de la majorité de leur travail (sauf
« quand ça coinçait entre leurs deux versions...)
Relecture.
a+
--
Philippe Batailler
--- make-kpkg.1 2004-07-12 16:24:52.000000000 +0200
+++ make-relu 2004-07-12 18:37:31.000000000 +0200
@@ -34,10 +34,10 @@
.SH DESCRIPTION
Cette page de manuel décrit l'utilitaire Debian
.B "make\-kpkg",
-qui est utilisé pour créer les paquets Debian concernant le noyau. Cet
+utilisé pour créer les paquets Debian concernant le noyau. Cet
utilitaire doit être lancé à partir du répertoire racine des sources du
noyau Linux, qui doit avoir été préalablement configuré (à moins que vous
-n'utilisiez la cible 'configure'). Typiquement, vous exécutez cette commande
+n'utilisiez la cible « configure »). Typiquement, vous exécutez cette commande
en tant que root, avec
.B fakeroot,
ou bien en indiquant à
@@ -50,14 +50,13 @@
Le paquet Debian sera créé dans le répertoire père de celui des sources
du noyau depuis lequel la commande a été lancée.
.PP
-Enfin, sachez que certaines versions de gcc ne fonctionnent pas très bien
+De plus, sachez que certaines versions de gcc ne fonctionnent pas très bien
avec les sources du noyau (gcc 2.95 rencontre des problèmes de compilation
du noyau si on n'utilise pas l'option de compilation
.I '\-fno\-strict\-aliasing').
-Une attention particulière pour les noyaux récents (les séries 2.2 et 2.4)
-a guidé la réalisation de cette version du logiciel (Je crois que, pour les
-noyaux plus anciens, vous risquez d'avoir à modifier le makefile ou à
-intervenir ailleurs).
+Ce problème a été réglé pour les noyaux récents (les séries 2.2 et 2.4)
+(je crois que, pour les noyaux plus anciens, vous risquez d'avoir à modifier
+le makefile).
Vous pouvez indiquer la version de gcc à utiliser pour la compilation du
noyau en définissant les variables CC et HOSTCC du Makefile (le Makefile
du premier niveau). Cela se fait tout simplement grâce à :
@@ -71,49 +70,50 @@
Affiche un message d'aide.
.TP
.BR \-\-revision " numéro"
-Modifie le numéro de version Debian des paquets générés en
+Modifie le numéro de révision Debian pour les paquets créés avec ce
.BR numéro.
Il y a quelques contraintes d'utilisation : l'option \-\-revision n'a d'effets
que pendant la phase de configuration. En d'autres termes, si le fichier
.I stamp\-configure
existe, cette option n'aura pas d'effet. Exécutez
.B make\-kpkg clean
-ou effacez
+ou supprimez vous-même
.I stamp\-configure
et
.I stamp\-debian
-à la main afin que l'option fonctionne. Je vous recommande avec insistance
+afin que l'option fonctionne. Je vous recommande avec insistance
d'utiliser
.B make\-kpkg clean
sauf si vous êtes sûr de ce que vous faites.
De plus, les mainteneurs officiels des paquets des sources fournissent leurs
-propres numéros de versions et données pour leurs envois officiels dans
+propres numéros de version et leurs propres données pour leurs envois
+officiels dans
l'archive Debian,
-ce qui entraîne qu'un certain nombre de choses, dont le numéro de version
+ce qui entraîne qu'un certain nombre de choses, dont le numéro de révision
.B Debian
, ne seront pas modifiés par
.B make\-kpkg.
S'il vous arrive d'avoir une source officielle, (il y a alors un fichier
.I debian/official
-qui ne doit pas être vide), et que vous voulez utiliser votre propre numéro
-de version, pensez bien à effacer
+qui ne doit pas être vide), et que vous vouliez utiliser votre propre numéro
+de révision, pensez bien à supprimer
.I debian/official
avant de lancer
.B make\-kpkg clean
si vous voulez que cette option fasse effet.
Par conséquent, si vous voulez relancer
.B make\-kpkg
-avec un numéro de version différent, assurez vous de commencer avec une
+avec un numéro de révision différent, assurez-vous de commencer avec une
structure propre. Ensuite, le numéro de version doit être composé
uniquement de caractères alphanumériques, des caractères + et . (plus et
point),
et doit impérativement comporter un chiffre (Consultez la charte Debian pour
plus d'informations).
-.I En fait, ceci est un mensonge.
+.I En fait, c'est un mensonge.
Les mainteneurs officiels du noyau et des
modules ont une dispense spéciale qui leur permet l'usage du trait d'union,
-mais cela est fortement déconseillé pour la plupart des gens, puisqu'aucune
-correction du numéro de version n'est faite, et dpkg et autres risquent de
+mais cela est fortement déconseillé à la plupart des gens, puisqu'aucune
+correction du numéro de version n'est faite, et dpkg et consorts risquent de
planter en fin de compilation sans qu'on sache très bien d'où cela vient.
Enfin, vous pouvez préfixer la version d'un chiffre suivi de deux
points (:). La valeur par défaut est
@@ -168,7 +168,7 @@
des différents lancements). Si vous en avez assez de voir make\-kpkg se
plaindre de l'utilisation de
.BR \-\-append_to_version
-alors qu'il y a déjà un fichier crée précédemment
+alors qu'il y a déjà un fichier créé précédemment
.T version.h
, vous pouvez définir la variable d'environnement
.B VERSION_H_OK
@@ -249,11 +249,11 @@
explicitement la variable d'environnement. Mais puisque régler la variable
d'environnement
.B PATCH_THE_KERNEL
-à YES peut être dangereux (en ce sens ou tous les patches seraient installés
+à YES peut être dangereux (en ce sens où tous les patches seraient installés
quand vous n'en vouliez aucun, puisque vous n'avez pas spécifié l'option
added_patches), vous pouvez régler la variable PATCH_THE_KERNEL à
.I AUTO,
-En ce cas, PATCH_THE_KERNEL sera réglé à YES quand vous demanderez
+et dans ce cas, PATCH_THE_KERNEL sera réglé à YES quand vous demanderez
.BR \-\-added\-patches\ foo,
et pas dans le cas inverse.
De plus, notez que si un quelconque patch installe un script dans le répertoire
@@ -287,7 +287,7 @@
Certaines architectures (comme Alpha, ou m68k) ont besoin de noyaux différents
pour chacune des sous\-architectures. Cette option offre un moyen de le
spécifier en tant qu'argument de \fBmake\-kpkg\fR. \fBNotez bien\fR
-que la gestion supplémentaire des sous\-architectures doit être présente dans
+qu'une gestion de ces sous\-architectures doit être présente dans
les sources du noyaux afin que cette option serve à quelque chose. On peut
obtenir le même résultat en réglant la variable d'environnement
.B KPKG_SUBARCH
@@ -296,9 +296,9 @@
.TP
.BR \-\-arch_in_name
Cette option rallonge le nom du paquet de l'image du noyau
-en intégrant la sous\-architecture dans le nom de l'image afin qu'on puisse
-écrire des scripts pour créer de multiples sous\-architectures les unes
-après les autres. On peut faire la même chose en réglant la variable
+en intégrant la sous\-architecture dans le nom de l'image ; ainsi on peut
+écrire des scripts pour créer de multiples sous\-architectures, l'une après
+l'autre. On peut faire la même chose en réglant la variable
d'environnement
.B ARCH_IN_NAME.
\fBNotez bien\fR que seul le
@@ -307,7 +307,7 @@
.TP
.BR \-\-pgpsign " nom"
Définit la chaîne utilisée pour signer le fichier des modifications
-.B (changes file)
+.B (changes)
pour les modules externes rangés dans
.IR /usr/src/modules/
et qui utilisent PGP. Cette option prendra le pas sur le comportement par défaut
@@ -323,7 +323,7 @@
\f(CWold\fR, \f(CWmenu\fR, \f(CWg\fR, ou \f(CWx\fR.
.Sp
Cette option est particulièrement utile lors de l'utilisation de
-\s-1PATCH_THE_KERNEL\s0 lorsque certains des patches modifient les options de
+\s-1PATCH_THE_KERNEL\s0 lorsque certains patches modifient les options de
configuration offertes.
.B Notez
cependant que
@@ -354,10 +354,10 @@
.I kernel\-image
, génère toutes les actions nécessaires lors du chargement d'un noyau utilisant
.B initrd.
-.B NOTE:
+.B NOTE :
Nécessite un patch non standard des sources du noyau pour initrd et cramfs,
(à moins que la configuration de mkinitrd n'ait été modifiée afin de ne pas
-utiliser cramfs) sans lequel vous risquez d'obtenir un noyau non amorçable.
+utiliser cramfs), sans lequel vous risquez d'obtenir un noyau non amorçable.
Ce patch est généralement présent dans les sources du noyau fournies par
Debian, mais pas dans les sources originales du noyau. Cette option peut
entraîner des dépendances additionnelles, et des modifications des scripts
@@ -383,8 +383,7 @@
.TP
.B \-\-bzimage
Génère un noyau en bzImage. C'est utile pour ceux qui veulent un noyau bzImage
-sur les configurations dans lesquelles le réglage par défaut est zImage pour
-les noyaux.
+sur les systèmes où le réglage par défaut est zImage.
.TP
.B \-\-mkimage commande
Ce doit être une commande qui produit une image initrd à partir d'un répertoire.
@@ -399,7 +398,7 @@
.TP
.B \-\-rootcmd commande
La commande qui offre la possibilité d'obtenir l'accès super\-utilisateur (Par
-exemple, 'sudo' ou 'fakeroot') telle quelle est nécessaire pour l'option \-r de
+exemple, 'sudo' ou 'fakeroot'). Cet accès est nécessaire pour l'option \-r de
dpkg\-buildpackage.
.TP
.B \-\-us
@@ -411,11 +410,11 @@
le changelog. Elle n'a de sens que pour la cible buildpackage.
.PP
Les options peuvent être raccourcies en la plus petite chaîne de caractères
-non équivoque et peuvent être invoquées sans distinction avec les préfixes \-
-ou \-\-, et avoir
-un espace ou un symbole = entre une option et sa valeur. Vous pouvez aussi
+non équivoque et peuvent être invoquées indifféremment avec les préfixes \-
+ou \-\- ; vous pouvez mettre un espace ou un symbole = entre une option et sa
+valeur. Vous pouvez aussi
utiliser la forme option=valeur ; Pour plus d'informations sur ces variantes et
-d'autres qui sont supportées, consultez la page de manuel Getopt::Long (3perl).
+d'autres qui sont reconnues, consultez la page de manuel Getopt::Long (3perl).
.TP
.B CONCURRENCY_LEVEL
Si elle est définie, cette variable règle le nombre de processus concurrents
@@ -464,11 +463,10 @@
Cette cible génère un paquet Debian des sources du noyau Linux.
Si la variable d'environnement
.B SOURCE_CLEAN_HOOK
-pointe sur un exécutable, alors cet exécutable sera lancé sur le répertoire
-racine temporaire des sources de votre noyau juste avant de l'empaqueter,
+pointe sur un exécutable, alors cet exécutable sera lancé, juste avant de
+faire le paquet, sur le répertoire racine temporaire des sources du noyau,
.I ./debian/tmp\-source/usr/src/kernel\-source\-X.X.XX,
-de façon à ce qu'on puisse lancer n'importe quelle commande qui semble
-appropriée (supprimer des arborescences liées à des architectures, ôter les
+de façon à ce qu'on puisse lancer toute commande appropriée (supprimer des arborescences liées à des architectures, ôter les
répertoires de contrôle de version,
.I find . \-type d \-name CVS \-prune \-exec rm \-rf {} \\;
etc.). Cela ne concerne que les sources du noyau qui sont en cours d'empaquetage.
@@ -479,10 +477,10 @@
et
.B DOC_CLEAN_HOOK
sont semblables. Elles doivent pointer sur des exécutables, ces exécutables
-seront appliqués sur la racine temporaire des entêtes du noyau et de la
+seront appliqués sur la racine temporaire des en-têtes du noyau et de la
documentation juste avant la génération des paquets respectifs, de façon à
ce que vous puissiez lancer toute action qui vous semble adéquate. De même, ne
-sont touchés que les sources qui sont en cours d'empaquetage.
+sont touchées que les sources qui sont en cours d'empaquetage.
.TP
.B kernel_headers
Cette cible génère le paquet Debian contenant les fichiers d'en-têtes
@@ -493,7 +491,7 @@
dans le noyau Linux.
.TP
.B kernel_image
-Cette cible génère un paquet Debian contenant un noyau Linux, et tous modules
+Cette cible génère un paquet Debian contenant un noyau Linux, et tous les modules
définis dans le fichier de configuration du noyau
.I .config.
Si il n'y a pas de fichier
@@ -512,7 +510,7 @@
.B run\-parts
sera lancé sur ce répertoire juste avant la création du paquet de l'image du
noyau. L'emplacement de la racine de l'image pour le paquet en cours de
-construction peut être définie par la variable d'environnement
+construction peut être défini par la variable d'environnement
.B IMAGE_TOP,
et la version du noyau est définie grâce à la variable d'environnement
.B version
@@ -535,7 +533,7 @@
.I loadlin, SILO, QUIK, VMELILO, ZIPL, yaboot, PALO
ou
.I GRUB
-), en créant un fichier de configuration pour ces chargeurs de démarrage, si
+), en créant un fichier de configuration pour ces programmes de démarrage, si
nécessaire. A ce moment, vous aurez aussi la possibilité de mettre ce nouveau
noyau sur une disquette, en formatant la disquette si nécessaire.
En cas de suppression, le paquet vérifie la version du noyau en cours
@@ -546,9 +544,9 @@
automatisée du contenu du menu est suffisante pour l'installation ou la
suppression d'une image d'un noyau.
.IP
-Consultez la documentation à propos des 'hooks' dans
+Consultez la documentation à propos des variables de type « hook » dans
.B kernel\-img.conf(5).
-Ces 'hooks' sont des variables qui peuvent pointer sur des scripts qui
+Ces variables peuvent indiquer des scripts qui
ajoutent ou suppriment une ligne dans le menu du grub à l'installation ou à la
suppression de l'image du noyau. Un exemple de script pour ajouter des lignes
au menu du grub est fourni dans le répertoire
@@ -561,27 +559,27 @@
.TP
.B modules
Cette cible vous permet de générer tous les modules et paquets additionnels qui
-dépendent fortement du noyau pour lequel ils ont été compilés, en même temps
+dépendent fortement de la version du noyau pour laquelle ils ont été compilés, en même temps
que vous construisez votre image du noyau. Cette cible s'attend à trouver les
-modules et paquets sous /usr/src/modules, et, pour chacun de ces répertoire,
+modules et paquets sous /usr/src/modules, et, pour chacun de ces répertoires,
s'y déplacera et lancera la règle
.B kdist
trouvée dans le fichier
.I debian.rules
présent. Cette cible créera le(s) paquet(s)
.B Debian
-de(s) module(s), ainsi qu'un fichier tar comprimé et un fichier diff comprimé,
+de(s) module(s), ainsi qu'un fichier tar compressé et un fichier diff compressé,
les
.I md5sums
-correspondant, générés par
+correspondants, générés par
.B dpkg\-genchanges,
-seront enregistrés dans un fichier des modifications (un 'changes file').
-Ce fichier sera signé par la même identité que celle utilisée pour signer le
-paquet du noyau. Cette option est utilisée par les mainteneurs qui déploient
+seront enregistrés dans un fichier des modifications (changes).
+Ce fichier sera signé avec la même identité que celle utilisée pour signer le
+paquet du noyau. Cette option est utilisée par les mainteneurs qui envoient
les paquets dans les archives de Debian.
.TP
.B modules_config
-Cette cible vous permet de configurer tous les paquets de
+Cette cible permet de configurer tous les paquets de
.B /usr/src/modules.
A utiliser si vous avez besoin de modifier manuellement certains points de
la configuration, ou si vous voulez compiler manuellement tous les modules
@@ -591,7 +589,7 @@
Cette cible vous permet de construire tous les paquets de
.B /usr/src/modules,
mais elle ne crée pas les fichiers sources ou diffs, ni ne crée ni ne signe un
-fichier des modifications (un 'changes file'). C'est la seule option liée aux
+fichier des modifications (un fichier « changes »). C'est la seule option liée aux
modules dont vous aurez besoin si vous voulez juste compiler les modules
additionnels pour leur installation sur une ou plusieurs machines.
Utilisée en général en conjonction avec
@@ -622,16 +620,16 @@
.B debian
Cette cible crée le répertoire
.I ./debian,
-et patch éventuellement le source. Cette cible est appelée par la cible
+et patche éventuellement le source. Cette cible est appelée par la cible
.B configure.
Vous utiliserez cette cible pour patcher les sources, puis vous lancerez
l'étape de configuration manuellement.
.TP
.B libc\-kheaders
C'est une cible spéciale pour les mainteneurs de libc\-dev, qui peuvent
-s'en servir pour créer les paquets entêtes dont la libc a besoin. Notez
+s'en servir pour créer les paquets d'en-têtes dont la libc a besoin. Notez
qu'il est dangereux de créer un paquet de libc\-kheaders qui est différent
-des entêtes avec laquelle la libc a été compilés. C'est une cause
+des en-têtes avec lesquels la libc a été compilée. C'est une cause
.B connue
d'arrêts brutaux du système. Consultez
.I /usr/share/kernel\-package/README.headers
@@ -671,15 +669,15 @@
.I /etc/kernel\-pkg.conf
(ou
.I ~/.kernel\-pkg.conf.
-) sont en fait des bribes de Makefile, et n'importe quelle directive valide
+) sont en fait des bribes de Makefile, et toute directive valide
peut y être incluse.
-.B Note:
-La prudence est de mise sur ce fichier, puisque vous pouvez modifier
-complètement le comportement du make en éditant convenablement son
+.B Note :
+La prudence est de mise avec ce fichier, puisque vous pouvez changer
+complètement le comportement du make en modifiant son
contenu. Consultez le fichier
.I /usr/share/doc/kernel\-package/Problems.gz
pour connaître la liste des problèmes recensés lors de la compilation des
-images du noyau. Un tutoriel exhaustif et de la documentation sont aussi
+images du noyau. Un tutoriel exhaustif et une documentation sont aussi
disponibles dans
.I /usr/share/doc/kernel\-package/README.gz
et leurs lectures sont recommandées avant l'utilisation de cet utilitaire.
Reply to: