website annotate doc/manuals/tazwok.html @ rev 189

en: Fix flavors link
author Paul Issott <paul@slitaz.org>
date Thu Nov 13 23:34:25 2008 +0000 (2008-11-13)
parents 820d0069a6a3
children
rev   line source
pankso@4 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@4 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@4 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
pankso@4 4 <head>
pankso@4 5 <title>Tazwok Manual</title>
pankso@4 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@4 7 <meta name="description" content="" />
pankso@4 8 <meta name="expires" content="never" />
pankso@4 9 <meta name="modified" content="2008-02-06 15:05:00" />
pankso@4 10 <style type="text/css"><!--
pankso@4 11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
pankso@4 12 #header { background: #f0ba08; color: black; height: 50px;
pankso@4 13 border-top: 1px solid black; border-bottom: 1px solid black; }
pankso@4 14 #content { margin: 0px 50px 26px 50px; }
pankso@4 15 h1 { margin: 14px 0px 0px 16px; }
pankso@4 16 li { line-height: 1.4em; }
pankso@4 17 pre { padding: 5px; color: black; background: #e1e0b0; }
pankso@4 18 pre.script { padding: 10px; color: black; background: #e8e8e8;
pankso@4 19 border: 1px inset #333333; }
pankso@4 20 code { font-size: 100%; color: #669900; background: transparent; }
pankso@4 21 hr { color: white; background: white; height: 1px; border: 0; }
pankso@4 22 --></style>
pankso@4 23 </head>
pankso@4 24 <body bgcolor="#ffffff">
pankso@4 25 <div id="header">
pankso@4 26 <h1><font color="#3e1220">Tazwok Manual</font></h1>
pankso@4 27 </div>
pankso@4 28 <hr />
pankso@4 29 <!-- Start content -->
pankso@4 30 <div id="content">
pankso@4 31
pankso@4 32 <h2>NOM</h2>
pankso@4 33 <p>
pankso@4 34 Tazwok - SliTaz sources and packages cooker.
pankso@4 35 </p>
pankso@4 36
pankso@4 37 <h2>SYNTAXE</h2>
pankso@4 38 <pre>
pankso@4 39 tazwok [command] [package|list|category|dir] [--option]
pankso@4 40 </pre>
pankso@4 41
pankso@4 42 <h2>DESCRIPTION</h2>
pankso@4 43 <p>
pankso@4 44 Tazwok est un outils en ligne de commande permettant de configurer et de
pankso@4 45 compiler un paquet depuis les sources. Tazwok permet aussi de créer des
pankso@4 46 paquets prêts à être utilisé par Tazpkg, le gestionnaire de paquets créer
pankso@4 47 pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette
pankso@4 48 et toutes les informations nécessaires à la construction du paquet, cette
pankso@4 49 recette est aussi utilisée par Tazpkg et se compose de différentes variables
pankso@4 50 et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf)
pankso@4 51 pour connaître le chemin vers le wok, les paquets sources et les paquets
pankso@4 52 (.tazpkg) générés. Il est aussi capable de générer une liste paquets avec
pankso@4 53 leurs sommes md5, des créer un nouveau paquet de manière interactive, de faire
pankso@4 54 une recherche, de nettoyer les fichiers générés ou encore de cuire plusieurs
pankso@4 55 paquets en une seule fois (Voir les commandes disponibles).
pankso@4 56 </p>
pankso@4 57 <p>
pankso@4 58 Tazwok est écript en script shell depuis rien (from scratch), compatible Bash,
pankso@4 59 et fonctionnant avec Ash du projet Busybox. Tazwok est distribué sous license
pankso@4 60 libre GNU gpl v3. Les recettes avec leures commades sont basée sur le livre
pankso@4 61 de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet
pascal@179 62 de Tazwok et du développement de SliTaz.
pankso@4 63 </p>
pankso@4 64
pankso@4 65 <h2>COMMANDES</h2>
pankso@4 66 <h3><font color="#6c0023">usage</font></h3>
pankso@4 67 <p>
pankso@4 68 La commande 'usage' affiche la liste des commandes diponibles avec une petite
pankso@4 69 description en English :
pankso@4 70 </p>
pankso@4 71 <pre>
pankso@4 72 # tazwok usage
pankso@4 73 </pre>
pankso@4 74 <h3><font color="#6c0023">stats</font></h3>
pankso@4 75 <p>
pankso@4 76 Stats affiche les informations contenue dans le fichier de configuration et
pankso@4 77 le nombre de paquets disponibles dans le wok :
pankso@4 78 </p>
pankso@4 79 <pre>
pankso@4 80 # tazwok stats
pankso@4 81 </pre>
pankso@4 82 <h3><font color="#6c0023">list</font></h3>
pankso@4 83 <p>
pankso@4 84 La commande 'list' permet de lister l'ensemble des paquets contenus dans le
pankso@4 85 wok ou de lister les catégories par défauts (vous pouvez créer la votre). Elle
pankso@4 86 permet aussi de lister les paquets d'une catégorie :
pankso@4 87 </p>
pankso@4 88 <pre>
pankso@4 89 # tazwok list
pankso@4 90 # tazwok list category
pankso@4 91 </pre>
pankso@4 92 <h3><font color="#6c0023">info</font></h3>
pankso@4 93 <p>
pankso@4 94 Cette commande donne des informations sur le paquet, nom, version, etc. Info
pankso@4 95 ce base sur la recette du paquet pour connaître les informations, c'est les
pankso@4 96 mêmes infos affichées par Tazpkg et les paquets installés :
pankso@4 97 </p>
pankso@4 98 <pre>
pankso@4 99 # tazwok info package
pankso@4 100 </pre>
pankso@4 101 <h3><font color="#6c0023">check-log</font></h3>
pankso@4 102 <p>
pankso@4 103 Lors de la compilation et génération du paquet binaire, Tazwok génére quelques
pankso@4 104 messages de log stockés dans un fichier 'process.log'. Pour les afficher :
pankso@4 105 </p>
pankso@4 106 <pre>
pankso@4 107 # tazwok check-log package
pankso@4 108 </pre>
pankso@4 109 <h3><font color="#6c0023">search</font></h3>
pankso@4 110 <p>
pankso@4 111 Search permet de faire une recherche de paquet dans le wok. Vous pouvez
pankso@4 112 spécifier un terme ou un nom de paquet :
pankso@4 113 </p>
pankso@4 114 <pre>
pankso@4 115 # tazwok search name
pankso@4 116 </pre>
pankso@4 117 <h3><font color="#6c0023">compile</font></h3>
pankso@4 118 <p>
pankso@4 119 Compile va compiler. Cette commande utilise les régles de compilation
pankso@4 120 (compile_rules) spécifiées dans la recette du paquet en question, pour
pankso@4 121 compiler les sources. A noter qu'il n'y a pas forcement de régles de
pankso@4 122 compilation, des paquets sont directement généré par 'genpkg' et que la
pankso@4 123 commande 'cook' permet de compiler les sources et générer le paquet binaire
pankso@4 124 en une seule fois. Exemple :
pankso@4 125 </p>
pankso@4 126 <pre>
pankso@4 127 # tazwok compile package
pankso@4 128 </pre>
pankso@4 129 <h3><font color="#6c0023">genpkg</font></h3>
pankso@4 130 <p>
pankso@4 131 Genpkg pour <em>Generate package</em>, va générer le paquet (.tazpkg) en
pankso@4 132 utilisant la fonction 'genpkg_rules' trouvée dans sa recette et compresser
pankso@4 133 les fichiers. Une fois le paquet généré, il est stocké dans le repositoire
pankso@4 134 des paquetss spécifié dans le fichier de configuration ('tazwok stats' pour
pankso@4 135 afficher la configuration courante). Le paquet peut ensuite facilement
pankso@4 136 s'installer via Tazpkg ou être utilisé par Tazlito pour générer une
pankso@4 137 distribution LiveCD automatiquement. A noter que les fichiers standards tels
pankso@4 138 que les locales, le pixmap ou le fichier.desktop sont automatiquement copiés
pankso@4 139 dans $fs/usr/share, si les chemins sont standards ou si le fichier existe dans
pankso@4 140 /stuff. Utilisation de 'genpkg' :
pankso@4 141 </p>
pankso@4 142 <pre>
pankso@4 143 # tazwok genpkg package
pankso@4 144 </pre>
pankso@4 145 <h3><font color="#6c0023">cook</font></h3>
pankso@4 146 <p>
pankso@4 147 Cook va simplement compiler et empaqueter les paquet en une seule fois :
pankso@4 148 </p>
pankso@4 149 <pre>
pankso@4 150 # tazwok cook package
pankso@4 151 </pre>
pankso@4 152 <h3><font color="#6c0023">cook-list</font></h3>
pankso@4 153 <p>
pankso@4 154 Cette commade va lancer 'tazwok cook' sur tous les paquets contenus dans la
pankso@4 155 liste spécifiées en argument. Cook-list est utilisés par exemple, pour cuire
pankso@4 156 le système de base, les applications de base, le système X, etc. Avant de
pankso@4 157 lancer cette commande avec un grand nombre de paquets, il est conseillé de
pankso@4 158 cuire une fois le système de base (base-system) sans la glibc. Sur SliTaz,
pankso@4 159 vous trouverez des exemples de liste de cuisson (cooklist) dans le répertoire
pankso@4 160 des exemples /usr/share/examples/tazwok/cooklists :
pankso@4 161 </p>
pankso@4 162 <pre>
pankso@4 163 # tazwok cook-list packages.cooklist
pankso@4 164 </pre>
pankso@4 165 <h3><font color="#6c0023">clean</font></h3>
pankso@4 166 <p>
pankso@4 167 Clean permet simplement de supprimer tous les fichiers générés par la
pankso@4 168 compilation et l'empaquetage, pour recommencer à cuire (cook) :
pankso@4 169 </p>
pankso@4 170 <pre>
pankso@4 171 # tazwok clean package
pankso@4 172 </pre>
pankso@4 173 <h3><font color="#6c0023">new-tree</font></h3>
pankso@4 174 <p>
pankso@4 175 La commande 'new-tree' permet de créer un nouveau paquet dans le wok et
pankso@4 176 peut s'utiliser de manière interactive. New-tree va créer le répertoire du
pankso@4 177 paquet et une recette modèle (receipt), cette recette peur être éditée avec
pankso@4 178 votre éditeur de texte préféré et peut se configurer via l'option
pankso@4 179 '--interactive'. Pour vous aider vous pouvez regarder des recettes existantes
pankso@4 180 et lire la documentation du Cookbook. Exemple d'utilisation :
pankso@4 181 </p>
pankso@4 182 <pre>
pankso@4 183 # tazwok new-tree package
pankso@4 184 # tazwok new-tree package --interactive
pankso@4 185 </pre>
pankso@4 186 <h3><font color="#6c0023">gen-list</font></h3>
pankso@4 187 <p>
pankso@4 188 La commande 'gen-list' permet de générer une liste de paquets (packages.list),
pankso@4 189 leurs sommes md5 (packages.md5) et en option une liste de paquet contenant plus
pankso@4 190 d'informations (packages.txt). Les simples listes sont crées en se basant sur
pankso@4 191 les paquets contenus dans un répertoire. La liste au format texte est construite
pankso@4 192 avec les recettes contenues dans un wok. Le répertoire des paquets par défaut
pankso@4 193 est celui spécifié dans le fichier de configuration, vous avez aussi la
pankso@4 194 possibilité de spécifier le répertoire à utiliser sur la ligne de commande.
pankso@4 195 Utilisation de la commande 'gen-list' :
pankso@4 196 </p>
pankso@4 197 <pre>
pankso@4 198 # tazwok gen-list
pankso@4 199 # tazwok gen-list --text
pankso@4 200 # tazwok gen-list /path/to/repository
pankso@4 201 </pre>
pankso@4 202 <h3><font color="#6c0023">gen-clean-wok et clean-wok</font></h3>
pankso@4 203 <p>
pankso@4 204 La commande 'gen-clean-wok' permet de générer un wok propre depuis le wok
pankso@4 205 courant. Cette commande est utile pour sauvegarder un version du wok ou copier
pankso@4 206 un wok pour tester avec un autre. Quand à la commande 'clean-wok', elle va
pankso@4 207 nettoyer tous les paquets du wok courant et supprimer tous les fichiers
pankso@4 208 générés. Pour récupérer un wok propre ou nettoyer le wok actuel :
pankso@4 209 </p>
pankso@4 210 <pre>
pankso@4 211 # tazwok gen-clean-wok path/to/new-wok
pankso@4 212 # tazwok clean-wok
pankso@4 213 </pre>
pankso@4 214 <h3><font color="#6c0023">remove</font></h3>
pankso@4 215 <p>
pankso@4 216 Supprime le paquet spécifié du wok, avec tous les fichiers, stuff et recette
pankso@4 217 y compris :
pankso@4 218 </p>
pankso@4 219 <pre>
pankso@4 220 # tazwok remove package
pankso@4 221 </pre>
pascal@179 222 <h3><font color="#6c0023">build-depends</font></h3>
pascal@179 223 <p>
pascal@179 224 Build-depends génère une liste de paquets nécessaires pour compiler le wok :
pascal@179 225 </p>
pascal@179 226 <pre>
pascal@179 227 # tazwok build-depends
pascal@179 228 </pre>
pascal@179 229 <h3><font color="#6c0023">cmp|compare</font></h3>
pascal@179 230 <p>
pascal@179 231 Compare le wok avec les paquets déjà cuits et génère un rapport.
pascal@179 232 Les paquets obsolètes peuvent être effacés avec l'option --remove.
pascal@179 233 Les paquets à compiler peuvent l'être avec l'option --cook.
pascal@179 234 </p>
pascal@179 235 <pre>
pascal@179 236 # tazwok compare
pascal@179 237 # tazwok compare --remove
pascal@179 238 # tazwok compare --cook
pascal@179 239 </pre>
pascal@179 240 <h3><font color="#6c0023">check</font></h3>
pascal@179 241 <p>
pascal@179 242 Recherche les erreurs courantes dans les receipts :
pascal@179 243 </p>
pascal@179 244 <pre>
pascal@179 245 # tazwok check
pascal@179 246 </pre>
pankso@4 247
pankso@4 248 <h2>MAINTENEUR</h2>
pankso@4 249 <p>
pankso@4 250 Christophe Lincoln &lt;pankso at slitaz.org&gt;
pankso@4 251 </p>
pankso@4 252
pankso@4 253 <!-- End content -->
pankso@4 254 </div>
pankso@4 255 </body>
pankso@4 256 </html>