tazlito diff doc/tazlito.en.html @ rev 316
Add: custom_rules function in receipt
author | Eric Joseph-Alexandre <erjo@slitaz.org> |
---|---|
date | Sat Jun 08 19:25:48 2013 +0200 (2013-06-08) |
parents | df6381a368a2 |
children | b3041f9d49ab |
line diff
1.1 --- a/doc/tazlito.en.html Sat May 05 19:14:46 2012 +0200 1.2 +++ b/doc/tazlito.en.html Sat Jun 08 19:25:48 2013 +0200 1.3 @@ -1,378 +1,377 @@ 1.4 <!DOCTYPE html> 1.5 <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> 1.6 <head> 1.7 - <title>TazLito Manual - SliTaz Live Tool</title> 1.8 <meta charset="utf-8" /> 1.9 + <title>TazLito Manual—SliTaz Live Tool</title> 1.10 <link rel="shortcut icon" href="favicon.ico" /> 1.11 - <link rel="stylesheet" type="text/css" href="style.css" /> 1.12 + <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" /> 1.13 + <script type="text/javascript" src="../slitaz-doc.js"></script> 1.14 </head> 1.15 <body> 1.16 1.17 -<!-- Header --> 1.18 -<div id="header"> 1.19 +<header> 1.20 <h1>Tazlito Manual</h1> 1.21 -</div> 1.22 +</header> 1.23 1.24 <!-- Start content --> 1.25 <div id="content"> 1.26 1.27 <h2>NAME</h2> 1.28 -<p> 1.29 -Tazlito - SliTaz Live Tool. 1.30 -</p> 1.31 + 1.32 +<p>Tazlito—SliTaz Live Tool.</p> 1.33 + 1.34 1.35 <h2>SYNTAX</h2> 1.36 + 1.37 <pre> 1.38 tazlito [command] [list|iso|flavor] [dir] 1.39 </pre> 1.40 1.41 + 1.42 <h2>DESCRIPTION</h2> 1.43 -<p> 1.44 -Tazlito is a small utility to extract a LiveCD, rebuild the 1.45 -ISO image and regenerate the root filesystem of the LiveCD. 1.46 -Tazlito can also generate a distribution from a list of packages 1.47 -previously downloaded. To run, Tazlito uses the configuration file 1.48 -/etc/tazlito/tazlito.conf or an easily generated tazlito.conf 1.49 -found in the current directory. 1.50 -It specifies the name of the ISO, volume, maintainer and 1.51 -the paths of the packages to distribute and the generated ISO. 1.52 -Tazlito can also set up a directory containing additional files 1.53 -which will be copied to the LiveCD when generating the distribution. 1.54 -</p> 1.55 -<p> 1.56 -Tazlito is distributed under the free GNU licence GPL V3, 1.57 -installed by default on SliTaz and installed/sucessfully tested 1.58 -on Debian GNU/Linux. You will find additional information 1.59 -about creating a LiveCD in the Handbook. 1.60 -</p> 1.61 + 1.62 +<p>Tazlito is a small utility to extract a LiveCD, rebuild the ISO image and 1.63 +regenerate the root filesystem of the LiveCD. Tazlito can also generate 1.64 +a distribution from a list of packages previously downloaded. To run, Tazlito 1.65 +uses the configuration file <tt>/etc/tazlito/tazlito.conf</tt> or an easily 1.66 +generated <tt>tazlito.conf</tt> found in the current directory. It specifies 1.67 +the name of the ISO, volume, maintainer and the paths of the packages 1.68 +to distribute and the generated ISO. Tazlito can also set up a directory 1.69 +containing additional files which will be copied to the LiveCD when generating 1.70 +the distribution.</p> 1.71 +<p>Tazlito is distributed under the free GNU licence GPL v.3, installed 1.72 +by default on SliTaz and installed/sucessfully tested on Debian GNU/Linux. You 1.73 +will find additional information about creating a LiveCD in the Handbook.</p> 1.74 + 1.75 1.76 <h2>COMMANDS</h2> 1.77 1.78 -<a name="usage"></a> 1.79 -<h3>usage</h3> 1.80 -<p> 1.81 -The 'usage' command displays a summary of available commands 1.82 -with a short description: 1.83 -</p> 1.84 + 1.85 +<h3 id="usage">usage</h3> 1.86 + 1.87 +<p>The <code>usage</code> command displays a summary of available commands with 1.88 +a short description:</p> 1.89 + 1.90 <pre> 1.91 - # tazlito usage 1.92 +# tazlito usage 1.93 </pre> 1.94 1.95 -<a name="stats"></a> 1.96 -<h3>stats</h3> 1.97 -<p> 1.98 -Stats displays the configuration variables, the paths to the 1.99 -various files and directories, and information on the ISO image: 1.100 -</p> 1.101 + 1.102 +<h3 id="stats">stats</h3> 1.103 + 1.104 +<p><code>stats</code> displays the configuration variables, the paths to the 1.105 +various files and directories, and information on the ISO image:</p> 1.106 + 1.107 <pre> 1.108 - # tazlito stats 1.109 +# tazlito stats 1.110 </pre> 1.111 1.112 -<a name="gen-config"></a> 1.113 -<h3>gen-config</h3> 1.114 -<p> 1.115 -The 'gen-config' command allows you to generate a configuration 1.116 -file ready to be edited. By default the file is created in 1.117 -the current directory, but can be in another directory 1.118 -if specified via the command line: 1.119 -</p> 1.120 + 1.121 +<h3 id="gen-config">gen-config</h3> 1.122 + 1.123 +<p>The <code>gen-config</code> command allows you to generate a configuration 1.124 +file ready to be edited. By default the file is created in the current 1.125 +directory, but can be in another directory if specified via the command line:</p> 1.126 + 1.127 <pre> 1.128 - # tazlito gen-config 1.129 - # tazlito gen-config /path/to/distro 1.130 +# tazlito gen-config 1.131 +# tazlito gen-config <em>/path/to/distro</em> 1.132 </pre> 1.133 1.134 -<a name="configure"></a> 1.135 -<h3>configure</h3> 1.136 -<p> 1.137 -This command configures the system configuration 1.138 -file or one found in the current directory: 1.139 -</p> 1.140 + 1.141 +<h3 id="configure">configure</h3> 1.142 + 1.143 +<p>This command configures the system configuration file or one found in the 1.144 +current directory:</p> 1.145 + 1.146 <pre> 1.147 - # tazlito configure 1.148 +# tazlito configure 1.149 </pre> 1.150 1.151 -<a name="gen-iso"></a> 1.152 -<h3>gen-iso</h3> 1.153 -<p> 1.154 -The 'gen-iso' command can generate a 1.155 -new LiveCD image following modifications and additions to the 1.156 -root filesystem of the cdrom. To function, this command needs 1.157 -a directory containing the distro-tree of the Live system. 1.158 -This tree can easily be built with the 'extract-distro' command, 1.159 -modified and rebuilt via: 1.160 -</p> 1.161 + 1.162 +<h3 id="gen-iso">gen-iso</h3> 1.163 + 1.164 +<p>The <code>gen-iso</code> command can generate a new LiveCD image following 1.165 +modifications and additions to the root filesystem of the CD-ROM. To function, 1.166 +this command needs a directory containing the distro-tree of the Live system. 1.167 +This tree can easily be built with the 1.168 +<a href="#extract-distro"><code>extract-distro</code></a> command, modified and 1.169 +rebuilt via:</p> 1.170 + 1.171 <pre> 1.172 - # tazlito gen-iso 1.173 +# tazlito gen-iso 1.174 </pre> 1.175 1.176 -<a name="gen-initiso"></a> 1.177 -<h3>gen-initiso</h3> 1.178 -<p> 1.179 -The 'gen'initso' command will do the same work as 'gen-iso', 1.180 -but it rebuilds the initramfs compressed system prior. 1.181 -The initramfs contains the root filesystem and 1.182 -must be rebuilt if modified: 1.183 -</p> 1.184 + 1.185 +<h3 id="gen-initiso">gen-initiso</h3> 1.186 + 1.187 +<p>The <code>gen-initiso</code> command will do the same work as 1.188 +<code>gen-iso</code>, but it rebuilds the initramfs compressed system prior. 1.189 +The initramfs contains the root filesystem and must be rebuilt if modified:</p> 1.190 + 1.191 <pre> 1.192 - # tazlito gen-initiso 1.193 +# tazlito gen-initiso 1.194 </pre> 1.195 1.196 -<a name="list-flavors"></a> 1.197 -<h3>list-flavors</h3> 1.198 -<p> 1.199 -The 'list-flavors' command downloads (if necessary) and displays 1.200 -a list of the different flavors available. You can force the 1.201 -download with the --recharge option: 1.202 -</p> 1.203 + 1.204 +<h3 id="list-flavors">list-flavors</h3> 1.205 + 1.206 +<p>The <code>list-flavors</code> command downloads (if necessary) and displays 1.207 +a list of the different flavors available. You can force the download with the 1.208 +<code>--recharge</code> option:</p> 1.209 + 1.210 <pre> 1.211 - # tazlito list-flavors 1.212 - # tazlito list-flavors --recharge 1.213 +# tazlito list-flavors 1.214 +# tazlito list-flavors --recharge 1.215 </pre> 1.216 1.217 -<a name="get-flavors"></a> 1.218 -<h3>get-flavor</h3> 1.219 -<p> 1.220 -The 'get-flavor' command downloads (if necessary) and prepares the 1.221 -files for 'gen-distro' to generate a flavor: 1.222 -</p> 1.223 + 1.224 +<h3 id="get-flavor">get-flavor</h3> 1.225 + 1.226 +<p>The <code>get-flavor</code> command downloads (if necessary) and prepares the 1.227 +files for <a href="#gen-distro"><code>gen-distro</code></a> to generate 1.228 +a flavor:</p> 1.229 + 1.230 <pre> 1.231 - # tazlito get-flavor particular-flavor 1.232 +# tazlito get-flavor <em>particular-flavor</em> 1.233 </pre> 1.234 1.235 -<a name="show-flavors"></a> 1.236 -<h3>show-flavor</h3> 1.237 -<p> 1.238 -The 'show-flavor' command displays the description of the 1.239 -flavor and its size after regeneration. The options 1.240 ---brief and --noheader reduce the output displayed: 1.241 -</p> 1.242 + 1.243 +<h3 id="show-flavors">show-flavor</h3> 1.244 + 1.245 +<p>The <code>show-flavor</code> command displays the description of the flavor 1.246 +and its size after regeneration. The options <code>--brief</code> and 1.247 +<code>--noheader</code> reduce the output displayed:</p> 1.248 + 1.249 <pre> 1.250 - # tazlito show-flavor particular-flavor 1.251 - # tazlito show-flavor particular-flavor --brief 1.252 - # tazlito show-flavor particular-flavor --brief --noheader 1.253 +# tazlito show-flavor <em>particular-flavor</em> 1.254 +# tazlito show-flavor <em>particular-flavor</em> --brief 1.255 +# tazlito show-flavor <em>particular-flavor</em> --brief --noheader 1.256 </pre> 1.257 1.258 -<a name="gen-flavor"></a> 1.259 -<h3>gen-flavor</h3> 1.260 -<p> 1.261 -The 'gen-flavor' command creates a description file of a new 1.262 -flavor from the results of generating a distro (gen-distro). 1.263 -The .flavor file can then be sent to slitaz.org: 1.264 -</p> 1.265 + 1.266 +<h3 id="gen-flavor">gen-flavor</h3> 1.267 + 1.268 +<p>The <code>gen-flavor</code> command creates a description file of a new 1.269 +flavor from the results of generating a distro 1.270 +(<a href="#gen-distro"><code>gen-distro</code></a>). The <tt>.flavor</tt> file 1.271 +can then be sent to slitaz.org:</p> 1.272 + 1.273 <pre> 1.274 - # tazlito gen-flavor new-flavor 1.275 +# tazlito gen-flavor <em>new-flavor</em> 1.276 </pre> 1.277 1.278 -<a name="gen-liveflavor"></a> 1.279 -<h3>gen-liveflavor</h3> 1.280 -<p> 1.281 -The 'gen-liveflavor' command creates a description file of a new 1.282 -flavor from the results of generating a distro based on the 1.283 -current system. The --help option provides more information: 1.284 -</p> 1.285 -<pre> # tazlito gen-liveflavor 1.286 - # tazlito gen-liveflavor --help 1.287 + 1.288 +<h3 id="gen-liveflavor">gen-liveflavor</h3> 1.289 + 1.290 +<p>The <code>gen-liveflavor</code> command creates a description file of a new 1.291 +flavor from the results of generating a distro based on the current system. The 1.292 +<code>--help</code> option provides more information:</p> 1.293 + 1.294 +<pre> 1.295 +# tazlito gen-liveflavor 1.296 +# tazlito gen-liveflavor --help 1.297 </pre> 1.298 1.299 -<a name="upgrade-flavor"></a> 1.300 -<h3>upgrade-flavor</h3> 1.301 -<p> 1.302 -The `upgrade-flavor' command refreshes a flavor file by updating the 1.303 -list of packages with the latest versions available: 1.304 -</p> 1.305 + 1.306 +<h3 id="upgrade-flavor">upgrade-flavor</h3> 1.307 + 1.308 +<p>The <code>upgrade-flavor</code> command refreshes a flavor file by updating 1.309 +the list of packages with the latest versions available:</p> 1.310 + 1.311 <pre> 1.312 - # tazlito upgrade-flavor this-flavor 1.313 +# tazlito upgrade-flavor <em>this-flavor</em> 1.314 </pre> 1.315 1.316 -<a name="extract-flavor"></a> 1.317 -<h3>extract-flavor</h3> 1.318 -<p> 1.319 -The 'extract-flavor' command converts a flavor into an easily modifiable 1.320 -tree structure in /home/slitaz/VERSION/flavors which can be managed with 1.321 -mercurial: 1.322 -<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>. 1.323 -For example on cooking you will have the work directory in /home/slitaz/cooking. 1.324 -</p> 1.325 + 1.326 +<h3 id="extract-flavor">extract-flavor</h3> 1.327 + 1.328 +<p>The <code>extract-flavor</code> command converts a flavor into an easily 1.329 +modifiable tree structure in <tt>/home/slitaz/VERSION/flavors</tt> which can be 1.330 +managed with mercurial: 1.331 +<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>. For 1.332 +example on cooking you will have the work directory in 1.333 +<tt>/home/slitaz/cooking</tt>.</p> 1.334 + 1.335 <pre> 1.336 - # tazlito extract-flavor this-flavor 1.337 +# tazlito extract-flavor <em>this-flavor</em> 1.338 </pre> 1.339 1.340 -<a name="pack-flavor"></a> 1.341 -<h3>pack-flavor</h3> 1.342 -<p> 1.343 -The 'pack-flavor' command converts a tree structure in /home/slitaz/VERSION/flavors 1.344 - into a flavor file (.flavor). It is inverse of 'tazlito extract-flavor': 1.345 -</p> 1.346 + 1.347 +<h3 id="pack-flavor">pack-flavor</h3> 1.348 + 1.349 +<p>The <code>pack-flavor</code> command converts a tree structure in 1.350 +<tt>/home/slitaz/VERSION/flavors</tt> into a flavor file (<tt>.flavor</tt>). 1.351 +It is inverse of 1.352 +<a href="#extract-flavor"><code>tazlito extract-flavor</code></a>:</p> 1.353 + 1.354 <pre> 1.355 - # tazlito pack-flavor this-flavor 1.356 +# tazlito pack-flavor <em>this-flavor</em> 1.357 </pre> 1.358 1.359 -<a name="extract-distro"></a> 1.360 -<h3>extract-distro</h3> 1.361 -<p> 1.362 -The 'extract-distro' command is used to extract an ISO image 1.363 -from the LiveCD to rebuild the structure of the root cdrom 1.364 -and system. It is then possible to make the desired changes 1.365 -or additions and rebuild the ISO image via 'gen-iso' or 1.366 -'gen-initiso'. Example of use: 1.367 -</p> 1.368 + 1.369 +<h3 id="extract-distro">extract-distro</h3> 1.370 + 1.371 +<p>The <code>extract-distro</code> command is used to extract an ISO image from 1.372 +the LiveCD to rebuild the structure of the root CD-ROM and system. It is then 1.373 +possible to make the desired changes or additions and rebuild the ISO image via 1.374 +<a href="#gen-iso"><code>gen-iso</code></a> or 1.375 +<a href="#gen-initiso"><code>gen-initiso</code></a>. Example of use:</p> 1.376 + 1.377 <pre> 1.378 - # tazlito extract-distro slitaz-cooking.iso 1.379 +# tazlito extract-distro <em>slitaz-cooking.iso</em> 1.380 </pre> 1.381 1.382 -<a name="gen-distro"></a> 1.383 -<h3>gen-distro</h3> 1.384 -<p> 1.385 -The <em>Generate Distribution</em> command can generate the 1.386 -distro-tree and an ISO image via a list of packages. To function, 1.387 -this command needs a list of packages, a directory containing 1.388 -all the (.tazpkg) packages on the list, and a directory to 1.389 -generate the distribution. The list of packages can be extracted 1.390 -from a flavor with the 'get-flavor' command. If one uses the 1.391 -LiveCD, the options --cdrom and --iso= permit the regeneration 1.392 -of packages that place files in /boot without being obliged 1.393 -to download them and recovers the additional files of the 1.394 -LiveCD. The path to the various directories are configured 1.395 -in the configuration file and packages can be downloaded 1.396 -from the SliTaz mirrors or generated by Cookutils. To generate 1.397 -a distribution: 1.398 -</p> 1.399 + 1.400 +<h3 id="gen-distro">gen-distro</h3> 1.401 + 1.402 +<p>The <em>Generate Distribution</em> command can generate the distro-tree and 1.403 +an ISO image via a list of packages. To function, this command needs a list of 1.404 +packages, a directory containing all the (<tt>.tazpkg</tt>) packages on the 1.405 +list, and a directory to generate the distribution. The list of packages can be 1.406 +extracted from a flavor with the 1.407 +<a href="#get-flavor"><code>get-flavor</code></a> command. If one uses the 1.408 +LiveCD, the options <code>--cdrom</code> and <code>--iso=</code> permit the 1.409 +regeneration of packages that place files in <tt>/boot</tt> without being 1.410 +obliged to download them and recovers the additional files of the LiveCD. The 1.411 +path to the various directories are configured in the configuration file and 1.412 +packages can be downloaded from the SliTaz mirrors or generated by Cookutils. 1.413 +To generate a distribution:</p> 1.414 + 1.415 <pre> 1.416 - # tazlito gen-distro 1.417 - # tazlito gen-distro --cdrom 1.418 - # tazlito gen-distro --iso=slitaz.iso 1.419 - # tazlito gen-distro package-list 1.420 +# tazlito gen-distro 1.421 +# tazlito gen-distro --cdrom 1.422 +# tazlito gen-distro --iso=<em>slitaz.iso</em> 1.423 +# tazlito gen-distro <em>package-list</em> 1.424 </pre> 1.425 1.426 -<a name="clean-distro"></a> 1.427 -<h3>clean-distro</h3> 1.428 -<p> 1.429 -Removes all files generated or extracts of the structure 1.430 -of the LiveCD: 1.431 -</p> 1.432 + 1.433 +<h3 id="clean-distro">clean-distro</h3> 1.434 + 1.435 +<p>Removes all files generated or extracts of the structure of the LiveCD:</p> 1.436 + 1.437 <pre> 1.438 - # tazlito clean-distro 1.439 +# tazlito clean-distro 1.440 </pre> 1.441 1.442 -<a name="check-distro"></a> 1.443 -<h3>check-distro</h3> 1.444 -<p> 1.445 -This command simply verifies if files installed 1.446 -by the packages are present on the system: 1.447 -</p> 1.448 + 1.449 +<h3 id="check-distro">check-distro</h3> 1.450 + 1.451 +<p>This command simply verifies if files installed by the packages are present 1.452 +on the system:</p> 1.453 + 1.454 <pre> 1.455 - # tazlito check-distro 1.456 +# tazlito check-distro 1.457 </pre> 1.458 1.459 -<a name="writeiso"></a> 1.460 -<h3>writeiso</h3> 1.461 -<p> 1.462 -This command will write the current filesystem to a cpio archive 1.463 -(rootfs.gz) and then generate a bootable ISO image. Writeiso can 1.464 -be used in a HD install or in live mode and will also archive your 1.465 -current /home directory. This command lets you easily remaster and 1.466 -build your own LiveCD image, just boot, modify any files, and then: 1.467 1.468 -</p> 1.469 +<h3 id="writeiso">writeiso</h3> 1.470 + 1.471 +<p>This command will write the current filesystem to a cpio archive 1.472 +(<tt>rootfs.gz</tt>) and then generate a bootable ISO image. Writeiso can be 1.473 +used in a HD install or in live mode and will also archive your current 1.474 +<tt>/home</tt> directory. This command lets you easily remaster and build your 1.475 +own LiveCD image, just boot, modify any files, and then:</p> 1.476 + 1.477 <pre> 1.478 - # tazlito writeiso [gzip|lzma|none] 1.479 - # tazlito writeiso gzip 1.480 - # tazlito writeiso gzip image-name 1.481 +# tazlito writeiso [gzip|lzma|none] 1.482 +# tazlito writeiso gzip 1.483 +# tazlito writeiso gzip <em>image-name</em> 1.484 </pre> 1.485 1.486 -<a name="frugal-install"></a> 1.487 -<h3>frugal-install</h3> 1.488 -<p> 1.489 -Perfom a frugal installation into /boot/frugal and add a GRUB entry 1.490 -if needed. Frugal mode will make SliTaz work completely in memory 1.491 -(RAM) - useful to test a distro without burning an ISO or to have a 1.492 -rescue system ready to use when the computer powers on. To install 1.493 -all needed files from a distro tree or an ISO image: 1.494 -</p> 1.495 + 1.496 +<h3 id="frugal-install">frugal-install</h3> 1.497 + 1.498 +<p>Perfom a frugal installation into <tt>/boot/frugal</tt> and add a GRUB entry 1.499 +if needed. Frugal mode will make SliTaz work completely in memory (RAM)—useful 1.500 +to test a distro without burning an ISO or to have a rescue system ready to use 1.501 +when the computer powers on. To install all needed files from a distro tree or 1.502 +an ISO image:</p> 1.503 + 1.504 <pre> 1.505 - # tazlito frugal-install 1.506 - # tazlito -fi slitaz.iso 1.507 +# tazlito frugal-install 1.508 +# tazlito -fi <em>slitaz.iso</em> 1.509 </pre> 1.510 1.511 -<a name="check-list"></a> 1.512 -<h3>check-list</h3> 1.513 -<p> 1.514 -Checks if the distro-packages.list is updated with the latest package 1.515 -versions: 1.516 -</p> 1.517 + 1.518 +<h3 id="check-list">check-list</h3> 1.519 + 1.520 +<p>Checks if the <tt>distro-packages.list</tt> is updated with the latest 1.521 +package versions:</p> 1.522 + 1.523 <pre> 1.524 - # tazlito check-list 1.525 +# tazlito check-list 1.526 </pre> 1.527 1.528 -<a name="repack"></a> 1.529 -<h3>repack</h3> 1.530 -<p> 1.531 -Recompresses the rootfs with the best possible compression: 1.532 -</p> 1.533 + 1.534 +<h3 id="repack">repack</h3> 1.535 + 1.536 +<p>Recompresses the rootfs with the best possible compression:</p> 1.537 + 1.538 <pre> 1.539 - # tazlito repack slitaz.iso 1.540 +# tazlito repack <em>slitaz.iso</em> 1.541 </pre> 1.542 1.543 -<a name="merge"></a> 1.544 -<h3>merge</h3> 1.545 -<p> 1.546 -Combines several flavors like nested Russian dolls. Each rootfs is a 1.547 -subset of the previous. The first rootfs is extracted from the ISO image 1.548 -used in the third argument. The flavor will then be chosen to launch at 1.549 -startup according to the amount of RAM available: 1.550 -</p> 1.551 + 1.552 +<h3 id="merge">merge</h3> 1.553 + 1.554 +<p>Combines several flavors like nested Russian dolls. Each rootfs is a subset 1.555 +of the previous. The first rootfs is extracted from the ISO image used in the 1.556 +third argument. The flavor will then be chosen to launch at startup according 1.557 +to the amount of RAM available:</p> 1.558 + 1.559 <pre> 1.560 - # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz 1.561 +# tazlito merge <em>160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz</em> 1.562 </pre> 1.563 1.564 -<a name="build-loram"></a> 1.565 -<h3>build-loram</h3> 1.566 -<p> 1.567 -Creates an ISO image flavor for low ram systems from a SliTaz ISO image. 1.568 -You can build a flavor with / always in ram or where / resides on the cdrom: 1.569 -</p> 1.570 + 1.571 +<h3 id="build-loram">build-loram</h3> 1.572 + 1.573 +<p>Creates an ISO image flavor for low RAM systems from a SliTaz ISO image. You 1.574 +can build a flavor with <tt>/</tt> always in RAM or where <tt>/</tt> resides on 1.575 +the CD-ROM:</p> 1.576 + 1.577 <pre> 1.578 - # tazlito build-loram slitaz.iso loram.iso 1.579 - # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom 1.580 +# tazlito build-loram <em>slitaz.iso loram.iso</em> 1.581 +# tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom 1.582 </pre> 1.583 1.584 -<a name="emu-iso"></a> 1.585 -<h3>emu-iso</h3> 1.586 -<p> 1.587 -The emu-iso command uses the Qemu emulator to start and run SliTaz. 1.588 -Qemu is used to test the newly built ISO image without burning to a 1.589 -cdrom or booting into frugal mode: 1.590 -</p> 1.591 + 1.592 +<h3 id="emu-iso">emu-iso</h3> 1.593 + 1.594 +<p>The <code>emu-iso</code> command uses the Qemu emulator to start and run 1.595 +SliTaz. Qemu is used to test the newly built ISO image without burning to a 1.596 +CD-ROM or booting into frugal mode:</p> 1.597 + 1.598 <pre> 1.599 - # tazlito emu-iso 1.600 - # tazlito emu-iso path/to/image.iso 1.601 +# tazlito emu-iso 1.602 +# tazlito emu-iso path/to/image.iso 1.603 </pre> 1.604 1.605 -<a name="burn-iso"></a> 1.606 -<h3>burn-iso</h3> 1.607 -<p> 1.608 -Burn-iso will guess the cdrom device and its speed, and wodim 1.609 -(part of cdrkit) will begin to burn an ISO image. The default 1.610 -ISO image is the one located in the current configuration file, 1.611 -but it's possible to specify a different image via the 1.612 -command line: 1.613 -</p> 1.614 + 1.615 +<h3 id="burn-iso">burn-iso</h3> 1.616 + 1.617 +<p><code>burn-iso</code> will guess the CD-ROM device and its speed, and wodim 1.618 +(part of cdrkit) will begin to burn an ISO image. The default ISO image is the 1.619 +one located in the current configuration file, but it's possible to specify 1.620 +a different image via the command line:</p> 1.621 + 1.622 <pre> 1.623 - # tazlito burn-iso 1.624 - # tazlito burn-iso slitaz-hacked.iso 1.625 +# tazlito burn-iso 1.626 +# tazlito burn-iso <em>slitaz-hacked.iso</em> 1.627 </pre> 1.628 1.629 + 1.630 <h2>FLAVORS</h2> 1.631 -<p> 1.632 -A <i>.flavor</i> file contains just a few KB of information needed to 1.633 -(re)manufacture a custom LiveCD of SliTaz. 1.634 -</p> 1.635 1.636 -<a name="rebuild-flavor"></a> 1.637 -<h3>Manufacture a flavor</h3> 1.638 -<p> 1.639 -You can choose the flavor to (re)manufacture from among those available: 1.640 -</p> 1.641 +<p>A <tt>.flavor</tt> file contains just a few KB of information needed to 1.642 +(re)manufacture a custom LiveCD of SliTaz.</p> 1.643 + 1.644 + 1.645 +<h3 id="rebuild-flavor">Manufacture a flavor</h3> 1.646 + 1.647 +<p>You can choose the flavor to (re)manufacture from among those available:</p> 1.648 + 1.649 <pre> 1.650 # tazlito list-flavors 1.651 1.652 @@ -386,156 +385,132 @@ 1.653 eeepc 31.2M 105.4M SliTaz eeepc system 1.654 justX 16.1M 51.2M SliTaz with a minimal X environment 1.655 </pre> 1.656 -<p> 1.657 -We will start by remanufacturing the <i>eeepc</i> flavor which uses 105.4M of RAM 1.658 -and has a CD-ROM size of 31.2M: 1.659 -</p> 1.660 + 1.661 +<p>We will start by remanufacturing the <em>eeepc</em> flavor which uses 105.4M 1.662 +of RAM and has a CD-ROM size of 31.2M:</p> 1.663 + 1.664 <pre> 1.665 # tazlito clean-distro 1.666 -# tazlito get-flavor eeepc 1.667 +# tazlito get-flavor <em>eeepc</em> 1.668 # tazlito gen-distro 1.669 </pre> 1.670 1.671 -<a name="create-flavor"></a> 1.672 -<h3>Create a flavor</h3> 1.673 -<p> 1.674 -To create a flavor, you must: 1.675 -</p> 1.676 + 1.677 +<h3 id="create-flavor">Create a flavor</h3> 1.678 + 1.679 +<p>To create a flavor, you must:</p> 1.680 + 1.681 <ul> 1.682 - <li>Either create an ISO image with <b>tazlito gen-distro</b> and then create 1.683 - a flavor file with <b>tazlito gen-flavor</b></li> 1.684 + <li>Either create an ISO image with <a href="#gen-distro"><code>tazlito 1.685 + gen-distro</code></a> and then create a flavor file with 1.686 + <a href="#gen-flavor"><code>tazlito gen-flavor</code></a></li> 1.687 <li>Either directly create the tree structure that defines the flavor 1.688 - (see <b>tazlito extract-flavor</b>) and then create the flavor with 1.689 - <b>tazlito pack-flavor</b></li> 1.690 - <li>Either use the 1.691 - <a href="http://pizza.slitaz.org/">online builder</a></li> 1.692 + (see <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>) 1.693 + and then create the flavor with <a href="#pack-flavor"><code>tazlito 1.694 + pack-flavor</code></a></li> 1.695 + <li>Either use the <a href="http://pizza.slitaz.org/">online builder</a></li> 1.696 </ul> 1.697 1.698 -<a name="publish-flavor"></a> 1.699 -<h3>Post a flavor</h3> 1.700 -<p> 1.701 -Because a .flavor file contains just a few KB; it can be easily sent via the 1.702 -mailing list. 1.703 -</p> 1.704 -<p> 1.705 -The results of <b>tazlito extract flavor</b> can also be put in mercurial 1.706 -(http://repos.slitaz.org/flavors). This method is preferred because the 1.707 -tree will be directly visible with the 1.708 -<a href="http://hg.slitaz.org/flavors/file/tip">mercurial web interface</a>. 1.709 -</p> 1.710 -<p> 1.711 -This tree includes: 1.712 -</p> 1.713 + 1.714 +<h3 id="publish-flavor">Post a flavor</h3> 1.715 + 1.716 +<p>Because a <tt>.flavor</tt> file contains just a few KB, it can be easily sent 1.717 +via the <a href="http://www.slitaz.org/en/mailing-list.php">mailing list</a>.</p> 1.718 + 1.719 +<p>The results of <a href="#extract-flavor"><code>tazlito 1.720 +extract-flavor</code></a> can also be put in 1.721 +<a href="http://hg.slitaz.org/flavors">mercurial</a>. This method is 1.722 +preferred because the tree will be directly visible with the 1.723 +<a href="http://hg.slitaz.org/flavors/file/tip">mercurial web interface</a>.</p> 1.724 +<p>This tree includes:</p> 1.725 + 1.726 <ul> 1.727 -<li> 1.728 -A <b>receipt</b> file describing the flavor thanks to the variables: 1.729 - <ul> 1.730 - <li> 1.731 -FLAVOR: The flavor name. 1.732 - </li> 1.733 - <li> 1.734 -SHORT_DESC: Short description. 1.735 - </li> 1.736 - <li> 1.737 -VERSION: Free format. 1.738 - </li> 1.739 - <li> 1.740 -MAINTAINER: Email address of maintainer. 1.741 - </li> 1.742 - <li> 1.743 -FRUGAL_RAM: Minimum RAM required (optional). 1.744 - </li> 1.745 - <li> 1.746 -ROOTFS_SIZE: Size of rootfs.gz decompressed into RAM (optional). 1.747 - </li> 1.748 - <li> 1.749 -INITRAMFS_SIZE: Size of rootfs.gz on the CD-ROM (optional). 1.750 - </li> 1.751 - <li> 1.752 -ISO_SIZE: Size of CD-ROM (optional). 1.753 - </li> 1.754 - <li> 1.755 -ROOTFS_SELECTION: Optional, see <i>Meta flavor</i> below. 1.756 - </li> 1.757 - </ul> 1.758 -</li> 1.759 -<li> 1.760 -The file <b>packages.list</b> containing the list of packages without 1.761 -specifying the version (tazlito uses the latest available). 1.762 -This file is missing if ROOTFS_SELECTION exists in the receipt. 1.763 -</li> 1.764 -<li> 1.765 -The optional <b>mirrors</b> file containing the list of unofficial mirrors 1.766 -(undigest) to be added to include personal packages. 1.767 -</li> 1.768 -<li> 1.769 -The optional directory <b>rootfs</b> containing the tree to add to the 1.770 -root filesystem rootfs.gz (configuration files usually). 1.771 -</li> 1.772 -<li> 1.773 -The optional directory <b>rootcd</b> containing the tree to add to the 1.774 -root of the CD-ROM. 1.775 -</li> 1.776 + <li>A <b>receipt</b> file describing the flavor thanks to the variables: 1.777 + <ul> 1.778 + <li>FLAVOR: The flavor name.</li> 1.779 + <li>SHORT_DESC: Short description.</li> 1.780 + <li>VERSION: Free format.</li> 1.781 + <li>MAINTAINER: Email address of maintainer.</li> 1.782 + <li>FRUGAL_RAM: Minimum RAM required (optional).</li> 1.783 + <li>ROOTFS_SIZE: Size of rootfs.gz decompressed into RAM 1.784 + (optional).</li> 1.785 + <li>INITRAMFS_SIZE: Size of rootfs.gz on the CD-ROM (optional).</li> 1.786 + <li>ISO_SIZE: Size of CD-ROM (optional).</li> 1.787 + <li>ROOTFS_SELECTION: Optional, see <a href="#meta-flavor">Meta 1.788 + flavor</a> below.</li> 1.789 + </ul> 1.790 + </li> 1.791 + <li>The file <b>packages.list</b> containing the list of packages without 1.792 + specifying the version (tazlito uses the latest available). This file 1.793 + is missing if ROOTFS_SELECTION exists in the receipt.</li> 1.794 + <li>The optional <b>mirrors</b> file containing the list of unofficial 1.795 + mirrors (undigest) to be added to include personal packages.</li> 1.796 + <li>The optional directory <b>rootfs</b> containing the tree to add to the 1.797 + root filesystem rootfs.gz (configuration files usually).</li> 1.798 + <li>The optional directory <b>rootcd</b> containing the tree to add to the 1.799 + root of the CD-ROM.</li> 1.800 </ul> 1.801 1.802 -<a name="tune-flavor"></a> 1.803 -<h3>Adapt a flavor</h3> 1.804 -<p> 1.805 -It is often easier to modify an existing flavor than to create one from 1.806 -scratch. To adapt the eeepc flavor for example: 1.807 -</p> 1.808 + 1.809 +<h3 id="tune-flavor">Adapt a flavor</h3> 1.810 + 1.811 +<p>It is often easier to modify an existing flavor than to create one from 1.812 +scratch. To adapt the eeepc flavor for example:</p> 1.813 + 1.814 <pre> 1.815 # tazpkg get-install mercurial 1.816 # cd /home/slitaz 1.817 # hg clone http://hg.slitaz.org/flavors 1.818 # cd flavors 1.819 -# cp -a eeepc myslitaz 1.820 -</pre> 1.821 -<p> 1.822 -Files in my-slitaz can then be changed, and: 1.823 -</p> 1.824 -<pre> 1.825 -# tazlito pack-flavor myslitaz 1.826 -</pre> 1.827 -<p> 1.828 -Will simply create the new flavor. 1.829 -</p> 1.830 -<p> 1.831 -Tip: you can skip mercurial installation by extracting a flavor. 1.832 -Using the previous example: 1.833 -</p> 1.834 -<pre> 1.835 -# tazlito get-flavor eeepc 1.836 -# tazlito extract-flavor eeepc.flavor 1.837 -# cd /home/slitaz/flavors 1.838 -# cp -a eeepc myslitaz 1.839 +# cp -a <em>eeepc myslitaz</em> 1.840 </pre> 1.841 1.842 -<a name="meta-flavor"></a> 1.843 -<h3>Meta flavor</h3> 1.844 -<p> 1.845 -A meta flavor contains several flavors like nested Russian dolls. The flavor 1.846 -will be launched at startup according to the amount of RAM available. 1.847 -The ROOTFS_SELECTION variable defines the minimim RAM and corresponding 1.848 -flavor parameters, <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"> 1.849 -example</a>: 1.850 -</p> 1.851 +<p>Files in <tt>myslitaz</tt> can then be changed, and:</p> 1.852 + 1.853 +<pre> 1.854 +# tazlito pack-flavor <em>myslitaz</em> 1.855 +</pre> 1.856 + 1.857 +<p>Will simply create the new flavor.</p> 1.858 + 1.859 +<p>Tip: you can skip mercurial installation by extracting a flavor. Using the 1.860 +previous example:</p> 1.861 + 1.862 +<pre> 1.863 +# tazlito get-flavor <em>eeepc</em> 1.864 +# tazlito extract-flavor <em>eeepc.flavor</em> 1.865 +# cd /home/slitaz/flavors 1.866 +# cp -a <em>eeepc myslitaz</em> 1.867 +</pre> 1.868 + 1.869 + 1.870 +<h3 id="meta-flavor">Meta flavor</h3> 1.871 + 1.872 +<p>A meta flavor contains several flavors like nested Russian dolls. The flavor 1.873 +will be launched at startup according to the amount of RAM available. The 1.874 +ROOTFS_SELECTION variable defines the minimim RAM and corresponding flavor 1.875 +parameters, <a 1.876 +href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">example</a>:</p> 1.877 + 1.878 <pre> 1.879 ROOTFS_SELECTION="160M core 96M justX 32M base" 1.880 </pre> 1.881 -<p> 1.882 -A meta flavor doesn't contain a list of packages (packages.list). SliTaz 1.883 -kernels prior to 2.6.30 do not support meta flavors. 1.884 -</p> 1.885 + 1.886 +<p>A meta flavor doesn't contain a list of packages (<tt>packages.list</tt>). 1.887 +SliTaz kernels prior to 2.6.30 do not support meta flavors.</p> 1.888 + 1.889 1.890 <h2>MAINTAINER</h2> 1.891 -<p> 1.892 -Christophe Lincoln <pankso at slitaz.org><br /> 1.893 -Pascal bellard <pascal.bellard at slitaz.org> 1.894 -</p> 1.895 + 1.896 +<p>Christophe Lincoln <pankso at slitaz.org><br /> 1.897 +Pascal Bellard <pascal.bellard at slitaz.org></p> 1.898 1.899 <!-- End content --> 1.900 </div> 1.901 + 1.902 +<footer> 1.903 + Copyright © 2013 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a> 1.904 +</footer> 1.905 + 1.906 </body> 1.907 </html> 1.908 -