# HG changeset patch # User Pascal Bellard # Date 1265899274 -3600 # Node ID fc71738c7469f142cb29376b6153b7999de3788e # Parent 24352975e3f22c91932d39ba6935854504ad92a1 Fix tazlito manual (thanks Paul) diff -r 24352975e3f2 -r fc71738c7469 en/doc/manuals/tazlito.en.html --- a/en/doc/manuals/tazlito.en.html Wed Feb 10 15:47:30 2010 +0100 +++ b/en/doc/manuals/tazlito.en.html Thu Feb 11 15:41:14 2010 +0100 @@ -190,8 +190,8 @@
upgrade-flavor

-The `upgrade-flavor' updates a flavor built for an old Slitaz version. -It updates the package list with the latest version available. +The `upgrade-flavor' command refreshes a flavor file by updating the +list of packages with the latest versions available:
  # tazlito upgrade-flavor this-flavor
@@ -200,60 +200,10 @@
 
 extract-flavor
 
-The `extract-flavor' converts a flavor to a file tree in /home/slitaz/flavors/.
-This tree may be store by Mercurial in 
+The 'extract-flavor' command converts a flavor into an easily modifiable
+tree structure in /home/slitaz/flavors which can be managed with
+mercurial:
 http://hg.slitaz.org/flavors.
-The file tree is:
-

-
-The file receipt discribes the flavor with the variables:
-  
-  
-FLAVOR: the flavor name.
-  
-  
-SHORT_DESC: a one line description.
-  
-  
-VERSION: free format.
-  
-  
-MAINTAINER: email address.
-  
-  
-FRUGAL_RAM: minimum RAM size. Optionnal, may be guessed.
-  
-  
-ROOTFS_SIZE: unpacked rootfs.gz size in RAM. Optionnal, may be guessed.
-  
-  
-INITRAMFS_SIZE: rootfs.gz size in CD-ROM. Optionnal, may be guessed.
-  
-  
-ISO_SIZE: CD-ROM size. Optionnal, may be guessed.
-  
-  
-ROOTFS_SELECTION: Optionnal, see Meta flavor below.
-  
-  
-
-
-The file packages.list containts the package name list without
-version (tazlito will use the last available version for each package).
-This file is missing if ROOTFS_SELECTION is set in receipt.
-

-The optional file mirrors containts the undigest mirror list
-to be able to use personnal packages.
-
-
-The optional directory rootfs stores the file tree to add to the
-root filesystem rootfs.gz. Usually configuration files.
-
-
-The optional directory rootcd stores the file tree to add to the
-root of the CD-ROM.
-
-
 
   # tazlito extract-flavor this-flavor
@@ -262,8 +212,8 @@
 
 pack-flavor
 
-The `pack-flavor' converts a file tree in /home/slitaz/flavors/ to a 
-flavor (.flavor):  The reverse of `extract-flavor'.
+The 'pack-flavor' command converts a tree structure in /home/slitaz/flavors
+ into a flavor file (.flavor). It is inverse of 'tazlito extract-flavor':
 
   # tazlito pack-flavor this-flavor
@@ -359,8 +309,8 @@
 
 check-list
 
-Check whether distro-packages.list is up to date with latest packages
-version.
+Checks if the distro-packages.list is updated with the latest package
+versions.
 
   # tazlito check-list
@@ -369,7 +319,7 @@
 
 repack
 
-Recompress the rootfs(es) with the best compression ratio.
+Recompresses the rootfs with the best possible compression:
 
   # tazlito repack slitaz.iso
@@ -378,10 +328,10 @@
 
 merge
 
-Add several flavors in a CD-ROM. They are nested like russian dolls.
-Each rootfs is a subset of the precedent. The first rootfs comes from the
-iso in the 2nd parameter. The booting flavor will be chosen according to
-the detected RAM size.
+Combines several flavors like nested Russian dolls. Each rootfs is a
+subset of the previous. The first rootfs is extracted from the ISO image
+used in the third argument. The flavor will then be chosen to launch at 
+startup according to the amount of RAM available:
 
   # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
@@ -392,7 +342,7 @@
 
 The emu-iso command uses the Qemu emulator to start and run SliTaz.
 Qemu is used to test the newly built ISO image without burning to a
-cdrom or booting into frugal mode. 
+cdrom or booting into frugal mode:
 
   # tazlito emu-iso
@@ -415,14 +365,14 @@
 
 FLAVORS
 
-The .flavors files hold all necessary informations in few Kb to build a
-customized SliTaz live CD.
+A .flavor file contains just a few KB of information needed to 
+(re)manufacture a custom LiveCD of SliTaz.
 
 
 
-Rebuild a flavor
+Manufacture a flavor
 
-We choose the flavor to build.
+You can choose the flavor to (re)manufacture from among those available:
 
  # tazlito list-flavors
@@ -438,8 +388,8 @@
 justX             16.1M  51.2M  SliTaz with a minimal X environnement
 
 
-We will rebuild the eeepc flavor. The root filesystem need 105.4M of RAM and
-then CD-ROM size is 31.2M.
+We will start by remanufacturing the eeepc flavor which uses 105.4M of RAM 
+and has a CD-ROM size of 31.2M.
 
  # tazlito clean-distro
@@ -450,37 +400,86 @@
 
 Create a flavor
 
-To create a flavor, you must :
+To create a flavor, you must:
 
 
-
-Either create an ISO image with tazlito gen-distro and create the
-flavor file with tazlito gen-flavor.
-
-
-Or create the file tree to define the flavor (see tazlito extract-flavor)
-and create the flavor file with tazlito pack-flavor.
-
+	Either create an ISO image with tazlito gen-distro and then create
+	a flavor file with tazlito gen-flavor
+	Either directly create the tree structure that defines the flavor
+	(see tazlito extract-flavor) and then create the flavor with
+	tazlito pack-flavor
 
 
 
-Publish a flavor
+Post a flavor
 
-The .flavor file are generaly few kilobytes long. They can be sent on Slitaz
+Because a .flavor file contains just a few KB; it can be easily sent via the
 mailing list.
 
 
-The result of tazlito extract-flavor can be stored in mercurial
-(http://repos.slitaz.org/flavors).
-This is the recommended method because
-the file tree can be checked with mercurial web interface.
+The results of tazlito extract flavor can also be put in mercurial
+(http://repos.slitaz.org/flavors). This method is preferred because the
+tree will be directly visible with the mercurial web interface.
+
+
+This tree includes:
+

+
+A receipt file discribing the flavor thanks to the variables:
+  
+  
+FLAVOR: The flavor name.
+  
+  
+SHORT_DESC: Short description.
+  
+  
+VERSION: Free format.
+  
+  
+MAINTAINER: Email address of maintainer.
+  
+  
+FRUGAL_RAM: Minimum RAM required (optionnal).
+  
+  
+ROOTFS_SIZE: Size of rootfs.gz decompressed into RAM (optionnal).
+  
+  
+INITRAMFS_SIZE: Size of rootfs.gz on the CD-ROM (optionnal).
+  
+  
+ISO_SIZE: Size of CD-ROM (optionnal).
+  
+  
+ROOTFS_SELECTION: Optionnal, see Meta flavor below.
+  
+  
+
+
+The file packages.list containting the list of packages without
+specifying the version (tazlito uses the lastest available).
+This file is missing if ROOTFS_SELECTION exits in receipt.
+

+The optional mirrors file containing the list of unofficial mirrors
+(undigest) to be added to include personnal packages.
+
+
+The optional directory rootfs containing the tree to add to the
+root filesystem rootfs.gz (configuration files usually).
+
+
+The optional directory rootcd containing the tree to add to the
+root of the CD-ROM.
+
+
 
 
 
-Tune a flavor
+Adapt a flavor
 
-You can modify an existing flavor rather than create one from scratch.
-For example, to tune the eeepc flavor:
+It is often easier to modify an existing flavor than to create one from
+scratch. To adapt the eeepc flavor for example:
 
  # tazpkg get-install mercurial
@@ -490,30 +489,30 @@
 # cp -a eeepc myslitaz
 
 
-The files in myslitaz can be modified, and
+Files in my-slitaz can then be adapted, and
 
  # tazlito pack-flavor myslitaz
 
 
-Will create the new flavor.
+Will simply create the new flavor.
 
 
 
 Meta flavor
 
-A meta flavor hold several flavor nested like russian dolls.
-The booting flavor will be chosen according to the detected RAM size.
-The variable ROOTFS_SELECTION defines then couples (minimum RAM size
-and according flavor), 
-example:
+A meta flavor contains several flavors like nested Russian dolls. The flavor
+will be launched at startup according to the amount of RAM available.
+The ROOTFS_SELECTION variable defines the minimim RAM and corresponding 
+flavor parameters, 
+example:
 
  ROOTFS_SELECTION="160M core 96M justX 32M base"
 
 
-A meta flavor has no packages list (packages.list).
-Slitaz kernels prior version 2.6.30 don't support meta flavors.
+A meta flavor doesn't contain a list of packages (packages.list). SliTaz
+kernels prior to 2.6.30 do not support meta flavors.
 
 
 MAINTAINER
diff -r 24352975e3f2 -r fc71738c7469 fr/doc/manuals/tazlito.html
--- a/fr/doc/manuals/tazlito.html	Wed Feb 10 15:47:30 2010 +0100
+++ b/fr/doc/manuals/tazlito.html	Thu Feb 11 15:41:14 2010 +0100
@@ -215,61 +215,6 @@
 facilement modifiable dans /home/slitaz/flavors/ qui pourra être gérée
 avec Mercurial dans http://hg.slitaz.org/flavors.
 
-
-Cette arborescence comprend :
-
-
-
-Le fichier receipt décrit la saveur grâce aux variables :
-  
-  
-  FLAVOR : le nom de la saveur.
-  
-  
-  SHORT_DESC : la description en une ligne.
-  
-  
-  VERSION : format libre.
-  
-  
-  MAINTAINER : adresse email.
-  
-  
-  FRUGAL_RAM : optionnel (peut être estimé), RAM minimum nécessaire.
-  
-  
-  ROOTFS_SIZE : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
-  
-  
-  INITRAMFS_SIZE : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
-  
-  
-  ISO_SIZE : optionnel (peut être estimé). Taille du CD-ROM.
-  
-  
-  ROOTFS_SELECTION : optionnel, voir Meta saveur plus bas.
-  
-  
-
-
-Le fichier packages.list contenant la liste des paquets sans
-préciser leur version (tazlito utilisera la dernière disponible)
-Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
-
-
-Le fichier optionnel mirrors contenant la liste des miroirs non 
-officiels (undigest) à ajouter pour inclure des paquets personnels.
-
-
-Le répertoire optionnel rootfs contenant l'arborescence à ajouter dans
-le système de fichier racine rootfs.gz (des fichiers de configuration 
-habituellement).
-
-
-Le répertoire optionnel rootcd contenant l'arborescence à ajouter dans
-la racine du CD-ROM.
-
-
   # tazlito extract-flavor une-saveur
 
@@ -389,7 +334,7 @@
 
 Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
 est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
-ISO en 2e paramètre.
+ISO en 3e paramètre.
 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
 disponible.
 
@@ -483,6 +428,61 @@
 (http://repos.slitaz.org/flavors). Cette méthode est préférable car l'arborescence
 sera directement visible avec l'interface web de mercurial.
 
+
+Cette arborescence comprend :
+
+
+
+Le fichier receipt décrit la saveur grâce aux variables :
+  
+  
+  FLAVOR : le nom de la saveur.
+  
+  
+  SHORT_DESC : la description en une ligne.
+  
+  
+  VERSION : format libre.
+  
+  
+  MAINTAINER : adresse email.
+  
+  
+  FRUGAL_RAM : optionnel (peut être estimé), RAM minimum nécessaire.
+  
+  
+  ROOTFS_SIZE : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
+  
+  
+  INITRAMFS_SIZE : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
+  
+  
+  ISO_SIZE : optionnel (peut être estimé). Taille du CD-ROM.
+  
+  
+  ROOTFS_SELECTION : optionnel, voir Meta saveur plus bas.
+  
+  
+
+
+Le fichier packages.list contenant la liste des paquets sans
+préciser leur version (tazlito utilisera la dernière disponible)
+Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
+
+
+Le fichier optionnel mirrors contenant la liste des miroirs non 
+officiels (undigest) à ajouter pour inclure des paquets personnels.
+
+
+Le répertoire optionnel rootfs contenant l'arborescence à ajouter dans
+le système de fichier racine rootfs.gz (des fichiers de configuration 
+habituellement).
+
+
+Le répertoire optionnel rootcd contenant l'arborescence à ajouter dans
+la racine du CD-ROM.
+
+
 
 
 Adapter une saveur