# HG changeset patch # User Christophe Lincoln # Date 1306981056 -7200 # Node ID 77653f4cfe175174fd079eeee227b90a3aead17a # Parent eb8bcff82c5ea113677dc28d6ab3c24df59213b0 Update doc, use new style and a css file to avoid code duplication in html diff -r eb8bcff82c5e -r 77653f4cfe17 doc/style.css --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/style.css Thu Jun 02 04:17:36 2011 +0200 @@ -0,0 +1,48 @@ +/* CSS style for SliTaz Doc */ + +html { min-height: 102%; } +body { font: 88% sans-serif, vernada, arial; margin: 0; } +h1 { margin: 0; padding: 8px; color: #fff; font-size: 20px; } +h2 { color: #d66018; } h3 { color: #666; font-size: 140%; } +a:hover { text-decoration: none; } +img { border: 0pt none; vertical-align: middle; } +pre { + background-color: #f8f8f8; + border: 1px solid #ddd; + padding: 10px; + border-radius: 4px; +} + +#header { + background: #351a0a; + height: 40px; + border-bottom: 8px solid #d66018; +} + +#content { + margin: 40px 80px; + text-align: justify; +} + +#footer { + text-align: center; + padding: 20px; + border-top: 1px solid #ddd; +} + +/* Languages */ + +#lang { + float: right; + padding: 6px; + font-size: 11px; +} + +#lang a { + text-decoration: none; + padding: 0 2px; +} + +#lang a:hover { + text-decoration: underline; +} diff -r eb8bcff82c5e -r 77653f4cfe17 doc/tazpkg.en.html --- a/doc/tazpkg.en.html Thu Jun 02 04:01:00 2011 +0200 +++ b/doc/tazpkg.en.html Thu Jun 02 04:17:36 2011 +0200 @@ -1,22 +1,14 @@ - Tazpkg Manual + Tazpkg Manual (en) - + + - + @@ -26,7 +18,7 @@

NAME

-Tazpkg - Tiny autonomous zone package manager + Tazpkg - Tiny autonomous zone package manager

SYNTAX

@@ -286,7 +278,7 @@ -

up (upgrade)

+

up or upgrade

Upgrade allows you to update all installed packages available on the current mirror. Upgrading packages is an important diff -r eb8bcff82c5e -r 77653f4cfe17 doc/tazpkg.fr.html --- a/doc/tazpkg.fr.html Thu Jun 02 04:01:00 2011 +0200 +++ b/doc/tazpkg.fr.html Thu Jun 02 04:17:36 2011 +0200 @@ -1,37 +1,24 @@ - - + + - Tazpkg Manual - Manuel du gestionnaire de paquets 'tazpkg' - - - - - + Manuel de Tazpkg (fr) + + + - + + +

-
+

NOM

-Tazpkg - Tiny autonomous zone package manager + Tazpkg - Tiny autonomous zone package manager

SYNTAXE

@@ -42,22 +29,22 @@

DESCRIPTION

-Tazpkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant -d'installer, lister, télécharger, mettre à jour ou enlever des paquets -précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de -recherche et une commande pour la création de paquets. Il a été créé pour les +Tazpkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant +d'installer, lister, télécharger, mettre à jour ou enlever des paquets +précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de +recherche et une commande pour la création de paquets. Il a été créé pour les besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets -utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de -fichiers (fs) compressé avec gzip, la recette et une éventuelle description. -Tazpkg fournit aussi un système de gestion des dépendances basé sur les +utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de +fichiers (fs) compressé avec gzip, la recette et une éventuelle description. +Tazpkg fournit aussi un système de gestion des dépendances basé sur les recettes des paquets. La recette contient toutes les informations au sujet du paquet, elle peut aussi contenir les fonctions de pre et post installation. -Cette même recette est par ailleurs utilisée par Tazwok pour compiler les -sources et créer un paquet tazpkg. +Cette même recette est par ailleurs utilisée par Tazwok pour compiler les +sources et créer un paquet tazpkg.

