# Le manuel de Kpackage

Toivo
PEDASTE

    toivo@ucs.uwa.edu.au

Version 1.1 - 14 décembre 1998

Ce manuel décrit la version 1.1 de Kpackage.

kpackage
package
manage

## Introduction

Kpackage est une interface graphique aux gestionnaires de paquetages RPM, Debian, Slackware et BSD. Il est similaire à GLINT dans bien des points. Kpackage fait partie du projet de bureau KDE. Il est par conséquent conçu pour s'intégrer au gestionnaire de fichiers de KDE.

### Nouveautés

- Kpackage-1.3.8

  - Correction de la mauvaise identification des paquetages tels les paquetages KISS.

- Kpackage-1.3.7

  - Support complet des paquetages KISS.

  - Modifications pour le coréen dans kpackage.spec - KIM KyungHeon "tody@tody.sarang.net".

  - Plus de traductions en roumain et correction i18n - Claudiu Costin "claudiuc@calderon.pcnet.ro".

- Kpackage-1.3.6

  - Traductions pour le roumain - Claudiu Costin "claudiuc@calderon.pcnet.ro".

- Kpackage-1.3.5

  - Compilation avec RPM 3.0, 3.0.1, et la dernière version 3.0.2.

- Kpackage-1.3.4

  - Compilation avec RPM 3.0.2.

- kpackage-1.3.3

  - Traductions pour le polonais.

  - Avertissement quant à la nécessité du paquetage popt.

- Kpackage-1.3.2

  - Correction de la balise de mise à jour avec RPM.

  - Correction du message d'erreur « Nécessite root » avec RPM.

  - Correction de l'installation du fichier index-4.html.

- Kpackage-1.3.1

  - Nouvelle tentative de trouver un identifiant pour RPM 3.0.

- Kpackage-1.3

  - Support des paquetages FreeBSD - Alex Hayward "xelah@ferret.lmh.ox.ac.uk".

  - Fonctionne avec QT2 et la dernière version du CVS de KDE.

  - Fonctionne avec RPM 3.0.

  - Fonctionne avec la glibc 2.1.

  - Corrections pour RPM 3.0 - "prigaux@mandrakesoft.com".

  - Correction des messages d'erreurs lors de la vérification de RPM.

  - Correction du changement de paquetage lorsqu'un fichier est sélectionné.

- Kpackage-1.2.1

  - Corrige le problème de vérification des dépendances lors de la désinstallation de paquetages RPM.

- Kpackage-1.2

  - Utilisation de la classe KAccelMenu pour simplifier la configuration des raccourcis clavier et autoriser la définition des raccourcis clavier en utilisant une touche lorsque le menu est sélectionné. Le caractère ' est nécessaire pour pouvoir utiliser ces touches (KDE postérieur à 1.1).

  - Ajout d'une boîte de dialogue Touches comme autre moyen pour définir les raccourciss claviers.

  - Ajout du support des paquetages KISS (KDE postérieur à 1.1).

  - Ajout du support des paquetages SLACKWARE.

  - Déplacement des fonctions communes aux types de paquetages dans la classe base.

  - Remplace QString mid par ce qui est approprié.

  - Définit le filtre sur KFileDialog proprement.

  - Nettoyage de la classe procbuf.

- Kpackage-1.1.3

  - Utilisation de fonds transparents pour les icônes (police cooper).

  - Mise à jour de la traduction russe - Serguei Koubouchine `<ksi@ksi-linux.com>`.

  - Traduction pour le danois - Steen Rabol `<rabol@get2net.dk>.`

  - Mise à jour de la compilation - Stefan Siegel `<siegel@informatik.uni-kl.de>`.

- Kpackage-1.1.2

  - Corrige le problème des fichiers dupliqués.

  - Correction de la documentation anglaise.

- Kpackage-1.1.1

  - Affiche la taille des fichiers dans l'arborescence si on n'a pas la taille installée.

  - Mise à jour de la configuration pour se référer à QT 1.4.

  - Manipulation des numéros de série RPM, numéro DEB.

  - Corrige l'affichage de la barre d'outils.

  - Traduction pour le hongrois.

