# Manuel de &kpackage;

## Introduction

&kpackage; est une interface graphique aux gestionnaires de paquetages RPM, Debian, Slackware et BSD. Il est semblable en partie à GLINT. &kpackage; fait partie de l'environnement de bureau K et, par conséquent, est conçu pour s'intégrer au gestionnaire de fichiers de &kde;.

## Généralités sur la fenêtre principale

&kpackage; est constitué de deux zones. La zone de gauche affiche une arborescence des paquetages installés et disponibles, la zone de droite affiche des informations sur les paquetages.

### Glisser - déposer

&kpackage; utilise le protocole de glisser-déposer de &kde;. Cela veut dire que vous pouvez tirer des paquetages vers &kpackage; pour les ouvrir. En relâchant un fichier sur la bioîte de dialogue Rechercher un fichier, vous lancerez une recherche du paquetage qui contient ce fichier.

### La zone d'affichage arborescente des paquetages

Quand &kpackage; démarre normalement (c'est-à-dire qu'il n'a pas été appelé par glisser-déposer et n'a pas reçu de paramètre), il affiche deux zones, avec l'arborescence des paquetages à gauche. Cette arborescence montre les paquetages installés et en option les paquetages nouveaux et mis à jour en plus.

Les onglets en haut de la zone sélectionnent si l'affichage doit comporter les paquetages installés, mis à jour, disponibles ou tous les paquetages

L'arborescence des paquetages affiche le nom du paquetage, la taille du paquetage, et (dans le cas d'un paquetage disponible qui mettrait à jour un paquetage installé) la version du paquetage déjà installé.

La sélection d'un paquetage dans l'arborescence affiche les informations le concernant dans le panneau de droite et permet :

- l'affichage des informations d'état sur le fichier

- la visualisation des fichiers inclus dans un paquetage installé, la sélection d'un fichier dans la liste l'ouvrant en utilisant le gestionnaire de fichiers

- la vérification des fichiers dans un paquetage, les fichiers qui existent sont marqués d'une coche, les autres d'une croix

- la désinstallation d'un paquetage installé

- l'installation d'un paquetage disponible.

Un simple paquetage est sélectionné en cliquant sur le nom. Un clic sur le point dans la colonne Sélectionné marque le paquetage avec une puce, un second clic le démarque, alors que &Maj;bouton gauche peut servir à sélectionner une plage de fichiers.

### Intégration des paquetages disponibles dans l'arborescence

L'accès aux paquetages disponibles est configuré par les entrées du menu Configurer kpackage pour chaque type de paquetage sous le menu Configuration.

Pour les paquetages RPM, &kpackage; peut lire un dossier contenant des paquetages et les ajouter à l'arborescence comme paquetages nouveaux ou mis à jour. Il est possible d'examiner ou d'installer ces paquetages depuis l'arborescence. Par défaut, les informations sur ces paquetages sont extraites dans le format standard des noms de fichiers et ainsi il est nécessaire d'utiliser le bouton Examiner pour voir sa description complète, bien qu'il soit possible de positionner une option de telle manière que pour les dossiers locaux, chaque fichier de paquetage soit lu, ce qui est plus lent, mais donne une description complète.

Pour les paquetages Debian qui sont gérés par `dpkg`, il y a trois manières d'accéder aux paquetages disponibles, qui peuvent être sélectionnées dans trois types différents de panneaux de configuration d'emplacement.

- Spécifier l'emplacement de l'arborescence des paquetages Debian et sélectionner la distribution et l'architecture. &kpackage; cherchera dans les emplacements standards les fichiers de paquetages qui décrivent les paquetages disponibles, ces paquetages sont ajoutés à l'arborescence et peuvent être examinés ou installés

- Spécifier l'emplacement de la distribution Debian avec les fichiers de paquetages pour les parties de la distribution qui ont un intérêt. Si le programme `dselect` est utilisé, le fichier `/var/lib/dpkg/available` peut être alors utilisé comme un fichier de paquetages qui décrit la distribution que `dselect` utilise.

- Les dossiers de paquetages peuvent être gérés de la même manière que les paquetages RPM.