-Tazpkg est écrit en script shell depuis rien (from scratch), compatible -Bash, et fonctionne avec Ash du projet Busybox. Tazpkg est distribué +Tazpkg est écrit en script shell depuis rien (from scratch), compatible +Bash, et fonctionne avec Ash du projet Busybox. Tazpkg est distribué sous license libre GNU gpl v3.

@@ -65,7 +52,7 @@

Tazpkg fourni un mode SHell permettant de directement passer les commandes au gestionnaire de paquets. Ce mode est utile pour lancer quelques commandes -comme la mise à jour du système, il support 'su' pour devenir admnistrateur +comme la mise à jour du système, il support 'su' pour devenir admnistrateur mais ne propose pas le rappel des commandes. Pour utiliser Tazpkg en mode SHell :

@@ -75,14 +62,14 @@

COMMANDES

-

list

+

list

-Liste et compte les paquets installés sur le système. Cette commande permet -d'afficher sur une colonne la liste tous les paquets installés, vous pouvez +Liste et compte les paquets installés sur le système. Cette commande permet +d'afficher sur une colonne la liste tous les paquets installés, vous pouvez aussi utiliser la commande de recherche (search) pour avoir une liste en fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister -les catégories, les paquets en fonction de leur catégorie et les paquets -bloqués : +les catégories, les paquets en fonction de leur catégorie et les paquets +bloqués :

  # tazpkg list
@@ -90,14 +77,14 @@
  # tazpkg list blocked
 
-

xhtml-list

+

xhtml-list

-La commande 'xhtml-list' permet de créer une liste au format xHTML des -paquets installés sur le système, une fois générée, cette liste peut être -lue avec votre navigateur Web préféré. Cette commande peut être lancée -en tant que simple utilisateur et crée par défaut une liste nommée -'installed-packages.html' dans le répertoire courant. A noter que vous -pouvez aussi changer le nom de la liste générée via la ligne de +La commande 'xhtml-list' permet de créer une liste au format xHTML des +paquets installés sur le système, une fois générée, cette liste peut être +lue avec votre navigateur Web préféré. Cette commande peut être lancée +en tant que simple utilisateur et crée par défaut une liste nommée +'installed-packages.html' dans le répertoire courant. A noter que vous +pouvez aussi changer le nom de la liste générée via la ligne de commande :

@@ -105,59 +92,59 @@
  # tazpkg xhtml-list list-name.html
 
-

list-mirror

+

list-mirror

Liste et compte les paquets disponnibles sur le miroir. Cette commande va -afficher le dernier fichier packages.list rechargé depuis le miroir, si la -liste des paquets n'existe pas, il vous sera demandé de lancer la commande +afficher le dernier fichier packages.list rechargé depuis le miroir, si la +liste des paquets n'existe pas, il vous sera demandé de lancer la commande 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste -des paquets disponibles. L'option --diff est utilisée pour afficher le -fichier des différences entre la dernière et l'actuelle liste des paquets : +des paquets disponibles. L'option --diff est utilisée pour afficher le +fichier des différences entre la dernière et l'actuelle liste des paquets :

  # tazpkg list-mirror
  # tazpkg list-mirror --diff
 
-

info

+

info

Donne les informations disponibles dans la recette du paquet en question, sa -version, sa catégorie, le mainteneur, son site Web et ses éventuelles -dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) : +version, sa catégorie, le mainteneur, son site Web et ses éventuelles +dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :

  # tazpkg info busybox
 
-

desc

+

desc

Description du paquet (si elle existe). Cette commande affiche le fichier -description.txt propre à chaque paquet, la description est un simple fichier -texte ne dépassant pas le 80 caractères pour un affichage standard dans un -terminal. Si la description du paquet n'existe pas, vous pouvez la créer et +description.txt propre à chaque paquet, la description est un simple fichier +texte ne dépassant pas le 80 caractères pour un affichage standard dans un +terminal. Si la description du paquet n'existe pas, vous pouvez la créer et l'envoyer au mainteneur du paquet (quelques lignes suffisent) :

  # tazpkg desc busybox
 
-

list-files

+

list-files