- Kpackage-1.1.01

  - Tentative de correction du problème de compilation avec l'ancien gcc.

- Kpackage-1.1

  - Nécessite QT 1.4.

  - Utilise QTreeView : plus rapide, autorise les colonnes, affiche les informations sur la version.

  - Ajout du mode Sélections multiples permettant d'installer/désinstaller plusieurs paquetages en même temps.

  - Accélère l'insertion dans la liste en ne faisant pas "insort".

  - Accélère la sortie en ne supprimant pas les objets.

  - Entrées dans les menus pour développer/refermer l'arborescence.

  - Entrée dans les menu pour désélectionner.

  - Suppression de quitter dans la barre d'outils.

  - Correction pour rpmlib 2.5, utilisation de `rpmlib.h`.

  - Correction de la spécification d'un fichier dans le panneau pour la lecture des répertoires.

  - Correction du nettoyage du répertoire de cache lorsque les répertoires ont changé.

  - Correction de la comparaison des versions de paquetages.

- Kpackage-1.0

  - Manipulation des paquetages désinstallés de la même façon que les paquetages installés.

  - Cache les paquetages non-locaux dans `.kpackage`.

  - Cache les paquetages sous leur nom dans le répertoire .kpackage.

  - Boîte de dialogue pour les options du répertoire de cache.

  - Boîte de dialogue pour les options du cache de paquetage.

  - Boîte de dialogue pour les options d'affichage des paquetages.

  - Options sous forme d'onglets.

  - Séparateur modifiable dans la fenêtre principale.

  - Tri les paquetages selon la liste des propriétés.

  - Traduction pour le russe.

  - Correction de la terminaison de la chaîne dans KpMsg.

  - Correction du message d'erreur lorsqu'un paquetage n'a pas été trouvé.

  - Correction de l'appel à KFM lorsqu'un fichier n'a pas été trouvé.

  - Correction de l'ouverture d'un fichier local avec le sélecteur de fichiers.

  - Correction de l'affichage des propriétés des paquetages lorsque la barre de défilement disparaît.

  - Correction des URLs non fichier depuis la boîte de dialogue d'ouverture des fichiers.

  - Correction du problème de liaison à la zlib (peut-être).

- Kpackage-0.9.02

  - Ajout de la traduction pour le français.

  - Correction de l'erreur de segmentation avec Options...

  - Correction de « Vérification des dépendances » lorsque RPM désinstalle.

  - Change les icônes dans l'affichage de l'arborescence.

- Kpackage-0.9.01

  - Ajout de la traduction espagnole.

  - Correction de la compilation sans RPM.

- Kpackage-0.9

  - Ajout de la recherche de paquetages contenant un fichier (boîte de dialogue avec DND).

  - Utilisation du sélecteur de fichiers kfile.

  - Création de la liste des fichiers seulement lorsqu'on y accède.

  - Ne pas recharger l'arborescence des paquetages après ajout ou suppression.

  - Ajout de la barre d'outils.

  - Ajout du menu options (option pour supprimer la vérification des fichiers).

  - Mise à jour d'automake, autoconf, make.

  - Correction de quelques fd et fuites de mémoire.

  - Correction des mini icônes.

  - Enregistre plus de choses lors de la sortie.

  - Correction de la couleur du panneau de description.

  - Ajout de plus d'internationalisation.

  - Ajout de plus de choses à traduire.

- Kpackage 0.8

  - Affiche les problèmes de dépendances RPM dans l'interface graphique.

  - Affiche partiellement les paquetages Debian installés.

  - Mise à jour des icônes.

  - Ne pas reconstruire l'arborescence des paquetages lorsque cela n'est pas nécessaire.

  - Correction d'autres manques dans la description de paquetages RPM.

  - Tente de déposer les fichiers dans le répertoire de l'utilisateur (/tmp a des problèmes de sécurité).

  - Ajout de l'internationalisation.

    - Portugais: Pedro Morais `<pmmm@camoes.rnl.ist.utl.pt>`

    - Slovaque: Juraj Bednar `<bednar@isternet.sk>`

  - Autorisation de déposer plusieurs fichiers.

  - Ajout du dossier pixmap pour les groupes de paquetages.

  - Correction de la recherche afin de ne pas perdre les tailles des paquetages.

  - Modification des documentations afin qu'elles aient l'aspect KDE.

