tazwok view README @ rev 266

Fix auto-remove old sources; Add some warning messages when default behavior is not used; Add a new COOK_OPT: !repack_src (prevent repacking into tar.lzma); Add support for git/svn/mercurial into WGET_URL (syntax is WGET_URL="mercurial|ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/3.1.7/linux-i686/xpi/ru.xpi"- or git| or subversion| - having the vcs package in BUILD_DEPENDS still needed), add BRANCH variable to optionaly specify a rev/tag/branch to use in this case; add better support for strange http/https/ftp URL: if WGET_URL doesn't contains TARBALL, downloaded file is named TARBALL (i.e.: WGET_URL=".../download?f=xyz&r=132" - in this case use TARBALL="pkg.tar.gz" will make things works and no more hack in receipt is needed); fs variable into genpkg_rules() is now absolute; fix a bug into source_receipt() which can cause downloading the wrong tarball (TARBALL was not unseted); Add clean-src command to remove old/unrelated-to-wok sources tarball; Fix: packages removed from wok are now deleted from repositories and files list, at check-incoming time for the ones into main repository; WARNING WARNING WARNING : this commit comes with an update-repository script which **should** be used on repositories builded with previous version of tazwok-experimental: update logs to make them compatible with new webserver command, move/remove sources and generate sources.list to make source repository consistent with new changes. usage is: update-repository LOCAL_REPOSITORY, i.e.: update-repository /home/slitaz/experimental. Even if don't use it will not leads to major problem, please do it.
author Antoine Bodin <gokhlayeh@slitaz.org>
date Sun Feb 13 23:38:35 2011 +0100 (2011-02-13)
parents ea1f7463d651
children 1ef16dccd750
line source
1 README for Tazwok - SliTaz sources and packages cooker 2009
2 ===============================================================================
3
4
5 English
6 -------
7 Tazwok can compile source packages and create binary packages suitable for
8 Tazpkg (Tiny autonomous zone package manager). You can build individual
9 packages or a list of packages with one command, rebuild the full distro,
10 generate a packages repository and also list and get info about packages.
11 Please check 'tazwok usage' to get a list of commands with a short
12 description in English.
13
14 Tazwok is a SHell script written from scratch that works with Bash and Ash
15 from Busybox. Tazwok is licensed under free GNU gpl v3. See INSTALL at the
16 bottom of this file for installation instructions.
17
18
19 Français
20 --------
21 Tazwok est un outils en ligne de commande permettant de configurer et de
22 compiler un paquet depuis les sources. Tazwok permet aussi de créer des
23 paquets prêts à être utilisé par Tazpkg, le gestionnaire de paquets créer
24 pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette
25 et toutes les informations nécessaires à la construction du paquet, cette
26 recette est aussi utilisée par Tazpkg et se compose de différentes variables
27 et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf)
28 pour connaître le chemin vers le wok, les paquets sources et les paquets
29 (.tazpkg) générés. Il est aussi capable de générer une liste paquets avec
30 leurs sommes md5, des créer un nouveau paquet de manière interactive, de faire
31 une recherche, de nettoyer les fichiers générés ou encore de cuire plusieurs
32 paquets en une seule fois (Voir les commandes disponibles).
33
34 Tazwok est écript en script shell depuis rien (from scratch), compatible Bash,
35 et fonctionnant avec Ash du projet Busybox. Tazwok est distribué sous license
36 libre GNU gpl v3. Les recettes avec leures commades sont basée sur le livre
37 de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet
38 de Tazwok et du dévellopement de SliTaz.
39
40
41 Documentation et wok
42 --------------------
43 La doc au sujet de Tazwok est contenue dans le répertoire doc de cette archive
44 ou dans /usr/share/doc/tazwok si Tazwok est installé. Pour obtenir un wok sous
45 forme d'archive et developper, il suffit de lire le document developer.txt et
46 consulter le livre de cuisine de SliTaz (Cookbook) :
47
48 http://www.slitaz.org/doc/cookbook/
49
50
51 Contenu de l'archive source
52 ---------------------------
53
54 * doc/ : La documentation contenant le manuel au format HTML et TEXT. Le
55 répertoire doc/ contient aussi un document déstinées principalement aux
56 développeurs (developer.txt).
57 * examples/ : Ce répertoire contient un exemple de fichier de config et
58 un script (build-world.sh) permettant de reconstruire le système depuis une
59 liste et d'installer directement les paquets générés.
60 * examples/cooklists/ : Des listes de paquet à cuire, classés par catégorire
61 de paquets. La liste base-system.cooklist contient les paquet utilisés pour
62 créer la base du système racine de SliTaz.
63 * tazwok : Le script permettant de compiler des paquets source et de
64 générer des paquets *.tazpkg.
65 * Les fichiers AUTHORS, ChangeLog, COPYING, gpl.txt et ce README.
66
67
68 INSTALL/UNINSTALL Tazwok
69 ------------------------
70 Vous pouvez utiliser PREFIX= pour installer Tazwok dans un autre répertoire
71 que /usr/bin.
72
73 # cd into /tazwok-version
74 # make install
75
76 Utilisation/Usage :
77
78 # tazwok usage
79
80 Désinstallation avec :
81
82 # make uninstall
83
84
85 ===============================================================================
86 http://www.slitaz.org/