-Liste et compte les fichiers installés avec un paquet. Cette commande va -simplement lire et classer le fichier files.list propre à chaque paquet, ce -fichier est généré automatiquement lors de la création, il est aussi utilisé -pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour -lister les fichier installés avec le paquet bc : +Liste et compte les fichiers installés avec un paquet. Cette commande va +simplement lire et classer le fichier files.list propre à chaque paquet, ce +fichier est généré automatiquement lors de la création, il est aussi utilisé +pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour +lister les fichier installés avec le paquet bc :

  # tazpkg list-files bc
 
-

search

+

search

Recherche de paquets par patron ou nom de paquet. La commande -va chercher le terme voulu dans les paquets installés et dans les listes des -paquets disponibles sur le miroir. Pour obtenir la plus récente liste des +va chercher le terme voulu dans les paquets installés et dans les listes des +paquets disponibles sur le miroir. Pour obtenir la plus récente liste des paquets installables depuis internet, il suffit de lancer 'tazpkg recharge' avant d'effectuer une recherche :

@@ -168,24 +155,24 @@ # tazpkg search gcc [-i|-l|-m] -

search-files

+

search-files

La commande 'search-file' permet de rechercher un fichier parmi tous les -fichiers installés par tous les paquets. Cette commande est très utile pour +fichiers installés par tous les paquets. Cette commande est très utile pour trouver le chemin complet vers un fichier et savoir si un fichier est bien -présent sur le système. Exemple : +présent sur le système. Exemple :

  $ tazpkg search-file libnss
 
-

install

+

install

Cette commande permet l'installation d'un paquet local avec l'extension .tazpkg. Voir la commande 'get-install' pour installer un paquet depuis internet. A noter que vous pouvez forcer l'installation via l'option ---forced, désinstaller et réinstaller ou encore spécifier la racine du système -dans lequel vous désirez installer le paquets via l'option --root= : +--forced, désinstaller et réinstaller ou encore spécifier la racine du système +dans lequel vous désirez installer le paquets via l'option --root= :

  # tazpkg install package-1.0.tazpkg
@@ -195,52 +182,52 @@
  # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
 
-

install-list

+

install-list

-Installation d'un set de paquets listés dans un fichier. Cette commande -permet d'installer plusieurs paquets en une seule commande et peut aussi être -forcée : +Installation d'un set de paquets listés dans un fichier. Cette commande +permet d'installer plusieurs paquets en une seule commande et peut aussi être +forcée :

  # tazpkg install-list my-packages.list
  # tazpkg install-list my-packages.list --forced
 
-

link

+

link

-Cette commande permet l'installation d'un paquet déjà installé sur un +Cette commande permet l'installation d'un paquet déjà installé sur un autre media. Cette installation s'effectue par des liens symboliques et -consomme très peu de mémoire. Elle est utilisée généralement avec un système -en RAM pour installer des compléments depuis une clé USB. +consomme très peu de mémoire. Elle est utilisée généralement avec un système +en RAM pour installer des compléments depuis une clé USB.

  # tazpkg link openoffice /media/usbdisk
 
-

add-flavor

+

add-flavor

-Installation d'un set de paquets listés dans une saveur. Cette commande +Installation d'un set de paquets listés dans une saveur. Cette commande permet d'installer tous les paquets d'une saveur en une seule commande sans -avoir à générer un nouveau cdrom avec tazlito. +avoir à générer un nouveau cdrom avec tazlito.

  # tazpkg add-flavor office.flavor
 
-

install-flavor

+

install-flavor

-Remplacement de tous les paquets par ceux listés dans une saveur. Cette +Remplacement de tous les paquets par ceux listés dans une saveur. Cette commande permet de transformer la distribution courante en une seule commande -sans avoir à générer un nouveau cdrom avec tazlito. +sans avoir à générer un nouveau cdrom avec tazlito.

  # tazpkg install-flavor office.flavor
 
-

remove

+

remove

-Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette -commande va supprimer tous les fichiers installés avec le paquet, pour +Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette +commande va supprimer tous les fichiers installés avec le paquet, pour afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg suivie du nom du paquet en question. Exemple avec le paquet bc :

@@ -248,10 +235,10 @@ # tazpkg remove bc -

extract

+

extract

-Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le -répertoire de destination, le paquet sera extrait dans le répertoire courant +Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le +répertoire de destination, le paquet sera extrait dans le répertoire courant en utilisant le nom paquet-version :