- kpackage-0.7

  - Restructurations internes afin d'implémenter la manipulation Debian et RPM en tant que sous classes et autoriser l'ajout de nouveaux types.

  - Compilation sans le support de RPM si les bibliothèques ne sont pas disponibles.

  - Ajout de la fonction de recherche afin de rechercher les paquetages installés.

  - Utilisation de l'élément graphique ktreeview.

  - Les erreurs RPM sont redirigées dans une boîte de dialogue plutôt que sur STDERR.

  - Utilisation de couleurs différentes pour les arborescence DEB et RPM.

  - Correction pour fonctionner avec le nouveau kprocess.

  - Correction de fd leak.

  - Correction de certaines fuites de mémoire.

- Kpackage-0.6.2

  - Correction de l'installation des paquetages .DEB contenant un grand nombre de fichiers.

  - Manipulation des bibliothèques plus intelligente.

- Kpackage-0.6

  - Fixation de l'utilisation de pixmaps, ajout de la vérification des fichiers pour Debian.

  - Ajout de l'entrée Récemments ouverts dans le menu Fichier.

  - La sélection d'un fichier dans la liste l'ouvre.

  - Plus de vitesse sur les longues listes.

  - Correction de la manipulation d'URLs n'étant pas des fichiers.

  - Correction du plantage lorsqu'aucun paquetage Debian n'est installé.

  - Reconnaissance de l'ancien format Debian.

- Kpackage-0.5

  - Ajout du support des paquetages DEB.

  - Correction du problème de perte de texte dans les descriptions.

  - Mise à jour de la manipulation de sessions.

  - Utilisation de KFM pour les E/S réseau.

  - Ajout de l'entrée Ouvrir dans le menu.

Toivo Pedaste

toivo@ucs.uwa.edu.au

## Installation

### Où obtenir Kpackage ?

Kpackage peut être trouvé ici : ftp://ftp.uwa.edu.au/pub/k. Une page Web est disponible ici : http://www.general.uwa.edu.au/u/toivo/kpackage. Kpackage peut également être trouvé sur le site FTP principal de projet KDE : ftp://ftp.kde.org/pub/kde/.

### Pré-requis

Pour installer kpackage vous avez besoin de :

- Qt 1.4 et les bibliothèques KDE 1.1.

- ou

- Qt 2.0 et KDE 2 CVS.

Pour lister des paquetages Debian, vous n'avez pas besoin d'autre logiciel. Pour installer et désintaller ce type de paquetages, vous avez besoin :

- du gestionnaire de paquetages DPKG.

Pour que Kpackage fonctionne correctement avec les paquetages RPM, la base de données RPM doit être initialisée. Si vous obtenez un message d'erreur du type «Impossible d'ouvrir...», essayez d'exécuter la commande suivante `rpm --rebuilddb`.

Pour les paquetages BSD, vous avez besoin des programmes de gestion des paquetages :

- pkg_info

- pkg_add

- pkg_delete

Pour les paquetages Slackware, vous avez besoin de :

- installpkg

- removepkg

Pour les paquetages KISS, vous avez besoin de :

- kiss

Pour manipuler les paquetages RPM, vous avez besoin de :

- RPM et RPM-DEVEL : 2.3, 2.4 ou 3.0.

- des mêmes bibliothèques que RPM :

  - libdb - la bibliothèque de base de données de Berkeley.

  - libz et libz-dev - les bibliothèques de compression.

  - Les dernières versions de RPM nécessitent la routine gettext qui peut être trouvée dans la libc6 ou dans libintl.

  - RPM 3.0 peut nécessiter le paquetage popt.