Pour les paquetages Debian qui sont gérés par APT, l'emplacement du référentiel des paquetages désinstallés se règle dans le fichier `/etc/apt/sources.list`, le menu Emplacement peut encore être utilisé pour les dossiers contenant les paquetages Debian. Ces paquetages sont cherchés et mis en cache par apt lui-même, pas par &kpackage;

Pour les paquetages Slackware, il y a peu d'informations stockées sur 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 `PACKAGE.TXT` est l'équivalent d'un fichier de paquetages Debian et les distributions Slackware sont structurées avec une arborescence qui contient les paquetages `.tgz` et un fichier `PACKAGES.TXT` qui décrit les paquetages.

Comme avec les distributions Debian, les paquetages dans une distribution Slackware peuvent être intégrés dans l'arborescence. Malheureusement, les paquetages Slackware ne comportent pas d'information de version, ainsi il est impossible de dire quels paquetages sont nouveaux par rapport à ceux installés.

Pour les paquetages BSD, &kpackage; comprendra un dossier de paquetages de distribution qui contient un fichier `INDEX` (qui décrit tous les paquetages) et contient aussi un dossier `Tous` (contenant tous les fichiers de paquetages).

Pour les dossiers distants et les fichiers de paquetages (c'est-à-dire ceux cherchés par &FTP;), &kpackage; utilise un cache, les paquetages étant mis en cache dans `~/.kpackage` et les dossiers dans `~/.kpackage/dir`

Pour que la manipulation des dossiers distants (&FTP;) fonctionne, il peut être nécessaire de ne pas avoir le Proxy FTP positionné dans la configuration du navigateur.

### Panneau d'information sur les paquetages

Le panneau de droite a des onglets pour afficher deux types différents d'informations sur les paquetages

- L'onglet Propriétés, qui affiche les informations sur le paquetage sélectionné. Dans les informations de dépendances, il y a des hyperliens vers les paquetages listés ; les paquetages installés sont en polices standards, ceux non installés sont en italique.

- L'onglet Liste des fichiers affiche les fichiers du paquetage et, pour les paquetages installés, affiche l'état des fichiers.

### Accès root

&kpackage; a besoin d'un accès `root` pour installer et désinstaller les paquetages, ce qui peut être fait en lançant &kpackage; en tant que `root` par exemple en utilisant &kdesu;.

Alternativement, si &kpackage; est lancé comme utilisateur normal, il essayera de lancer les programmes d'installation / désinstallation comme root en ouvrant un pseudoterminal utilisant soit `su`, soit `ssh` pour faire ceci et si besoin, il ouvrira une fenêtre de terminal où l'on peut saisir le mot de passe `root`. Pour que ceci fonctionne, l'invite de root a la terminaison `#`.

Ceci ne fonctionne pas pour les paquetages RPM, du fait qu'ils sont gérés en interne par &kpackage;.

### Installation des paquetages

Pour installer un paquetage, vous pouvez

- localiser le paquetage que vous voulez installer dans &konqueror;, le tirer et le déposer sur une copie en marche de &kpackage;

- cliquer sur un fichier de paquetage dans &konqueror; pour lancer une nouvelle copie de &kpackage;

- utiliser l'élément de menu Ouvrir dans &kpackage;

- sélectionner un paquetage disponible dans l'arborescence des paquetages.

Pour un paquetage sélectionné, utiliser les boutons dans le panneau de droite. Le bouton Rechercher cherchera un paquetage dans une source distante et affichera les informations détaillées. Le bouton Installer ouvre une fenêtre d'installation.

Pour les paquetages marqués, utilisez le bouton dans le panneau de gauche. Le bouton Installer les paquetages sélectionnés fait surgir une fenêtre d'installation.

La fenêtre d'installation liste les paquetages à installer et permet la configuration d'options d'installation. Le panneau de droite est une fenêtre de terminal intégrée dans laquelle les programmes d'installation sont lancés, pour pouvoir agir avec les programmes d'installation interactifs

Les paquetages RPM sont manipulés assez différemment des autres types de paquetages, car l'installation se fait directement par &kpackage;, le panneau de droite étant utilisé uniquement pour les messages d'erreur.

### Désinstallation des paquetages

Un paquetage sélectionné peut être désinstallé en utilisant le bouton Désinstallation dans la zone de droite, ce qui ouvre une fenêtre avec les options de désinstallation. Le bouton Désinstallation dans la fenêtre provoque la désinstallation des paquetages à désinstaller, et le panneau de droite fournit une fenêtre de terminal intégrée pour les programmes de désinstallation.

Les paquetages marqués peuvent être désinstallés en utilisant le bouton Désinstaller les paquetages sélectionnés dans le panneau de gauche.

## Menus

Ceci décrit les menus de &kpackage;.

### Menu Fichier

Les éléments du menu Fichier sont :

&Ctrl;O Fichier Ouvrir

- Ouvre un sélecteur de fichiers pour les fichiers locaux et &FTP;

Fichier Récemment ouvert(s)

- Une liste des fichiers de paquetages les plus récemment ouverts

&Ctrl;F Fichier Rechercher un Paquetage...

- Cherche un paquetage dans la liste des paquetages installés contenant la chaîne saisie

Fichier Rechercher un Fichier...

- Produit une liste de paquetages qui contiennent le nom du fichier saisi. La sélection d'une ligne affichera les informations sur ce paquetage. Le comportement est légèrement différent pour RPM (où vous devez écrire le nom exact du fichier) et DEB (où vous pouvez saisir une expression rationnelle).

F5 Fichier Recharger

- Relit les données des paquetages et en reconstruit l'arborescence

&Ctrl;Q Fichier Quitter

- Ferme &kpackage;

### Menu Paquetages

Les éléments du menu Paquetages sont :

&Alt;gauche Paquetages Précédent

- Bouton de retour arrière pour la navigation en utilisant les liens dans les entrées de Propriétés du panneau de droite.

&Alt;droite Paquetages Suivant

- Bouton de réavancement pour la navigation en utilisant les liens dans les entrées de Propriétés du panneau de droite.

Paquetages Développer l'arborescence

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

Paquetages Refermer l'arborescence

- Replie l'arborescence des paquetages de manière à ne montrer que la structure de l'arborescence.

Paquetages Effacer la sélection

- Démarque tous les paquetages

### Menu Cache

Les éléments du menu Cache sont :

Cache Vider le cache pour les dossiers de paquetage

- Supprime les copies en cache des dossiers de paquetages distants et des fichiers de paquetages

Cache Vider le cache pour les paquetages

- Supprime les copies en cache des fichiers de paquetages distants qui ont été cherchés

### Menu Spécial

Le menu Spécial contient des actions relatives à des types de paquetages spécifiques :

Spécial Debian apt

- Actualiser

- Met à jour les index de `apt` du référentiel des paquetages.

Mise à jour

- Mettre à jour l'installation de Debian vers la dernière version de tous les paquetages

Réparations

- `apt` est très strict à propos des dépendances et tente de corriger les problèmes de dépendance

### Menu configuration

Les éléments du menu Configuration sont :

Configuration Afficher la barre d'outils

- Afficher ou non la barre d'outils

Configuration Enregistrer la configuration

- Enregistrer les options immédiatement

Configuration Configurer les raccourcis clavier...

- Appelle la boîte de dialogue standard de &kde; pour configurer les raccourcis clavier

Configuration Configurer les barres d'outils...

- Appelle la boîte de dialogue standard de &kde; pour configurer les barres d'outils

Configuration Configurer KPackage...

- Types

- Quels types de paquetages manipuler, Debian utilisant DPKG et Debian utilisant APT sont listés séparément. Ce n'est pas une bonne idée de les activer en même temps.

Dossier de cache

- S'il faut mettre en cache les dossiers distants (&FTP;) et les fichiers de paquetages.

Cache de paquetages

- S'il faut mettre en cache les fichiers de paquetages distants qui ont été cherchés

divers

- Utiliser SSH pour les commandes nécessitant des privilèges

- Utiliser `ssh` au lieu de `su` pour lancer les commandes avec privilèges

Vérification de la liste des fichiers

- Si positionné, la liste des fichiers dans le paquetage est vérifiée pour voir s'ils sont vraiment installés

Lire les informations de tous les paquetages locaux

- Si positionné, tous les fichiers d'un dossier (local) de paquetages sont lus au lieu de simplement utiliser les noms des fichiers. C'est plus lent, mais ceci montre plus d'informations.

Configuration Emplacement des paquetages disponibles

- Emplacement des RPM

- Ceci permet de préciser l'emplacement des dossiers de paquetages (soit locaux, soit &FTP;), chaque ligne incluant une entrée où l'&URL; ou le nom du dossier peut être saisi, un bouton ... qui ouvre un sélecteur de fichiers et une case à cocher Activer qui détermine si le dossier donné sur la ligne doit être utilisé ou non. La case à cocher Sous-dossiers indique s'il faut descendre récursivement dans les sous-dossiers. Les onglets multiples sont juste là par commodité.

Zone BSD

- Le premier panneau donne l'emplacement de l'arborescence des ports dans le système de fichiers

  L'autre panneau permet de spécifier l'emplacement des dossiers de paquetages, c'est-à-dire ceux qui contiennent des fichiers `INDEX`

Emplacement DEB

- Il y a trois types différents de panneaux

  - Les trois premiers onglets ont une entrée pour l'emplacement de l'arborescence de la distribution Debian, une boîte combo pour le nom de la distribution et une boîte combo pour l'architecture

  - Les deux onglets suivants permettent la spécification de l'arborescence Debian et l'emplacement des fichiers de paquetages dans cette distribution.

  - Les trois derniers panneaux spécifient les dossiers de la même manière que pour RPM.

Emplacement SLACK

- Pour les paquetages Slackware, il y a trois types de panneaux

  - Le premier panneau est l'emplacement d'un fichier `PACKAGES.TXT` qui est utilisé pour fournir les informations sur les paquetages installés

  - Les quatre panneaux suivants peuvent être utilisés pour spécifier l'emplacement de distributions avec l'arborescence de dossiers contenant les fichiers `.tgz` et l'emplacement du fichier `PACKAGES.TXT` correspondant

  - Les deux derniers panneaux sont pour les dossiers qui n'ont pas de fichier`PACKAGES.TXT` correspondant

### Menu Aide

Les éléments du menu Aide sont :

&help.menu.documentation;

### Barre d'outils

- Ouvrir

- Précédent (historique)

- Suivant

- Développer l'arborescence

- Refermer l'arborescence

- Rechercher un paquetage

- Rechercher un fichier

- Recharger

- Quitter

## Remerciements et licences

&kpackage;

Programme copyright 1999-2000 Damyan Pepper, Toivo Pedaste

Documentation copyright 2000 Toivo Pedaste toivo@ucs.uwa.edu.au

Traduction française par &GerardDelafond;.

Relecture par &LudovicGrossard;.

&underFDL; &underGPL;

## Installation

### Comment obtenir &kpackage;

&install.intro.documentation;

Pour les informations sur la manière de l'obtenir et le compiler, voyez http://www.kde.org/install-source.html

Il y a d'autres informations sur la compilation sur http://www.kde.org/compilationfaq.html

Il y a une page web à http://www.general.uwa.edu.au/u/toivo/kpackage

### Configuration nécessaire

Pour installer &kpackage;, vous avez besoin de :

- &Qt; 3.x et &kde; 3.1

Pour lister les paquetages Debian, aucun autre logiciel n'est nécessaire, mais pour installer et désinstaller les paquetages, vous avez besoin :

- du gestionnaire de paquetages `dpkg` ou

- de `apt-get` et `apt-cache`

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 gérer les paquetages Redhat, vous avez besoin de

- RPM et RPM-DEVEL : 3.0 ou 4.0

- les mêmes bibliothèques que pour compiler RPM. Ce sont :

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

  - les bibliothèques de compactage `libz` et `libz-dev`

  - RPM nécessite la routine gettext qui se trouve dans la `libc6` ou dans `libintl`

  - RPM 3.0 peut nécessiter le paquetage `popt`

Pour que &kpackage; fonctionne correctement avec les paquetages RPM, la base de données de RPM doit être initialisée. Si la commande ``rpm` `-qa`` renvoie une erreur comme `incapable d'ouvrir...`, alors essayez ``rpm` `--rebuilddb``.