tazwok rev 332

Refresh french doc
author: Antoine Bodin <gokhlayeh@slitaz.org>
date: Sun Feb 20 19:29:49 2011 +0100 (2011-02-20)
parents: 9c8e898aac33
children: 8ededfb1d957
files: doc/developer.txt doc/tazwok.html
     1.1 --- a/doc/developer.txt	Sun Feb 20 18:25:47 2011 +0100
     1.2 +++ b/doc/developer.txt	Sun Feb 20 19:29:49 2011 +0100
     1.3 @@ -61,9 +61,7 @@
     1.4  Cooklists - Liste de cuisson
     1.5  ----------------------------
     1.6  Pour compiler plusieurs paquets en une seule commande, on peut utiliser des 
     1.7 -listes de cuisson. Il y a des listes exemples dans le r�pertoire examples/
     1.8 -de cette archive et dans le r�pertoire /usr/share/examples/tazwok/cooklists
     1.9 -sur SliTaz.
    1.10 +listes de cuisson. Voir le manuel, commande cooklist.
    1.11  
    1.12  
    1.13  Structure d'un paquet dans le wok - $WOK/$PACKAGE/*

     2.1 --- a/doc/tazwok.html	Sun Feb 20 18:25:47 2011 +0100
     2.2 +++ b/doc/tazwok.html	Sun Feb 20 19:29:49 2011 +0100
     2.3 @@ -6,7 +6,7 @@
     2.4  	<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
     2.5  	<meta name="description" content="" />
     2.6  	<meta name="expires" content="never" />
     2.7 -	<meta name="modified" content="2008-02-06 15:05:00" />
     2.8 +	<meta name="modified" content="2011-02-10 18:00:00" />
     2.9  	<style type="text/css"><!--
    2.10  	body { font: 90% sans-serif, vernada, arial; margin: 0; }
    2.11  	#header { background: #f0ba08; color: black; height: 50px;
    2.12 @@ -23,7 +23,7 @@
    2.13  </head>
    2.14  <body bgcolor="#ffffff">
    2.15  <div id="header">
    2.16 -<h1><font color="#3e1220">Tazwok Manual</font></h1>
    2.17 +<h1><font color="#3e1220">Tazwok Manual</h1>
    2.18  </div>
    2.19  <hr />
    2.20  <!-- Start content -->
    2.21 @@ -31,40 +31,81 @@
    2.22  
    2.23  <h2>NOM</h2>
    2.24  <p>
    2.25 -Tazwok - SliTaz sources and packages cooker.
    2.26 +Tazwok - Outils SliTaz pour compiler les sources et pr�parer les paquets.
    2.27  </p>
    2.28  
    2.29  <h2>SYNTAXE</h2>
    2.30  <pre>
    2.31 - tazwok [command] [package|list|category|dir] [--option]
    2.32 + tazwok [command] [package|list|category|dir|arg] [--option]
    2.33  </pre>
    2.34  
    2.35 +<h2>AVERTISSEMENT</h2>
    2.36 +<p>
    2.37 +Cette version de tazwok (tazwok-experimental) est actuellement sujette
    2.38 +� un d�veloppement actif et certaine parties de programme n'ont pas
    2.39 +encore �t� compl�tement revues et corrig�es. Dans son �tat actuel,
    2.40 +vous ne devriez cependant pas rencontrer de probl�me majeur durant son
    2.41 +utilisation. Toutes suggestions/commentaires/contribution sont les
    2.42 +bienvenues: vous trouverez l'adresse courriel du mainteneur � la fin
    2.43 +de ce document.
    2.44 +
    2.45  <h2>DESCRIPTION</h2>
    2.46  <p>
    2.47  Tazwok est un outil en ligne de commande permettant de configurer et de
    2.48  compiler un paquet depuis les sources. Tazwok permet aussi de cr�er des
    2.49 -paquets pr�ts � �tre utilis� par Tazpkg, le gestionnaire de paquets cr�er
    2.50 -pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette
    2.51 -et toutes les informations n�cessaires � la construction du paquet, cette
    2.52 +paquets pr�ts � �tre utilis� par Tazpkg, le gestionnaire de paquets cr��
    2.53 +pour SliTaz. Pour fonctionner, Tazwok utilise un fichier contenant la recette
    2.54 +et toutes les informations n�cessaires � la construction du paquet. Cette
    2.55  recette est aussi utilis�e par Tazpkg et se compose de diff�rentes variables
    2.56 -et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf)
    2.57 +et fonctions. Tazwok utilise un fichier de configuration (/etc/slitaz/tazwok.conf)
    2.58  pour conna�tre le chemin vers le wok, les paquets sources et les paquets
    2.59  (.tazpkg) g�n�r�s. Il est aussi capable de g�n�rer une liste paquets avec
    2.60  leurs sommes md5, des cr�er un nouveau paquet de mani�re interactive, de faire
    2.61  une recherche, de nettoyer les fichiers g�n�r�s ou encore de cuire plusieurs
    2.62 -paquets en une seule fois (Voir les commandes disponibles).
    2.63 +paquets en une seule fois (Voir les commandes disponibles). Tazwok peut �tre
    2.64 +utilis� pour recompiler SliTaz enti�rement depuis les sources.
    2.65  </p>
    2.66  <p>
    2.67  Tazwok est �crit en script shell depuis rien (from scratch), compatible Bash,
    2.68  et fonctionnant avec Ash du projet Busybox. Tazwok est distribu� sous licence
    2.69 -libre GNU gpl v3. Les recettes avec leures commandes sont bas�es sur le livre
    2.70 -de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet
    2.71 +libre GNU gpl v3. Les recettes avec leurs commandes sont bas�es sur le livre
    2.72 +de cuisine de SliTaz (le Cookbook) qui fournit aussi de la documentation au sujet
    2.73  de Tazwok et du d�veloppement de SliTaz.
    2.74  </p>
    2.75  
    2.76 +<h2>OPTIONS G�N�RALES</h2>
    2.77 +<p>
    2.78 +Trois options peuvent �tre utilis�es avec presques toutes les
    2.79 +commandes de tazwok. Elles permettent de d�finir le d�p�t auquel
    2.80 +appliquer la commande, c'est � dire le dossier contenant les
    2.81 +sous-dossiers clean-wok, wok, packages, packages-incoming, src, log,
    2.82 +�ventuellement chroot. Il s'agit de :
    2.83 +<em>SLITAZ_DIR</em>: le r�pertoire dans lequel se situent les d�p�ts
    2.84 +(par d�faut: /home/slitaz tel que d�finit dans
    2.85 +/etc/slitaz/slitaz.conf)
    2.86 +<em>SLITAZ_VERSION</em>: nom de la version de r�f�rence, par exemple stable,
    2.87 +cooking, ... (par d�fault: la version que vous utilisez telle que d�finit dans
    2.88 +/etc/slitaz-release)
    2.89 +<em>undigest</em>: Indique l'utilisation d'un d�p�t secondaire, pour lequel
    2.90 +SLITAZ_VERSION est la r�f�rence.
    2.91 +</p>
    2.92 +<p>
    2.93 +En l'absence de l'option undigest, l'adresse du d�p�t utilis� sera
    2.94 +$SLITAZ_DIR/$SLITAZ_VERSION (par exemple ce sera /home/slitaz/cooking par
    2.95 +d�faut si vous utilisez cooking) Si l'option undigest est pr�sente, ce sera
    2.96 +$SLITAZ_DIR/$undigest L'option undigest a son importance pour certaines
    2.97 +commandes (par exemple configure-chroot, build-depends, etc.), lorsque les
    2.98 +paquets manquants dans le d�p�t secondaire, ou les informations les
    2.99 +concernant, doivent �tre trouv�es dans le d�p�t de r�f�rence. Dans d'autre cas
   2.100 +l'utilisation d'undigest ou de SLITAZ_VERSION donne le m�me r�sultat.
   2.101 +</p>
   2.102 +<pre>
   2.103 + #tazwok build-depends linux --SLITAZ_DIR=/home/pas-slitaz --SLITAZ_VERSION=cooking --undigest=undigest
   2.104 +</pre>
   2.105 +
   2.106  <h2>COMMANDES</h2>
   2.107  <a name="usage"></a>
   2.108 -<h3><font color="#6c0023">usage</font></h3>
   2.109 +<h3><font color="#6c0023">usage</h3>
   2.110  <p>
   2.111  La commande 'usage' affiche la liste des commandes diponibles avec une petite
   2.112  description en English :
   2.113 @@ -73,7 +114,7 @@
   2.114   # tazwok usage
   2.115  </pre>
   2.116  <a name="stats"></a>
   2.117 -<h3><font color="#6c0023">stats</font></h3>
   2.118 +<h3><font color="#6c0023">stats</h3>
   2.119  <p>
   2.120  Stats affiche les informations contenues dans le fichier de configuration et
   2.121  le nombre de paquets disponibles dans le wok :
   2.122 @@ -82,7 +123,7 @@
   2.123   # tazwok stats
   2.124  </pre>
   2.125  <a name="list"></a>
   2.126 -<h3><font color="#6c0023">list</font></h3>
   2.127 +<h3><font color="#6c0023">list</h3>
   2.128  <p>
   2.129  La commande 'list' permet de lister l'ensemble des paquets contenus dans le
   2.130  wok ou de lister les cat�gories par d�faut (vous pouvez cr�er la votre). Elle
   2.131 @@ -93,17 +134,17 @@
   2.132   # tazwok list category
   2.133  </pre>
   2.134  <a name="info"></a>
   2.135 -<h3><font color="#6c0023">info</font></h3>
   2.136 +<h3><font color="#6c0023">info</h3>
   2.137  <p>
   2.138  Cette commande donne des informations sur le paquet, nom, version, etc. Info
   2.139 -ce base sur la recette du paquet pour conna�tre les informations, se sont les
   2.140 +se base sur la recette du paquet pour conna�tre les informations, se sont les
   2.141  m�mes infos affich�es par Tazpkg et les paquets install�s :
   2.142  </p>
   2.143  <pre>
   2.144   # tazwok info package
   2.145  </pre>
   2.146  <a name="check-log"></a>
   2.147 -<h3><font color="#6c0023">check-log</font></h3>
   2.148 +<h3><font color="#6c0023">check-log</h3>
   2.149  <p>
   2.150  Lors de la compilation et g�n�ration du paquet binaire, Tazwok g�n�re quelques
   2.151  messages de log stock�s dans un fichier 'process.log'. Pour les afficher :
   2.152 @@ -112,7 +153,7 @@
   2.153   # tazwok check-log package
   2.154  </pre>
   2.155  <a name="search"></a>
   2.156 -<h3><font color="#6c0023">search</font></h3>
   2.157 +<h3><font color="#6c0023">search</h3>
   2.158  <p>
   2.159  Search permet de faire une recherche de paquet dans le wok. Vous pouvez
   2.160  sp�cifier un terme ou un nom de paquet :
   2.161 @@ -121,7 +162,7 @@
   2.162   # tazwok search name
   2.163  </pre>
   2.164  <a name="compile"></a>
   2.165 -<h3><font color="#6c0023">compile</font></h3>
   2.166 +<h3><font color="#6c0023">compile</h3>
   2.167  <p>
   2.168  Compile va compiler. Cette commande utilise les r�gles de compilation
   2.169  (compile_rules) sp�cifi�es dans la recette du paquet en question, pour
   2.170 @@ -134,55 +175,123 @@
   2.171   # tazwok compile package
   2.172  </pre>
   2.173  <a name="genpkg"></a>
   2.174 -<h3><font color="#6c0023">genpkg</font></h3>
   2.175 +<h3><font color="#6c0023">genpkg</h3>
   2.176  <p>
   2.177  Genpkg pour <em>Generate package</em>, va g�n�rer le paquet (.tazpkg) en
   2.178  utilisant la fonction 'genpkg_rules' trouv�e dans sa recette et compresser
   2.179 -les fichiers. Une fois le paquet g�n�r�,  il est stock� dans le repositoire
   2.180 -des paquets sp�cifi� dans le fichier de configuration ('tazwok stats' pour
   2.181 -afficher la configuration courante). Le paquet peut ensuite facilement
   2.182 -s'installer via Tazpkg ou �tre utilis� par Tazlito pour g�n�rer une
   2.183 -distribution LiveCD automatiquement. A noter que les fichiers standards tels
   2.184 -que les locales, le pixmap ou le fichier.desktop sont automatiquement copi�s
   2.185 -dans $fs/usr/share, si les chemins sont standards ou si le fichier existe dans
   2.186 -/stuff. Utilisation de 'genpkg' :
   2.187 +les fichiers. Une fois le paquet g�n�r�,  il est stock� dans le d�p�t
   2.188 +des paquets temporaire (PACKAGES_INCOMING) sp�cifi� dans le fichier de
   2.189 +configuration ('tazwok stats' pour afficher la configuration courante). Le
   2.190 +paquet peut �tre d�plac�  vers le d�p�t de paquets d�finitif avec 'check-incoming'.
   2.191 +Le paquet peut ensuite facilement s'installer via Tazpkg ou �tre utilis� par Tazlito
   2.192 +pour g�n�rer une distribution LiveCD automatiquement. A noter que les fichiers
   2.193 +standards tels que les locales, le pixmap ou le fichier.desktop sont
   2.194 +automatiquement copi�s dans $fs/usr/share, si les chemins sont standards ou
   2.195 +si le fichier existe dans /stuff. Utilisation de 'genpkg' :
   2.196  </p>
   2.197  <pre>
   2.198   # tazwok genpkg package
   2.199  </pre>
   2.200  <a name="cook"></a>
   2.201 -<h3><font color="#6c0023">cook</font></h3>
   2.202 +<h3><font color="#6c0023">cook</h3>
   2.203  <p>
   2.204 -Cook va simplement compiler et empaqueter les paquet en une seule fois :
   2.205 +Cook va simplement compiler et empaqueter le paquet en une seule fois :
   2.206  </p>
   2.207  <pre>
   2.208   # tazwok cook package
   2.209  </pre>
   2.210  <a name="cook-list"></a>
   2.211 -<h3><font color="#6c0023">cook-list</font></h3>
   2.212 +<h3>cook-list</h3>
   2.213  <p>
   2.214  Cette commande va lancer 'tazwok cook' sur tous les paquets contenus dans la
   2.215 -liste sp�cifi�e en argument. Cook-list est utilis�e par exemple, pour cuire
   2.216 -le syst�me de base, les applications de base, le syst�me X, etc. Avant de
   2.217 -lancer cette commande avec un grand nombre de paquets, il est conseill� de
   2.218 -cuire une fois le syst�me de base (base-system) sans la glibc. Sur SliTaz,
   2.219 -vous trouverez des exemples de liste de cuisson (cooklist) dans le r�pertoire
   2.220 -des exemples /usr/share/examples/tazwok/cooklists :
   2.221 +liste sp�cifi�e en argument, ainsi que leurs d�pendances de cuisson si elles
   2.222 +sont manquantes ou ont besoin d'une mise � jour. Cook-list est utilis�e par
   2.223 +exemple, pour cuire le syst�me de base, les applications de base, le syst�me
   2.224 +X, les paquets d'une saveur, etc. Cooklist peut aussi �tre utilis� sur une
   2.225 +seul paquet gr�ve � l'option --pkg. L'option --forced peut �tre utilis�e pour
   2.226 +recuire l'ensemble des d�pendances de cuisson n�c�ssaires, m�me si elles sont
   2.227 +d�j� disponible et � jour, exept� la cha�ne d'outils (voir
   2.228 +SLITAZ_CORE_TOOLCHAIN dans /etc/slitaz/tazwok.conf) Sans argument, cook-list
   2.229 +utilise la liste de cuisson par d�fault, situ�e dans le dossier 'package'
   2.230  </p>
   2.231  <pre>
   2.232 - # tazwok cook-list packages.cooklist
   2.233 + # tazwok cook-list
   2.234 + # tazwok cook-list packages.cooklist --forced
   2.235 + # tazwok cook-list --pkg=firefox
   2.236 +</pre>
   2.237 +<p>
   2.238 +<a name="cook-commit"></a>
   2.239 +<h3>cook-commit</h3>
   2.240 +<p>
   2.241 +La commande 'cook-commit' cherche les paquets dont les
   2.242 +recettes/stuff/descriptions ont �t� modifi�s et les met � jour en utilisant
   2.243 +cook. La recherche de changements utilise les donn�es md5 (identification en
   2.244 +mesurant diff�rentes caract�ristiques des fichiers) des �l�ments utilis�s lors
   2.245 +de la pr�c�dente cuisson des paquets. Ces informations sont conserv�s dans le
   2.246 +wok, si elles sont absentes elles sont obtenus depuis les paquets d�j�
   2.247 +pr�par�s. L'option --forced oblige check-commit � utiliser les donn�es md5
   2.248 +depuis les paquets, ce qui est utile pour r�cup�rer des information coh�rentes
   2.249 +si vous aviez modifi� les listes commit/cooklist manuellement (cas rare). Par
   2.250 +d�faut, check-commit ne cible que les paquets qui sont d�j� pr�sents dans les
   2.251 +d�p�ts de paquets. L'option --missing permet de scanner la totalit� du wok, et
   2.252 +d'ajouter tous les paquets qui n'ont pas encore �t� cuits � la liste.
   2.253 +</p>
   2.254 +<pre>
   2.255 + # tazwok cook-commit # Cuit les paquets qui ont besoin d'une mise � jour
   2.256 + # tazwok cook-commit --forced # Idem, en corrigeant d'�ventuelles incoh�rence dans les donn�es
   2.257 + # tazwok cook-commit --missing # Cuit les paquets qui ont besoin d'une mise � jour + les paquets manquants.
   2.258 + # tazwok cook-commit --missing --forced
   2.259 +</pre>
   2.260 +<a name="cook-all"></a>
   2.261 +<h3>cook-all</h3>
   2.262 +<p>
   2.263 +Le commande 'cook-all' permet de recuire tous des paquets du wok. Sans
   2.264 +options, elle est identique � cook-commit: recuit seulement les
   2.265 +paquets dont les receipts/description.txt/stuffs ont �t�
   2.266 +modifi�s. L'option --missing a �galement le m�me effet que dans
   2.267 +cook-commit: ajoute tous les paquets qui n'ont pas encore �t�
   2.268 +pr�par�s. La diff�rence se situe dans l'option --forced: ici, elle
   2.269 +signifie recuire l'ensemble des paquets, m�me s'ils n'ont pas �t� mis
   2.270 +� jour depuis la derni�re cuisson. Comme expliqu� ci-dessous, le coeur
   2.271 +de la cha�ne d'outils ne sera jamais recuite par cette commande.
   2.272 +</p>
   2.273 +<pre>
   2.274 + # tazwok cook-all # identique � tazwok cook-commit
   2.275 + # tazwok cook-all --missing # identique � tazwok cook-commit --missing
   2.276 + # tazwok cook-all --forced # recuit tous les paquets d�j� existant dans votre d�p�t, except� le coeur de la cha�ne d'outils
   2.277 + # tazwok cook-all --forced --missing # Recuit tous les paquets du wok, except� le coeur de la cha�ne d'outils
   2.278 +</pre>
   2.279 +<a name="cook-toolchain"></a>
   2.280 +<p>
   2.281 +Cook-toolchain est la commande d�di�e � la cuisson des paquets qui permettent
   2.282 +la pr�parations de tous les autres. En effet, les paquets au coeur de la
   2.283 +cha�ne d'outils (pour SliTaz linux-api-headers/glibc/binutils/gcc) ne
   2.284 +peuvent/doivent pas �tre cuits autrement dans SliTaz. Le processus de
   2.285 +pr�paration de la cha�ne d'outils est particulier, et utilise le script
   2.286 +'cook-toolchain' de 'tazchroot'. La m�thode employ�e est une adaptation de
   2.287 +celle pr�sent�e dans le livre <i lang="us">Linux From Scratch</i>: une
   2.288 +premi�re cha�ne d'outils temporaire et sans lien avec le mat�riel/syst�me
   2.289 +utilis� est pr�par�e, puis sert � la cuisson des paquets de la "verritable"
   2.290 +cha�ne d'outils. Il est � noter que cette op�ration est assez longue
   2.291 +(plusieurs heures � plusieurs dizaines d'heures selon le mat�riel
   2.292 +utilis�). C'est la premi�re �tape � r�aliser pour compiler SliTaz enti�rement
   2.293 +depuis les sources.
   2.294 +</p>
   2.295 +<pre>
   2.296 + # tazwok cook-toolchain
   2.297  </pre>
   2.298  <a name="clean"></a>
   2.299 -<h3><font color="#6c0023">clean</font></h3>
   2.300 +<h3>clean</h3>
   2.301  <p>
   2.302  Clean permet simplement de supprimer tous les fichiers g�n�r�s par la
   2.303 -compilation et l'empaquetage, pour recommencer � cuire (cook) :
   2.304 +compilation et l'empaquetage. Les diff�rentes commandes 'cook' l'utilisent
   2.305 +automatiquement:
   2.306  </p>
   2.307  <pre>
   2.308   # tazwok clean package
   2.309  </pre>
   2.310  <a name="new-tree"></a>
   2.311 -<h3><font color="#6c0023">new-tree</font></h3>
   2.312 +<h3>new-tree</h3>
   2.313  <p>
   2.314  La commande 'new-tree' permet de cr�er un nouveau paquet dans le wok et
   2.315  peut s'utiliser de mani�re interactive. New-tree va cr�er le r�pertoire du
   2.316 @@ -196,29 +305,58 @@
   2.317   # tazwok new-tree package --interactive
   2.318  </pre>
   2.319  <a name="gen-list"></a>
   2.320 -<h3><font color="#6c0023">gen-list</font></h3>
   2.321 +<h3>gen-list</h3>
   2.322  <p>
   2.323  La commande 'gen-list' permet de g�n�rer une liste de paquets (packages.list),
   2.324 -leurs sommes md5 (packages.md5) et en option une liste de paquets contenant plus
   2.325 -d'informations (packages.txt). Les simples listes sont cr��es en se basant sur
   2.326 -les paquets contenus dans un r�pertoire. La liste au format texte est construite
   2.327 -avec les recettes contenues dans un wok. Le r�pertoire des paquets par d�faut
   2.328 -est celui sp�cifi� dans le fichier de configuration, vous avez aussi la
   2.329 -possibilit� de sp�cifier le r�pertoire � utiliser sur la ligne de commande.
   2.330 -Utilisation de la commande 'gen-list' :
   2.331 +leurs sommes md5 (packages.md5) et une liste de paquets contenant plus
   2.332 +d'informations (packages.txt). Les listes sont cr��es en se basant sur les
   2.333 +paquets contenus dans un r�pertoire. Vous avez la possibilit� de sp�cifier le
   2.334 +r�pertoire � utiliser sur la ligne de commande. Si vous ne le faites pas, les
   2.335 +deux d�p�ts de paquets (permanent 'packages' et temporaire
   2.336 +'packages-incoming') seront cibl�s. Dans la plupart des cas, 'check-list'
   2.337 +remplit la m�me fonction plus rapidement, donc 'gen-list' n'est r�ellement
   2.338 +utile qu'en cas de corruption des fichiers. Utilisation de la commande
   2.339 +'gen-list' :
   2.340  </p>
   2.341  <pre>
   2.342   # tazwok gen-list
   2.343 - # tazwok gen-list --text
   2.344   # tazwok gen-list /path/to/repository
   2.345  </pre>
   2.346 +<a name="check-list"></a>
   2.347 +<h3>check-list</h3>
   2.348 +<p>
   2.349 +La commande 'check-list' remplit la m�me fonction que 'gen-list', mais elle
   2.350 +recherche les paquets dont les informations doivent �tre mises � jour. Pour
   2.351 +cette raison elle est g�n�ralement plus rapide, en particulier quand peu de
   2.352 +paquets ont �t� modifi�s. Les commandes cook l'utilisent
   2.353 +automatiquement. Comme pour 'gen-list', si vous ne pr�cisez pas de cible,
   2.354 +'packages' et 'packages-incoming' seront tout deux mise � jour.
   2.355 +</p>
   2.356 +<pre>
   2.357 + # tazwok check-list
   2.358 + # tazwok check-list /path/to/repository
   2.359 +</pre>
   2.360 +<a name="gen-wok-db"></a>
   2.361 +<h3>gen-wok-db</h3>
   2.362 +<p>
   2.363 +'wok-db' d�signe des fichiers utilis�s pour obtenir rapidement les
   2.364 +relations de d�pendance entre les recettes. Ces informations sont
   2.365 +g�n�ralement ajout�es chaque fois que n�c�ssaire, et automatiquement,
   2.366 +par tazwok. 'gen-wok-db' sert � les r�-g�nerer en cas de corruption
   2.367 +des fichiers (ex: vous avez tu� tazwok pendant qu'il g�n�rait
   2.368 +automatiquement ces fichiers).
   2.369 +</p>
   2.370 +<pre>
   2.371 + # tazwok gen-wok-db
   2.372 +</pre>
   2.373  <a name="gen-clean-wok"></a>
   2.374 -<h3><font color="#6c0023">gen-clean-wok et clean-wok</font></h3>
   2.375 +<h3>gen-clean-wok et clean-wok</h3>
   2.376  <p>
   2.377 -courant. Cette commande est utile pour sauvegarder une version du wok ou copier
   2.378 -un wok pour tester avec un autre. Quant � la commande 'clean-wok', elle va
   2.379 -un wok pour tester avec un autre. Quand � la commande 'clean-wok', elle va
   2.380 -nettoyer tous les paquets du wok courant et supprimer tous les fichiers
   2.381 +La commande 'gen-clean-wok' produit une copie du wok courant, sans les
   2.382 +fichiers li�s � la compilation des paquets. Cette commande est utile
   2.383 +pour sauvegarder une version du wok ou copier un wok pour tester avec
   2.384 +un autre. Quand � la commande 'clean-wok', elle va nettoyer tous
   2.385 +les paquets du wok courant et supprimer tous les fichiers
   2.386  g�n�r�s. Pour r�cup�rer un wok propre ou nettoyer le wok actuel :
   2.387  </p>
   2.388  <pre>
   2.389 @@ -226,7 +364,7 @@
   2.390   # tazwok clean-wok
   2.391  </pre>
   2.392  <a name="remove"></a>
   2.393 -<h3><font color="#6c0023">remove</font></h3>
   2.394 +<h3>remove</h3>
   2.395  <p>
   2.396  Supprime le paquet sp�cifi� du wok, avec tous les fichiers, stuff et recette
   2.397  y compris :
   2.398 @@ -235,37 +373,77 @@
   2.399   # tazwok remove package
   2.400  </pre>
   2.401  <a name="build-depends"></a>
   2.402 -<h3><font color="#6c0023">build-depends</font></h3>
   2.403 +<h3>build-depends</h3>
   2.404  <p>
   2.405 -Build-depends g�n�re une liste de paquets n�cessaires pour compiler le wok :
   2.406 +Build-depends g�n�re une liste de paquets n�cessaires pour compiler le
   2.407 +wok. Avec un paquet en argument, elle affiche la liste compl�te des
   2.408 +d�pendances de cuisson de ce paquet.
   2.409  </p>
   2.410  <pre>
   2.411   # tazwok build-depends
   2.412 + # tazwok build-depends midori
   2.413  </pre>
   2.414 -<a name="cmp"></a>
   2.415 -<h3><font color="#6c0023">cmp|compare</font></h3>
   2.416 +<a name="check-commit"></a>
   2.417 +<h3>check-commit</h3>
   2.418  <p>
   2.419 -Compare le wok avec les paquets d�j� cuits et g�n�re un rapport.
   2.420 -Les paquets obsol�tes peuvent �tre effac�s avec l'option --remove.
   2.421 -Les paquets � compiler peuvent l'�tre avec l'option --cook.
   2.422 +'check-commit' scanne le wok pour trouver les recettes qui ont �t� modifi�e et
   2.423 +les ajoute � la cooklist par d�fault. Les options --forced et --missing jouent
   2.424 +ici le m�me r�le que pour cook-commit.
   2.425  </p>
   2.426  <pre>
   2.427 - # tazwok compare
   2.428 - # tazwok compare --remove
   2.429 - # tazwok compare --cook
   2.430 + # tazwok check-commit
   2.431 + # tazwok check-commit --forced
   2.432 + # tazwok check-commit --missing
   2.433  </pre>
   2.434  <a name="check"></a>
   2.435 -<h3><font color="#6c0023">check</font></h3>
   2.436 +<h3>check</h3>
   2.437  <p>
   2.438  Recherche les erreurs courantes dans les receipts :
   2.439  </p>
   2.440  <pre>
   2.441   # tazwok check
   2.442  </pre>
   2.443 +<a name="update-wok"></a>
   2.444 +<h3>update-wok</h3>
   2.445 +<p>
   2.446 +'update-wok' t�l�charge ou met � jour le wok contenu dans le dossier
   2.447 +clean-wok du d�p�t. Ensuite, il copie les �l�ments nouveaux dans le
   2.448 +wok de cuisson (dossier wok) et retirer ceux qui n'existent plus dans
   2.449 +la nouvelle version. Les adresses et la m�thode (tarball ou hg)
   2.450 +utilis�e par cette commande sont d�finie dans tazwok.conf. L'option
   2.451 +--local permet d'effectuer seulement la seconde op�ration (copie des
   2.452 +fichiers dans le wok). Cela est utile si vous avez apport� des
   2.453 +modifications locales dans le clean-wok et voulez les ajouter � votre
   2.454 +wok de cuisson. Ceci est praticuli�rement pratique pour les
   2.455 +utilisateurs de mercurial (hg), puisque cet outils est beaucoup plus
   2.456 +rapide avec un wok qui ne contient aucun fichiers li�s � la
   2.457 +compilation. Dans ce cas, effectuer les modifications dans le
   2.458 +clean-wok puis: tazwok update-wok --local.
   2.459 +</p>
   2.460 +<pre>
   2.461 + # tazwok update-wok
   2.462 + # tazwok update-wok --local
   2.463 +</pre>
   2.464 +<a name="webserver"></a>
   2.465 +<p>
   2.466 +<h3>webserver</h3> 'webserver' est la commande qui permet de cr�er une
   2.467 +interface php qui informe sur l'�tats des d�p�ts. Plusieurs d�p�ts
   2.468 +peuvent �tre ajout�s/retir�s en utilisant les options
   2.469 +--SLITAZ_VERSION/--undigest. L'argument 'on' permet d'ajouter un d�p�t
   2.470 +� l'interface web, tandis que l'option 'off' le retire (au cas par
   2.471 +cas). En utilisant la configuration par d�faut, l'interface sera
   2.472 +disponible dans votre navigateur � l'adresse
   2.473 +http://localhost/vhosts/bb/. Le paquet 'php' doit �tre install� pour
   2.474 +utiliser cette commande.
   2.475 +</p>
   2.476 +<pre>
   2.477 +# tazwok webserver on
   2.478 +# tazwok webserver off
   2.479 +<pre>
   2.480  
   2.481  <h2>MAINTENEUR</h2>
   2.482  <p>
   2.483 -Christophe Lincoln &lt;pankso at slitaz.org&gt;
   2.484 +Antoine Bodin &lt;gokhlayeh at slitaz.org&gt;
   2.485  </p>
   2.486  
   2.487  <!-- End content -->
author	Antoine Bodin <gokhlayeh@slitaz.org>
date	Sun Feb 20 19:29:49 2011 +0100 (2011-02-20)
parents	9c8e898aac33
children	8ededfb1d957
files	doc/developer.txt doc/tazwok.html