### Compilation et installation

Pour compiler et installer Kpackage sur votre système, entrez les commandes suivantes dans le répertoire de base de la distribution de kpackage :

    	% ./configure
    	% make
    	% make install

Il peut être nécessaire de définir les variables `QTDIR` et `KDEDIR` pour indiquer où ces logiciels sont installés. Kpackage utilisant autoconf, vous ne devriez pas avoir de gros problèmes pour le compiler.

## Utilisation de l'interface

Kpackage est divisé en deux panneaux. Le panneau de gauche affiche une arborescence des paquetages installés. Le panneau de droite affiche les informations sur les paquetages installés.

### Glisser et Déposer

Kpackage sait utiliser le protocole de glisser/déposer de KDE. Cela signifie que vous pouvez glisser puis déposer des paquetages sur Kpackage pour les ouvrir. Si vous déposez un fichier sur la boîte de dialogue «Trouver un fichier» Kpackage pourra trouver le paquetage contenant ce fichier.

### Gérer les paquetages avec l'arborescence

Lorsque que Kpackage démarre normalement (i.e. qu'il n'est pas invoqué lors d'un glisser/déposer et qu'aucun paramètre ne lui a été passé), il affiche deux panneaux. Celui de gauche représente l'arborescence des paquetages installés. Optionellement, les paquetages non installés et mis à jour peuvent être également affichés.

L'arborescence des paquetages affiche les nom, taille du paquetage, version (dans le cas de paquetages non installés qui mettront à jour un paquetage installé) du paquetage déjà installé.

- Sélectionner un paquetage dans l'arborescence déclenchera l'affichage des informations le concernant dans le panneau de droite et vous autorisera à :

  - Afficher les informations sur le statut du paquetage.

  - Visualisez quels sont les fichiers qu'il contient. Si vous sélectionnez un fichier dans la liste, il sera ouvert en utilisant le gestionnaire de fichiers.

  - Vérifiez les fichiers présents dans le paquetage. Les fichiers effectivement présents seront indiqués par un signe vert tandis que les fichiers absents seront marqués par une croix rouge.

  - Désinstaller un paquetage installé.

  - Installer un paquetage non installé.

- L'arborescence des paquetages permet d'agir de deux façons :

  - En mode sélection simple, la sélection d'un paquetage désélectionne celui précédemment sélectionné

  - En mode sélection multiple, plusieurs paquetages peuvent être sélectionnés en même temps. Vous pourrez les installer ou les désinstaller en groupe.

### Ajouter des paquetages non installés à l'arborescence.

Kpackage peut gérer des paquetages RPM et Debian.

Pour les paquetages RPM, Kpackage peut examiner un répertoire contenant les paquetages et les ajouter à l'arborescence de paquetages en tant que paquetages nouveaux ou mis à jour. Il est possible d'examiner ou d'installer ces paquetages depuis l'arborescence. Par défaut les informations sur les paquetages sont extraites du format standard des noms de fichiers, aussi est-il nécessaire d'utiliser le bouton "Examiner" pour voir la description complète. Il est possibler de définir une option pour que dans les répertoires locaux chaque paquetage soit lu. C'est plus lent mais cela donne une description complète.

Les répertoires de paquetages Debian peuvent être examinés de la même façon que les paquetages RPM. Il est également possible d'utiliser le répertoire Paquetages des distributions Debian. L'emplacement de la distribution Debian est spécifiée en même temps que les paquetages. L'intérêt réside dans le fait que ces paquetages sont alors ajoutés à l'arborescence et peuvent être examinés ou installés. Si le programme « dselect » est utilisé alors le fichier /var/lib/dpkg/available peut être utilisé en tant que descripteur des paquetages.