@@ -259,86 +246,96 @@
  # tazpkg extract package.tazpkg target/dir
 
-

pack

+

pack

-La commande 'pack' permet de créer un paquet depuis un répertoire préparé à -l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer -manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création +La commande 'pack' permet de créer un paquet depuis un répertoire préparé à +l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer +manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création automatique de paquets). Pour empaqueter un paquet :

  # tazpkg pack package-version
 
-

repack

+

repack

-La commande 'repack' permet de recréer un paquet depuis les fichiers présents -sur le système où il a été précédemment installé. Pour réempaqueter un paquet : +La commande 'repack' permet de recréer un paquet depuis les fichiers présents +sur le système où il a été précédemment installé. Pour réempaqueter un paquet :

  # tazpkg repack package
 
-

recharge

+

recharge

Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette -commande va télécharger la plus récente liste des paquets installables depuis -le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne -liste. Une fois la liste à jour, vous pouvez la consulter via la commande +commande va télécharger la plus récente liste des paquets installables depuis +le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne +liste. Une fois la liste à jour, vous pouvez la consulter via la commande 'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg. -Pour réafficher la liste des différences, vous pouvez utiliser la commande -'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système, -vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des +Pour réafficher la liste des différences, vous pouvez utiliser la commande +'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système, +vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des paquets :

  # tazpkg recharge
 
-

upgrade

+

up ou upgrade

-La commande 'upgrade' permet de mettre à jour tous les paquets installés et -disponibles sur le miroir courant. La mise à jour des paquets est une -importante partie du système, elle permet de garder un système sécurisé avec -les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit -régulièrement des mises à jours de sécurité et propose généralement les -dernières versions des logiciels. A noter que cette fonction est destinée aux -personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis -à jour seront perdus lors de l'arrêt du système. Pour garder un système un +La commande 'upgrade' permet de mettre à jour tous les paquets installés et +disponibles sur le miroir courant. La mise à jour des paquets est une +importante partie du système, elle permet de garder un système sécurisé avec +les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit +régulièrement des mises à jours de sécurité et propose généralement les +dernières versions des logiciels. A noter que cette fonction est destinée aux +personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis +à jour seront perdus lors de l'arrêt du système. Pour garder un système un jour :

- # tazpkg upgrade
+ # tazpkg up
 
+

+ Up permet aussi d'automatiquement recharger la list des paquets ou installer + les mises à jours. Petit example et affichage de l'aide spécifique à cette + commande: +

+
+ # tazpkg up --recharge
+ # tazpkg --help-up
+
+ -

set-release

+

set-release

La commande 'set-release' permet de changer la version de SliTaz et de mettre -à jour tous les paquets. Attention cette commande peut être dangereuse dans -la cas d'une mise à jour de la version stable version en cuisson (cooking) : +à jour tous les paquets. Attention cette commande peut être dangereuse dans +la cas d'une mise à jour de la version stable version en cuisson (cooking) :

  # tazpkg set-release cooking
 
-

check

+

check

-La commande 'check' permet de vérifier les dépendances sur les paquets -installés et de vérifier si tous les fichiers nécessaires à la reconstruction -des paquets sont bien présents : +La commande 'check' permet de vérifier les dépendances sur les paquets +installés et de vérifier si tous les fichiers nécessaires à la reconstruction +des paquets sont bien présents :

  # tazpkg check
  # tazpkg check --full
 
-

block ou unblock

+

block ou unblock

Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet -installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste -des paquets bloqués est contenue dans le fichier : -/var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main. -Pour bloquer ou débloquer un paquet tel que Grub : +installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste +des paquets bloqués est contenue dans le fichier : +/var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main. +Pour bloquer ou débloquer un paquet tel que Grub :

  # tazpkg block grub
@@ -346,22 +343,22 @@
  # tazpkg unblock grub
 
-

get

+

get

-Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé -est stocké dans le répertoire courant, pour connaître le chemin vous pouvez -utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit +Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé +est stocké dans le répertoire courant, pour connaître le chemin vous pouvez +utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit de lancer la commande :

  # tazpkg get grub
 
-

get-install

+

get-install

