README for Tazwok - SliTaz sources and packages cooker                     2011
===============================================================================


English
-------
Tazwok can compile source packages and create binary packages suitable for
Tazpkg (Tiny autonomous zone package manager). You can build individual
packages or a list of packages with one command, rebuild the full distro,
generate a packages repository and also list and get info about packages.
Please check 'tazwok usage' to get a list of commands with a short
description in English.

Tazwok is a SHell script written from scratch that works with Bash and Ash
from Busybox. Tazwok is licensed under free GNU gpl v3. See INSTALL at the
bottom of this file for installation instructions.


Franais
--------
Tazwok est un outils en ligne de commande permettant de configurer et de
compiler un paquet depuis les sources. Tazwok permet aussi de crer des
paquets prts  tre utilis par Tazpkg, le gestionnaire de paquets crer
pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette
et toutes les informations ncessaires  la construction du paquet, cette
recette est aussi utilise par Tazpkg et se compose de diffrentes variables
et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf)
pour connatre le chemin vers le wok, les paquets sources et les paquets
(.tazpkg) gnrs. Il est aussi capable de gnrer une liste paquets avec
leurs sommes md5, des crer un nouveau paquet de manire interactive, de faire
une recherche, de nettoyer les fichiers gnrs ou encore de cuire plusieurs
paquets en une seule fois (Voir les commandes disponibles).

Tazwok est cript en script shell depuis rien (from scratch), compatible Bash,
et fonctionnant avec Ash du projet Busybox. Tazwok est distribu sous license
libre GNU gpl v3. Les recettes avec leures commades sont base sur le livre
de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet
de Tazwok et du dvellopement de SliTaz.


Documentation et wok
--------------------
La doc au sujet de Tazwok est contenue dans le rpertoire doc de cette archive
ou dans /usr/share/doc/tazwok si Tazwok est install. Pour obtenir un wok sous
forme d'archive et developper, il suffit de lire le document developer.txt et
consulter le livre de cuisine de SliTaz (Cookbook) :

 http://www.slitaz.org/doc/cookbook/


Contenu de l'archive source
---------------------------

 * doc/ : La documentation contenant le manuel au format HTML et TEXT. Le
   rpertoire doc/ contient aussi un document dstines principalement aux
   dveloppeurs (developer.txt).
 * examples/ : Ce rpertoire contient un exemple de fichier de config et
   un script (build-world.sh) permettant de reconstruire le systme depuis une
   liste et d'installer directement les paquets gnrs.
 * examples/cooklists/ : Des listes de paquet  cuire, classs par catgorire
   de paquets. La liste base-system.cooklist contient les paquet utiliss pour
   crer la base du systme racine de SliTaz.
 * tazwok : Le script permettant de compiler des paquets source et de
   gnrer des paquets *.tazpkg.
 * Les fichiers AUTHORS, ChangeLog, COPYING, gpl.txt et ce README.


INSTALL/UNINSTALL Tazwok
------------------------
Vous pouvez utiliser PREFIX= pour installer Tazwok dans un autre rpertoire
que /usr/bin.

 # cd into /tazwok-version
 # make install

Utilisation/Usage :

 # tazwok usage

Dsinstallation avec :

 # make uninstall


===============================================================================
                                                         http://www.slitaz.org/