Pour les paquetages Slackware, quelques informations sont stockées dans les paquetages installés mais il est possible d'utiliser un fichier PACKAGES.TXT comme source d'informations sur les paquetages installés. Le fichier PACKAGES.TXT est équivalent à un paquetage Debian. Les distributions Slackware sont organisées en une arborescence contenant les paquetages `.tgz` et un fichier PACKAGES.TXT les décrit. Comme pour les paquetages Debian, les paquetages Slackware peuvent être intégrés à l'arborescence des paquetages. Malheureusement, les paquetages Slackware ne contiennent pas d'informations sur les versions. Il est donc impossible de savoir si les paquetages installés sont plus anciens ou plus récents que les paquetages non installés.

Pour les paquetages BSD, Kpackage sait manipuler les répertoires contenant un fichier INDEX (décrivant tous les paquetages) et les répertoires contenant tous les paquetages.

Pour les paquetages KISS (dont le nom se termine par .installer), Kpackage peut examiner un répertoire contenant les paquetages et les ajouter à l'arborescence des paquetages.

Pour les paquetages et répertoires distants (i.e. ceux accessibles par FTP), Kpackage créera un cache. Les paquetages seront cachés dans `~/.kpackage` tandis que les répertoires seront cachés dans `~/.kpackage/dir`

NOTE : pour pouvoir manipuler des répertoires distants (FTP), KFM ne doit pas avoir été paramétré pour utiliser un serveur mandataire FTP.

### Installer des paquetages

Pour installer des paquetages vous pouvez

- repérer le paquetage que vous souhaitez installer à l'aide de KFM puis en déposer une copie sur Kpackage.

- Cliquer sur un paquetage dans KFM et ouvrir une nouvelle fenêtre de Kpackage.

- utiliser le menu Ouvrir de Kpackage.

- Sélectionner un paquetage non installé dans l'arborescence des paquetages.

En mode Sélection simple, le bouton Examiner ouvre le paquetage (en le téléchargeant de l'hôte distant si nécessaire) et affiche les options d'installation dans le panneau de gauche et les informations sur le paquetage dans le panneau de droite.

En mode Sélection multiple le bouton Installer ouvre une boîte de dialogue contenant les options d'installation. Si vous choisissez d'installer les paquetages à l'aide de cette boîte de dialogue, les paquetages distants seront téléchargés et tous les paquetages sélectionnés seront installés.

Les paquetages RPM sont traités de façon significavement différentes des autres formats de paquetages. Les paquetages RPM sont installés par Kpackage alors qu'il est nécessaire de recourir à un programme externe pour les paquetages Debian, Slackware, BSD et KISS. Pour les paquetages Debian, le programme DPKG est appelé dans une fenêtre KVT (cela permet l'intéractivité quand elle est nécessaire).

### Désinstaller des paquetages

Les paquetages peuvent être désinstallés en les sélectionnant dans l'arborescence des paquetages puis en cliquant sur le bouton «Désinstaller». Cela fera apparaître une fenêtre comportant les options de désinstallation. Cliquer sur le bouton « Désinstallation » dans la boîte de dialogue provoquera la désinstallation des paquetages.

## Menus

Ce chapitre décrit les menus de Kpackage.

Il est possible d'utiliser des raccourcis clavier en sélectionnant l'entrée d'un menu puis en appuyant sur la touche ' suivie de la clef trouvée dans le menu (pour les versions de KDE postérieures à 1.1).

### Menu Fichier

Les entrées du menu Fichier sont :

Ouvrir

  Ouvre le sélecteur pour les fichiers locaux et ftp.

Ouvrir l'URL

  Vous permet d'ouvrir l'URL pour tout fichier local, ftp ou http.

Récemment ouvert

  Une liste des paquetages récemment ouverts.

Chercher un paquetage

  Recherche dans la liste des paquetages celui correspondant à la chaîne indiquée.

Chercher un fichier

  Fournit la liste des paquetages contenant le fichier indiqué. Sélectionner une ligne affichera les informations sur les paquetages. Cela fonctionne différemment suivant le format de paquetage. Pour les paquetages RPM, vous devez indiquer le nom exact. Pour les paquetages DEB, les expressions régulières peuvent être utilisées.

Recharger

  Relit les données sur les paquetages et reconstruit l'arborescence des paquetages.