Installer un paquet depuis un mirroir sur internet. La commande 'get-install' -commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas -déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la +commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas +déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la liste des paquets sur le miroir il faut utiliser la commande 'list-mirror' (voir aussi recharge). Pour installer un paquet tel que 'grub' :

@@ -369,37 +366,37 @@ # tazpkg get-install grub -

clean-cache

+

clean-cache

-Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation +Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour -gagner de la bande passante en cas de réinstallation, mais il se peut que vous -vouliez libérer de la place sur le disque dur ou que vous désiriez -retélécharger des paquets : +gagner de la bande passante en cas de réinstallation, mais il se peut que vous +vouliez libérer de la place sur le disque dur ou que vous désiriez +retélécharger des paquets :

  # tazpkg clean-cache
 
-

setup-mirror

+

setup-mirror

Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors -l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant -par des espaces. A noter que vous pouvez aussi modifier à la main le -fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant +l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant +par des espaces. A noter que vous pouvez aussi modifier à la main le +fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant la liste (packages.list) et les paquets :

  # tazpkg setup-mirror
 
-

setup-undigest ou add-undigest

+

setup-undigest ou add-undigest

-Configurer l'URL d'un miroir complémentaire non officiel pour tester des -paquets non encore présents sur les miroirs. -A noter que vous pouvez aussi modifier à la main le fichier +Configurer l'URL d'un miroir complémentaire non officiel pour tester des +paquets non encore présents sur les miroirs. +A noter que vous pouvez aussi modifier à la main le fichier /var/lib/tazpkg/undigest/<undisgest-name>/mirror. -L'URL doit pointer sur le répertoire contenant +L'URL doit pointer sur le répertoire contenant la liste (packages.list) et les paquets :

@@ -407,23 +404,23 @@
  # tazpkg setup-undigest local-repository /home/slitaz/packages
 
-

remove-undigest

+

remove-undigest

-Supprime l'URL un miroir complémentaire non officiel. +Supprime l'URL un miroir complémentaire non officiel.

  # tazpkg remove-undigest my-repository
 
-

list-undigest

+

list-undigest

-Affiche les miroirs complémentaires. +Affiche les miroirs complémentaires.

  # tazpkg list-undigest
 
-

reconfigure

+

reconfigure

La commande 'reconfigure' permet de relancer les commande de post et pre-installation d'un paquet afin de le reconfigurer si besoin est : @@ -432,7 +429,7 @@ # tazpkg reconfigure package -

convert

+

convert

La commande 'convert' permet de convertir un paquet Debian (.deb), Redhat (.rpm), Slackware (.tgz) ou Archlinux (.pkg.tar.gz) en paquet @@ -442,25 +439,25 @@ # tazpkg convert alien-package -

depend

+

depend

-Affiche l'arbre des dépendances d'un paquet, c'est à dire tous les -paquets qui devront être installés en plus : +Affiche l'arbre des dépendances d'un paquet, c'est à dire tous les +paquets qui devront être installés en plus :

  # tazpkg depend package
 
-

rdepend

+

rdepend

-Affiche l'arbre des dépendances inversé d'un paquet, c'est à dire tous les -paquets qui en dépendent directement ou indirectement : +Affiche l'arbre des dépendances inversé d'un paquet, c'est à dire tous les +paquets qui en dépendent directement ou indirectement :

  # tazpkg rdepend package
 
-

bugs

+

bugs

Affiche les bugs connus :

@@ -473,7 +470,8 @@ Christophe Lincoln <pankso at slitaz.org>

+
- + diff -r eb8bcff82c5e -r 77653f4cfe17 doc/tazpkg.pt.html --- a/doc/tazpkg.pt.html Thu Jun 02 04:01:00 2011 +0200 +++ b/doc/tazpkg.pt.html Thu Jun 02 04:17:36 2011 +0200 @@ -1,38 +1,25 @@ - - + + - Tazpkg Manual - - - - - + Manual Tazpkg (pt) + + + - + + + -
+

NOME

-Tazpkg - Tiny autonomous zone package manager + Tazpkg - Tiny autonomous zone package manager

SINTAXE

@@ -451,8 +438,9 @@ Christophe Lincoln <pankso at slitaz.org>

+
- +