Quitter

  Quitte

### Menu Paquetages

Les entrées disponibles dans le menu Paquetages sont :

Développer l'arborescence

  Développe complètement l'arborescence des paquetages.

Refermer l'arborescence

  Referme l'arborescence des paquetages de telle sorte que seule sa structure soit visible.

Déselectionner

  Désélectionne les paquetages sélectionnés.

Mode sélection multiple

  Permet de basculer en mode Sélection simple. Dans ce dernier, vous ne pouvez sélectionner qu'un paquetage à la fois. En mode sélection multiple, vous pouvez en sélectionner autant que vous le désirez.

### Menu Options

Les entrées du menu options sont :

Options

  Affichage des paquetages

    Permet de paramétrer la façon dont les paquetages sont affichés dans l'arborescence. Vous avez le choix entre tous les paquetages, les paquetages installés et ceux mis à jour ou venant d'être installés.

  Répertoire de cache

    Comment utiliser le cahe des répertoires distants (FTP).

  Cache des paquetages

    Comment utiliser le cache des paquetages distants.

  Divers

    Vérification de la liste des fichiers

      Si cette option est sélectionnée, la liste des fichiers présents dans le paquetage est examinée afin de savoir s'ils sont déjà installés.

    Lecture des informations de tous les fichiers de paquetages locaux

      Si cette option est sélectionnée, tous les fichiers d'un répertoire (local) de paquetages seront lus plutôt que de se contenter d'utiliser les noms de fichiers. Cela est plus lent mais permet d'afficher plus d'informations.

Touches

  La boîte de dialogue standard de KDE permettant de paramétrer les raccourcis clavier (nécessite KDE postérieur à 1.1).

Emplacement des paquetages non installés

  Paquetages RPM

    Cela vous permet d'indiquer l'emplacement des répertoires de stockage de paquetages (locaux ou FTP). Chaque ligne comprend un champ dans lequel l'URL ou le nom du sous répertoire peut être indiqué. Le bouton « ... » ouvre un sélecteur de fichiers. Le bouton radio «Utiliser» permet de préciser si l'adresse doit être utilisée ou non. Les onglets ne sont là que pour simplifier l'interface.

  Paquetages KISS

    Les deux onglets permettent d'indiquer des répertoires contenant des paquetages KISS.

  Paquetages BSD

    Le premier onglet vous permet d'indiquer où se touve l'arborescence ports dans le système de fichiers.

    Le deuxième onglet vous permet d'indiquer quels sont les répertoires contenant les fichiers INDEX.

  Paquetages DEB

    Les deux premiers onglets fonctionnent de la même manière que ceux des paquetages RPM. Les autres vous permettent d'indiquer où se trouvent les répertoires de base de la distribution Debian et où se trouvent les paquetages dans cette distribution.

  Paquetages SLACK

    Pour les paquetages Slackware, il existe trois modèles d'onglets.

    - Le premier onglet permet d'indiquer où se trouve le fichier PACKAGES.TXT. Ce dernier est utilisé pour afficher les informations sur les paquetages installés.

    - Les quatre onglets suivants servent à indiquer où trouver l'arborescence contenant les fichiers tar.gz et le fichier PACKAGES.TXT correspondant.

    - Les deux derniers onglets servent à indiquer quels sont les répertoires qui ne contiennent pas de fichier PACKAGES.TXT.

  Cacher la barre d'outils

    Affiche/Cache la barre d'outils.

  Enregistrer les options

    Enregistre les options maintenant plutôt que de laisser Kpackage le faire au moment où vous quitterez.

### Menu Cache

Les entrées du menu Cache sont :

Effacer le cache du répertoire de paquetages

  Supprime les copies des paquetages et répertoires distants.

Effacer le cache des paquetages

  Supprime les copies des paquetages distants ayant été téléchargées.

### Barre d'outils

- Ouvrir

- Développer l'arborescence des paquetages

- Refermer l'arborescence des paquetages

- Chercher un paquetage

- Chercher un fichier

- Recharger

- Quitter