website rev 584
en: remove all manuals copy and link to Hg versions
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sun Feb 21 23:13:36 2010 +0100 (2010-02-21) |
| parents | 95f0c424c767 |
| children | 7b66a5bf540b |
| files | en/doc/index.html en/doc/manuals/tazlito.en.html en/doc/manuals/tazpkg.en.html en/doc/manuals/tazusb.en.html en/doc/manuals/tazwok.en.html |
line diff
1.1 --- a/en/doc/index.html Sun Feb 21 22:47:28 2010 +0100 1.2 +++ b/en/doc/index.html Sun Feb 21 23:13:36 2010 +0100 1.3 @@ -103,21 +103,20 @@ 1.4 1.5 <h2><font color="#df8f06">Manuals</font></h2> 1.6 <ul> 1.7 - <li><a href="manuals/tazpkg.en.html">Tazpkg manual</a> - SliTaz 1.8 - Package Manager.</li> 1.9 - <li><a href="manuals/tazlito.en.html">Tazlito manual</a> - SliTaz LiveCD 1.10 - utility.</li> 1.11 - <li><a href="manuals/tazusb.en.html">TazUSB manual</a> - SliTaz LiveUSB 1.12 - utility.</li> 1.13 - <li><a href="manuals/tazwok.en.html">Tazwok manual</a> - SliTaz 1.14 - Package Cooker.</li> 1.15 + <li><a href="http://hg.slitaz.org/tazpkg/raw-file/tip/doc/tazpkg.en.html" 1.16 + >Tazpkg manual</a> - SliTaz Package Manager.</li> 1.17 + <li><a href="http://hg.slitaz.org/tazlito/raw-file/tip/doc/tazlito.en.html" 1.18 + >Tazlito manual</a> - SliTaz LiveCD utility.</li> 1.19 + <li><a href="http://hg.slitaz.org/tazusb/raw-file/tip/doc/tazusb.en.html" 1.20 + >TazUSB manual</a> - SliTaz LiveUSB utility.</li> 1.21 + <li><a href="http://hg.slitaz.org/tazwok/raw-file/tip/doc/tazwok.en.html" 1.22 + >Tazwok manual</a> - SliTaz Package Cooker.</li> 1.23 </ul> 1.24 1.25 -<h2><font color="#df8f06">Wiki Resources</font></h2> 1.26 +<h2><font color="#df8f06">New Wiki documentation</font></h2> 1.27 <p> 1.28 -The <a href="http://wiki.slitaz.org/">Wiki</a> contains community 1.29 -documentation including specific how-tos, tips and tricks, etc. Feel free 1.30 -to contribute. 1.31 +All SliTaz documentation is moving, migration information, guides and 1.32 +more at: <a href="http://doc.slitaz.org/">doc.slitaz.org</a> 1.33 </p> 1.34 1.35 <h2><font color="#df8f06">Release Notes</font></h2>
2.1 --- a/en/doc/manuals/tazlito.en.html Sun Feb 21 22:47:28 2010 +0100 2.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 2.3 @@ -1,528 +0,0 @@ 2.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 2.5 - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 2.7 -<head> 2.8 - <title>Tazlito Manual - SliTaz Live Tool</title> 2.9 - <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 2.10 - <meta name="description" content="" /> 2.11 - <meta name="expires" content="never" /> 2.12 - <meta name="modified" content="2008-07-18 14:00:00" /> 2.13 - <style type="text/css"><!-- 2.14 - body { font: 90% sans-serif, vernada, arial; margin: 0; } 2.15 - #header { background: #f0ba08; color: black; height: 50px; 2.16 - border-top: 1px solid black; border-bottom: 1px solid black; } 2.17 - #content { margin: 0px 50px 26px 50px; } 2.18 - h1 { margin: 14px 0px 0px 16px; } 2.19 - li { line-height: 1.4em; } 2.20 - pre { padding: 5px; color: black; background: #e1e0b0; } 2.21 - pre.script { padding: 10px; color: black; background: #e8e8e8; 2.22 - border: 1px inset #333333; } 2.23 - code { font-size: 100%; color: #669900; background: transparent; } 2.24 - hr { color: white; background: white; height: 1px; border: 0; } 2.25 - --></style> 2.26 -</head> 2.27 -<body bgcolor="#ffffff"> 2.28 -<div id="header"> 2.29 -<h1><font color="#3e1220">Tazlito Manual</font></h1> 2.30 -</div> 2.31 -<hr /> 2.32 -<!-- Start content --> 2.33 -<div id="content"> 2.34 - 2.35 -<h2>NAME</h2> 2.36 -<p> 2.37 -Tazlito - SliTaz Live Tool. 2.38 -</p> 2.39 - 2.40 -<h2>SYNTAX</h2> 2.41 -<pre> 2.42 -tazlito [command] [list|iso|flavor] [dir] 2.43 -</pre> 2.44 - 2.45 -<h2>DESCRIPTION</h2> 2.46 -<p> 2.47 -Tazlito is a small utility to extract a LiveCD, rebuild the 2.48 -ISO image and regenerate the root filesystem of the LiveCD. 2.49 -Tazlito can also generate a distribution from a list of packages 2.50 -previously downloaded. To run, Tazlito uses the configuration file 2.51 -/etc/tazlito/tazlito.conf or a tazlito.conf found in the 2.52 -current directory that can be easily generated. 2.53 -It specifies the name of the ISO, volume, maintainer and 2.54 -the paths of the packages to distribute and the generated ISO. 2.55 -Tazlito can also set up a directory containing additional files 2.56 -which will be copied to the LiveCD when generating the distribution. 2.57 -</p> 2.58 -<p> 2.59 -Tazlito is distributed under the free GNU licence GPL V3, 2.60 -installed by default on SliTaz and installed/sucessfully tested 2.61 -on Debian GNU/Linux. You will find additional information 2.62 -about creating a LiveCD in the Handbook. 2.63 -</p> 2.64 - 2.65 -<h2>COMMANDS</h2> 2.66 - 2.67 -<a name="usage"></a> 2.68 -<h3><font color="#6c0023">usage</font></h3> 2.69 -<p> 2.70 -The 'usage' command displays a summary of available commands 2.71 -with a short description: 2.72 -</p> 2.73 -<pre> 2.74 - # tazlito usage 2.75 -</pre> 2.76 - 2.77 -<a name="stats"></a> 2.78 -<h3><font color="#6c0023">stats</font></h3> 2.79 -<p> 2.80 -Stats displays the configuration variables, the paths to the 2.81 -various files and directories, and information on the ISO image: 2.82 -</p> 2.83 -<pre> 2.84 - # tazlito stats 2.85 -</pre> 2.86 - 2.87 -<a name="gen-config"></a> 2.88 -<h3><font color="#6c0023">gen-config</font></h3> 2.89 -<p> 2.90 -The 'gen-config' command allows you to generate a configuration 2.91 -file ready to be edited. By default the file is created in 2.92 -the current directory, but can be in another directory 2.93 -if specified via the command line: 2.94 -</p> 2.95 -<pre> 2.96 - # tazlito gen-config 2.97 - # tazlito gen-config /path/to/distro 2.98 -</pre> 2.99 - 2.100 -<a name="configure"></a> 2.101 -<h3><font color="#6c0023">configure</font></h3> 2.102 -<p> 2.103 -This command configures the system configuration 2.104 -file or one found in the current directory: 2.105 -</p> 2.106 -<pre> 2.107 - # tazlito configure 2.108 -</pre> 2.109 - 2.110 -<a name="gen-iso"></a> 2.111 -<h3><font color="#6c0023">gen-iso</font></h3> 2.112 -<p> 2.113 -The 'gen-iso' command can generate a 2.114 -new LiveCD image following modifications and additions to the 2.115 -root filesystem of the cdrom. To function, this command needs 2.116 -a directory containing the distro-tree of the Live system. 2.117 -This tree can easily be built with the 'extract-distro' command, 2.118 -modified and rebuilt via: 2.119 -</p> 2.120 -<pre> 2.121 - # tazlito gen-iso 2.122 -</pre> 2.123 - 2.124 -<a name="gen-initiso"></a> 2.125 -<h3><font color="#6c0023">gen-initiso</font></h3> 2.126 -<p> 2.127 -The 'gen'initso' command will do the same work as 'gen-iso', 2.128 -but it rebuilds the initramfs compressed system prior. 2.129 -The initramfs contains the root filesystem and 2.130 -must be rebuilt if modified: 2.131 -</p> 2.132 -<pre> 2.133 - # tazlito gen-initiso 2.134 -</pre> 2.135 - 2.136 -<a name="list-flavors"></a> 2.137 -<h3><font color="#6c0023">list-flavors</font></h3> 2.138 -<p> 2.139 -The 'list-flavors' command downloads (if necessary) and displays 2.140 -a list of the different flavors available. You can force the 2.141 -download with the --recharge option: 2.142 -</p> 2.143 -<pre> 2.144 - # tazlito list-flavors 2.145 - # tazlito list-flavors --recharge 2.146 -</pre> 2.147 - 2.148 -<a name="get-flavors"></a> 2.149 -<h3><font color="#6c0023">get-flavor</font></h3> 2.150 -<p> 2.151 -The 'get-flavor' command downloads (if necessary) and prepares the 2.152 -files for 'gen-distro' to generate a flavor: 2.153 -</p> 2.154 -<pre> 2.155 - # tazlito get-flavor particular-flavor 2.156 -</pre> 2.157 - 2.158 -<a name="show-flavors"></a> 2.159 -<h3><font color="#6c0023">show-flavor</font></h3> 2.160 -<p> 2.161 -The 'show-flavor' command displays the description of the 2.162 -flavor and its size after regeneration. The options 2.163 ---brief and --noheader reduce the output displayed: 2.164 -</p> 2.165 -<pre> 2.166 - # tazlito show-flavor particular-flavor 2.167 - # tazlito show-flavor particular-flavor --brief 2.168 - # tazlito show-flavor particular-flavor --brief --noheader 2.169 -</pre> 2.170 - 2.171 -<a name="gen-flavor"></a> 2.172 -<h3><font color="#6c0023">gen-flavor</font></h3> 2.173 -<p> 2.174 -The 'gen-flavor' command creates a description file of a new 2.175 -flavor from the results of generating a distro (gen-distro). 2.176 -The .flavor file can then be sent to slitaz.org: 2.177 -</p> 2.178 -<pre> 2.179 - # tazlito gen-flavor new-flavor 2.180 -</pre> 2.181 - 2.182 -<a name="gen-liveflavor"></a> 2.183 -<h3><font color="#6c0023">gen-liveflavor</font></h3> 2.184 -<p> 2.185 -The 'gen-liveflavor' command creates a description file of a new 2.186 -flavor from the results of generating a distro based on the 2.187 -current system. The --help option provides more information: 2.188 -</p> 2.189 -<pre> # tazlito gen-liveflavor 2.190 - # tazlito gen-liveflavor --help 2.191 -</pre> 2.192 - 2.193 -<a name="upgrade-flavor"></a> 2.194 -<h3><font color="#6c0023">upgrade-flavor</font></h3> 2.195 -<p> 2.196 -The `upgrade-flavor' command refreshes a flavor file by updating the 2.197 -list of packages with the latest versions available: 2.198 -</p> 2.199 -<pre> 2.200 - # tazlito upgrade-flavor this-flavor 2.201 -</pre> 2.202 - 2.203 -<a name="extract-flavor"></a> 2.204 -<h3><font color="#6c0023">extract-flavor</font></h3> 2.205 -<p> 2.206 -The 'extract-flavor' command converts a flavor into an easily modifiable 2.207 -tree structure in /home/slitaz/flavors which can be managed with 2.208 -mercurial: 2.209 -<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>. 2.210 -</p> 2.211 -<pre> 2.212 - # tazlito extract-flavor this-flavor 2.213 -</pre> 2.214 - 2.215 -<a name="pack-flavor"></a> 2.216 -<h3><font color="#6c0023">pack-flavor</font></h3> 2.217 -<p> 2.218 -The 'pack-flavor' command converts a tree structure in /home/slitaz/flavors 2.219 - into a flavor file (.flavor). It is inverse of 'tazlito extract-flavor': 2.220 -</p> 2.221 -<pre> 2.222 - # tazlito pack-flavor this-flavor 2.223 -</pre> 2.224 - 2.225 -<a name="extract-distro"></a> 2.226 -<h3><font color="#6c0023">extract-distro</font></h3> 2.227 -<p> 2.228 -The 'extract-distro' command is used to extract an ISO image 2.229 -from the LiveCD to rebuild the structure of the root cdrom 2.230 -and system. It is then possible to make the desired changes 2.231 -or additions and rebuild the ISO image via 'gen-iso' or 2.232 -'gen-initiso'. Example of use: 2.233 -</p> 2.234 -<pre> 2.235 - # tazlito extract-distro slitaz-cooking.iso 2.236 -</pre> 2.237 - 2.238 -<a name="gen-distro"></a> 2.239 -<h3><font color="#6c0023">gen-distro</font></h3> 2.240 -<p> 2.241 -The <em>Generate Distribution</em> command can generate the 2.242 -distro-tree and an ISO image via a list of packages. To function, 2.243 -this command needs a list of packages, a directory containing 2.244 -all the (.tazpkg) packages on the list, and a directory to 2.245 -generate the distribution. The list of packages can be extracted 2.246 -from a flavor by the 'get-flavor' command. If one uses the 2.247 -LiveCD, the options --cdrom and --iso= permit the regeneration 2.248 -of packages that place files in /boot without being obliged 2.249 -to download them and recovers the additional files of the 2.250 -LiveCD. The path to the various directories are configured 2.251 -in the configuration file and packages can be downloaded 2.252 -from the SliTaz mirrors or generated by Tazwok. To generate 2.253 -a distribution: 2.254 -</p> 2.255 -<pre> 2.256 - # tazlito gen-distro 2.257 - # tazlito gen-distro --cdrom 2.258 - # tazlito gen-distro --iso=slitaz.iso 2.259 - # tazlito gen-distro package-list 2.260 -</pre> 2.261 - 2.262 -<a name="clean-distro"></a> 2.263 -<h3><font color="#6c0023">clean-distro</font></h3> 2.264 -<p> 2.265 -Removes all files generated or extracts of the structure 2.266 -of the LiveCD: 2.267 -</p> 2.268 -<pre> 2.269 - # tazlito clean-distro 2.270 -</pre> 2.271 - 2.272 -<a name="check-distro"></a> 2.273 -<h3><font color="#6c0023">check-distro</font></h3> 2.274 -<p> 2.275 -This command simply verifies if files installed 2.276 -by the packages are present on the system: 2.277 -</p> 2.278 -<pre> 2.279 - # tazlito check-distro 2.280 -</pre> 2.281 - 2.282 -<a name="writeiso"></a> 2.283 -<h3><font color="#6c0023">writeiso</font></h3> 2.284 -<p> 2.285 -This command will write the current filesystem to a cpio archive 2.286 -(rootfs.gz) and then generate a bootable ISO image. Writeiso can 2.287 -be used in a HD install or in live mode and will also archive your 2.288 -current /home directory. This command lets you easily remaster and 2.289 -build your own LiveCD image, just boot, modify any files, and then: 2.290 - 2.291 -</p> 2.292 -<pre> 2.293 - # tazlito writeiso [gzip|lzma|none] 2.294 - # tazlito writeiso gzip 2.295 - # tazlito writeiso gzip image-name 2.296 -</pre> 2.297 - 2.298 -<a name="frugal-install"></a> 2.299 -<h3><font color="#6c0023">frugal-install</font></h3> 2.300 -<p> 2.301 -Perfom a frugal installation into /boot/frugal and add a GRUB entry 2.302 -if needed. Frugal mode will make SliTaz work completely in memory 2.303 -(RAM) - useful to test a distro without burning an ISO or to have a 2.304 -rescue system ready to use when the computer powers on. To install 2.305 -all needed files from a distro tree or an ISO image: 2.306 -</p> 2.307 -<pre> 2.308 - # tazlito frugal-install 2.309 - # tazlito -fi slitaz.iso 2.310 -</pre> 2.311 - 2.312 -<a name="check-list"></a> 2.313 -<h3><font color="#6c0023">check-list</font></h3> 2.314 -<p> 2.315 -Checks if the distro-packages.list is updated with the latest package 2.316 -versions: 2.317 -</p> 2.318 -<pre> 2.319 - # tazlito check-list 2.320 -</pre> 2.321 - 2.322 -<a name="repack"></a> 2.323 -<h3><font color="#6c0023">repack</font></h3> 2.324 -<p> 2.325 -Recompresses the rootfs with the best possible compression: 2.326 -</p> 2.327 -<pre> 2.328 - # tazlito repack slitaz.iso 2.329 -</pre> 2.330 - 2.331 -<a name="merge"></a> 2.332 -<h3><font color="#6c0023">merge</font></h3> 2.333 -<p> 2.334 -Combines several flavors like nested Russian dolls. Each rootfs is a 2.335 -subset of the previous. The first rootfs is extracted from the ISO image 2.336 -used in the third argument. The flavor will then be chosen to launch at 2.337 -startup according to the amount of RAM available: 2.338 -</p> 2.339 -<pre> 2.340 - # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz 2.341 -</pre> 2.342 - 2.343 -<a name="emu-iso"></a> 2.344 -<h3><font color="#6c0023">emu-iso</font></h3> 2.345 -<p> 2.346 -The emu-iso command uses the Qemu emulator to start and run SliTaz. 2.347 -Qemu is used to test the newly built ISO image without burning to a 2.348 -cdrom or booting into frugal mode: 2.349 -</p> 2.350 -<pre> 2.351 - # tazlito emu-iso 2.352 - # tazlito emu-iso path/to/image.iso 2.353 -</pre> 2.354 - 2.355 -<a name="burn-iso"></a> 2.356 -<h3><font color="#6c0023">burn-iso</font></h3> 2.357 -<p> 2.358 -Burn-iso will guess the cdrom device and its speed, and wodim 2.359 -(part of cdrkit) will begin to burn an ISO image. The default 2.360 -ISO image is the one in the current configuration file, 2.361 -but it's possible to specify a different image via the 2.362 -command line: 2.363 -</p> 2.364 -<pre> 2.365 - # tazlito burn-iso 2.366 - # tazlito burn-iso slitaz-hacked.iso 2.367 -</pre> 2.368 - 2.369 -<h2>FLAVORS</h2> 2.370 -<p> 2.371 -A <i>.flavor</i> file contains just a few KB of information needed to 2.372 -(re)manufacture a custom LiveCD of SliTaz. 2.373 -</p> 2.374 - 2.375 -<a name="rebuild-flavor"></a> 2.376 -<h3><font color="#6c0023">Manufacture a flavor</font></h3> 2.377 -<p> 2.378 -You can choose the flavor to (re)manufacture from among those available: 2.379 -</p> 2.380 -<pre> 2.381 -# tazlito list-flavors 2.382 - 2.383 -List of flavors 2.384 -================================================================================ 2.385 -Name ISO Rootfs Description 2.386 -================================================================================ 2.387 -base 6.9M 13.1M Minimal set of packages to boot 2.388 -core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives 2.389 -core 31.5M 104.6M SliTaz core system 2.390 -eeepc 31.2M 105.4M SliTaz eeepc system 2.391 -justX 16.1M 51.2M SliTaz with a minimal X environment 2.392 -</pre> 2.393 -<p> 2.394 -We will start by remanufacturing the <i>eeepc</i> flavor which uses 105.4M of RAM 2.395 -and has a CD-ROM size of 31.2M: 2.396 -</p> 2.397 -<pre> 2.398 -# tazlito clean-distro 2.399 -# tazlito get-flavor eeepc 2.400 -# tazlito gen-distro 2.401 -</pre> 2.402 - 2.403 -<a name="create-flavor"></a> 2.404 -<h3><font color="#6c0023">Create a flavor</font></h3> 2.405 -<p> 2.406 -To create a flavor, you must: 2.407 -</p> 2.408 -<ul> 2.409 - <li>Either create an ISO image with <b>tazlito gen-distro</b> and then create 2.410 - a flavor file with <b>tazlito gen-flavor</b></li> 2.411 - <li>Either directly create the tree structure that defines the flavor 2.412 - (see <b>tazlito extract-flavor</b>) and then create the flavor with 2.413 - <b>tazlito pack-flavor</b></li> 2.414 -</ul> 2.415 - 2.416 -<a name="publish-flavor"></a> 2.417 -<h3><font color="#6c0023">Post a flavor</font></h3> 2.418 -<p> 2.419 -Because a .flavor file contains just a few KB; it can be easily sent via the 2.420 -mailing list. 2.421 -</p> 2.422 -<p> 2.423 -The results of <b>tazlito extract flavor</b> can also be put in mercurial 2.424 -(http://repos.slitaz.org/flavors). This method is preferred because the 2.425 -tree will be directly visible with the mercurial web interface. 2.426 -</p> 2.427 -<p> 2.428 -This tree includes: 2.429 -</p> 2.430 -<ul> 2.431 -<li> 2.432 -A <b>receipt</b> file describing the flavor thanks to the variables: 2.433 - <ul> 2.434 - <li> 2.435 -FLAVOR: The flavor name. 2.436 - </li> 2.437 - <li> 2.438 -SHORT_DESC: Short description. 2.439 - </li> 2.440 - <li> 2.441 -VERSION: Free format. 2.442 - </li> 2.443 - <li> 2.444 -MAINTAINER: Email address of maintainer. 2.445 - </li> 2.446 - <li> 2.447 -FRUGAL_RAM: Minimum RAM required (optional). 2.448 - </li> 2.449 - <li> 2.450 -ROOTFS_SIZE: Size of rootfs.gz decompressed into RAM (optional). 2.451 - </li> 2.452 - <li> 2.453 -INITRAMFS_SIZE: Size of rootfs.gz on the CD-ROM (optional). 2.454 - </li> 2.455 - <li> 2.456 -ISO_SIZE: Size of CD-ROM (optional). 2.457 - </li> 2.458 - <li> 2.459 -ROOTFS_SELECTION: Optional, see <i>Meta flavor</i> below. 2.460 - </li> 2.461 - </ul> 2.462 -</li> 2.463 -<li> 2.464 -The file <b>packages.list</b> containing the list of packages without 2.465 -specifying the version (tazlito uses the latest available). 2.466 -This file is missing if ROOTFS_SELECTION exists in the receipt. 2.467 -</li> 2.468 -<li> 2.469 -The optional <b>mirrors</b> file containing the list of unofficial mirrors 2.470 -(undigest) to be added to include personal packages. 2.471 -</li> 2.472 -<li> 2.473 -The optional directory <b>rootfs</b> containing the tree to add to the 2.474 -root filesystem rootfs.gz (configuration files usually). 2.475 -</li> 2.476 -<li> 2.477 -The optional directory <b>rootcd</b> containing the tree to add to the 2.478 -root of the CD-ROM. 2.479 -</li> 2.480 -</ul> 2.481 - 2.482 -<a name="tune-flavor"></a> 2.483 -<h3><font color="#6c0023">Adapt a flavor</font></h3> 2.484 -<p> 2.485 -It is often easier to modify an existing flavor than to create one from 2.486 -scratch. To adapt the eeepc flavor for example: 2.487 -</p> 2.488 -<pre> 2.489 -# tazpkg get-install mercurial 2.490 -# cd /home/slitaz 2.491 -# hg clone http://hg.slitaz.org/flavors 2.492 -# cd flavors 2.493 -# cp -a eeepc myslitaz 2.494 -</pre> 2.495 -<p> 2.496 -Files in my-slitaz can then be adapted, and: 2.497 -</p> 2.498 -<pre> 2.499 -# tazlito pack-flavor myslitaz 2.500 -</pre> 2.501 -<p> 2.502 -Will simply create the new flavor. 2.503 -</p> 2.504 - 2.505 -<a name="meta-flavor"></a> 2.506 -<h3><font color="#6c0023">Meta flavor</font></h3> 2.507 -<p> 2.508 -A meta flavor contains several flavors like nested Russian dolls. The flavor 2.509 -will be launched at startup according to the amount of RAM available. 2.510 -The ROOTFS_SELECTION variable defines the minimim RAM and corresponding 2.511 -flavor parameters, <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"> 2.512 -example</a>: 2.513 -</p> 2.514 -<pre> 2.515 -ROOTFS_SELECTION="160M core 96M justX 32M base" 2.516 -</pre> 2.517 -<p> 2.518 -A meta flavor doesn't contain a list of packages (packages.list). SliTaz 2.519 -kernels prior to 2.6.30 do not support meta flavors. 2.520 -</p> 2.521 - 2.522 -<h2>MAINTAINER</h2> 2.523 -<p> 2.524 -Christophe Lincoln <pankso at slitaz.org> 2.525 -</p> 2.526 - 2.527 -<!-- End content --> 2.528 -</div> 2.529 -</body> 2.530 -</html> 2.531 -
3.1 --- a/en/doc/manuals/tazpkg.en.html Sun Feb 21 22:47:28 2010 +0100 3.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 3.3 @@ -1,443 +0,0 @@ 3.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 3.5 - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 3.7 -<head> 3.8 - <title>Tazpkg Manual</title> 3.9 - <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 3.10 - <meta name="description" content="" /> 3.11 - <meta name="expires" content="never" /> 3.12 - <meta name="modified" content="2008-07-18 19:45:00" /> 3.13 - <style type="text/css"><!-- 3.14 - body { font: 90% sans-serif, vernada, arial; margin: 0; } 3.15 - #header { background: #f0ba08; color: black; height: 50px; 3.16 - border-top: 1px solid black; border-bottom: 1px solid black; } 3.17 - #content { margin: 0px 50px 26px 50px; } 3.18 - h1 { margin: 14px 0px 0px 16px; } 3.19 - li { line-height: 1.4em; } 3.20 - pre { padding: 5px; color: black; background: #e1e0b0; } 3.21 - pre.script { padding: 10px; color: black; background: #e8e8e8; 3.22 - border: 1px inset #333333; } 3.23 - code { font-size: 100%; color: #669900; background: transparent; } 3.24 - hr { color: white; background: white; height: 1px; border: 0; } 3.25 - --></style> 3.26 -</head> 3.27 -<body bgcolor="#ffffff"> 3.28 -<div id="header"> 3.29 -<h1><font color="#3e1220">Tazpkg Manual</font></h1> 3.30 -</div> 3.31 -<hr /> 3.32 -<!-- Start content --> 3.33 -<div id="content"> 3.34 - 3.35 -<h2>NAME</h2> 3.36 -<p> 3.37 -Tazpkg - Tiny autonomous zone package manager 3.38 -</p> 3.39 - 3.40 -<h2>SYNTAX</h2> 3.41 -<pre> 3.42 - tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt] 3.43 -</pre> 3.44 - 3.45 -<h2>DESCRIPTION</h2> 3.46 -<p> 3.47 -Tazpkg is an ultralightweight (~ 35KB) package manager to 3.48 -install, list, download, update or remove precompiled packages 3.49 -on a GNU/Linux system. Tazpkg offers commands for searching 3.50 -and creating packages and was created independently. 3.51 -The format of the packages using the *.tazpkg extension is a 3.52 -cpio archive containing a filesystem compressed with gzip, 3.53 -a receipt and an optional description. Tazpkg also manages 3.54 -dependencies based on package receipts. Each receipt contains 3.55 -all the information about a package and can also include 3.56 -pre and post installation functions. The same receipt is 3.57 -used by Tazwok to compile sources and generate a .tazpkg 3.58 -package. 3.59 -</p> 3.60 -<p> 3.61 -Tazpkg is entirely built from scratch using SHell script, 3.62 -compatible with Bash, it runs under Ash - part of the Busybox 3.63 -project. Tazpkg is distributed under the free GNU license GPL V3. 3.64 -</p> 3.65 - 3.66 -<h2>COMMANDS</h2> 3.67 -<h3><font color="#6c0023">list</font></h3> 3.68 -<p> 3.69 -List packages installed on the system. This command displays 3.70 -a column list of all installed packages, It also allows you to list the 3.71 -categories, packages based on category and packages placed on hold. 3.72 -You can also use the 'search' command for a list based 3.73 -on a term or package name: 3.74 -</p> 3.75 -<pre> 3.76 - # tazpkg list 3.77 - # tazpkg list cat|categories 3.78 - # tazpkg list blocked 3.79 -</pre> 3.80 -<a name="xhtml-list"></a> 3.81 -<h3><font color="#6c0023">xhtml-list</font></h3> 3.82 -<p> 3.83 -The 'xhtml-list' command can create a XHTML list 3.84 -of all the packages installed on the system which can be read 3.85 -with your preferred Web browser. It can be run as a normal 3.86 -user and creates a page 'installed-packages.html' in 3.87 -your current directory. Note that you can change the name of the 3.88 -generated list via the command line: 3.89 -</p> 3.90 -<pre> 3.91 - # tazpkg xhtml-list 3.92 - # tazpkg xhtml-list list-name.html 3.93 -</pre> 3.94 -<a name="list-mirror"></a> 3.95 -<h3><font color="#6c0023">list-mirror</font></h3> 3.96 -<p> 3.97 -List packages available on the mirror. This command will 3.98 -display the 'packages.list' file recharged from the mirror. 3.99 -If this doesn't exist, you will be asked to launch 3.100 -'tazpkg recharge' as administrator (root) for a list of 3.101 -available packages . The --diff option is used to display 3.102 -the differences between the last and current list of packages: 3.103 -</p> 3.104 -<pre> 3.105 - # tazpkg list-mirror 3.106 - # tazpkg list-mirror --diff 3.107 -</pre> 3.108 -<a name="info"></a> 3.109 -<h3><font color="#6c0023">info</font></h3> 3.110 -<p> 3.111 -Display any information available in the receipt for the 3.112 -package in question - its version, category, maintainer, 3.113 -Web site and any dependencies (see also Tazwok for more 3.114 -information on receipts): 3.115 -</p> 3.116 -<pre> 3.117 - # tazpkg info busybox 3.118 -</pre> 3.119 -<a name="desc"></a> 3.120 -<h3><font color="#6c0023">desc</font></h3> 3.121 -<p> 3.122 -Description of the package (if it exists). This command 3.123 -displays the 'description.txt' file of each package (a simple 3.124 -text file, justified to 80 characters to fit in a standard terminal): 3.125 -</p> 3.126 -<pre> 3.127 - # tazpkg desc busybox 3.128 -</pre> 3.129 -<a name="list-config"></a> 3.130 -<h3><font color="#6c0023">list-config</font></h3> 3.131 -<p> 3.132 -Lists the system configuration files. The --box option displays 3.133 -in table format: 3.134 -</p> 3.135 -<pre> # tazpkg list-config 3.136 - # tazpkg list-config --box 3.137 -</pre> 3.138 -<a name="list-files"></a> 3.139 -<h3><font color="#6c0023">list-files</font></h3> 3.140 -<p> 3.141 -List all files installed with a package. This command will 3.142 -simply read and display the 'files.list' of each package which is 3.143 -automatically generated when the package is created and is 3.144 -also used to remove files when uninstalling a package. 3.145 -To list the files installed with the package bc: 3.146 -</p> 3.147 -<pre> 3.148 - # tazpkg list-files bc 3.149 -</pre> 3.150 -<a name="search"></a> 3.151 -<h3><font color="#6c0023">search</font></h3> 3.152 -<p> 3.153 -Search for packages by owner or package name. This command 3.154 -will search for the term wanted in the installed packages and the 3.155 -list of available packages on the mirror. To obtain the 3.156 -latest list of installable packages on the mirror, just 3.157 -run 'tazpkg recharge' before conducting a search: 3.158 -</p> 3.159 -<pre> 3.160 - # tazpkg search gcc 3.161 -</pre> 3.162 -<a name="search-file"></a> 3.163 -<h3><font color="#6c0023">search-file</font></h3> 3.164 -<p> 3.165 -The 'search-file' command allows you to search for a file 3.166 -among the files installed by the packages. This command is very 3.167 -useful to find the full path to a file and determine if 3.168 -a file is present on the system. Example: 3.169 -</p> 3.170 -<pre> 3.171 - $ tazpkg search-file libnss 3.172 -</pre> 3.173 -<a name="install"></a> 3.174 -<h3><font color="#6c0023">install</font></h3> 3.175 -<p> 3.176 -This command allows the installation of a local package with 3.177 -the .tazpkg extension. See 'get-install' to install a 3.178 -package from the internet. Note that you can force the 3.179 -installation via the --forced, uninstall and reinstall options 3.180 -or specify the root system where you want to install the 3.181 -packages via the -root= option: 3.182 -</p> 3.183 -<pre> 3.184 - # tazpkg install package-1.0.tazpkg 3.185 - Or : 3.186 - # tazpkg install path/to/package-1.0.tazpkg --forced 3.187 - Or : 3.188 - # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs 3.189 -</pre> 3.190 -<h3><font color="#6c0023">install-list or get-install-list</font></h3> 3.191 -<p> 3.192 -Install a set of packages listed in a file. This command 3.193 -allows you to (download and) install several packages with a single command 3.194 -and can also be forced: 3.195 -</p> 3.196 -<pre> # tazpkg install-list my-packages.list 3.197 - # tazpkg get-install-list my-packages.list --forced 3.198 -</pre> 3.199 -<a name="link"></a> 3.200 -<h3><font color="#6c0023">link</font></h3> 3.201 -<p> 3.202 -This command allows the installation of a package from another media 3.203 -device. The set up is done through symbolic links and consumes very little 3.204 -memory. It is generally used within the system RAM to install add-ons 3.205 -from an USB key: 3.206 -</p> 3.207 -<pre> 3.208 - # tazpkg link openoffice /media/usbdisk 3.209 -</pre> 3.210 -<a name="remove"></a> 3.211 -<h3><font color="#6c0023">remove</font></h3> 3.212 -<p> 3.213 -Remove a package. You will be asked for confirmation (y/N). 3.214 -This command will delete all files installed with the package. 3.215 -To view the list of files, use the 'list-files' command 3.216 -followed by the name of the package. Example 3.217 -with the package bc: 3.218 -</p> 3.219 -<pre> 3.220 - # tazpkg remove bc 3.221 -</pre> 3.222 -<a name="extract"></a> 3.223 -<h3><font color="#6c0023">extract</font></h3> 3.224 -<p> 3.225 -Extract a package into a directory. If you do not specify 3.226 -the destination directory, the package will be extracted 3.227 -in the current directory using the name package-version: 3.228 -</p> 3.229 -<pre> 3.230 - # tazpkg extract package.tazpkg 3.231 - # tazpkg extract package.tazpkg target/dir 3.232 -</pre> 3.233 -<a name="pack"></a> 3.234 -<h3><font color="#6c0023">pack</font></h3> 3.235 -<p> 3.236 -The 'pack' command will create a package from a directory 3.237 -prepared in advance or from an unpacked package. It can 3.238 -also manually create a .tazpkg package (see the Tazwok documentation 3.239 -for the automatic creation of packages). To pack a package: 3.240 -</p> 3.241 -<pre> 3.242 - # tazpkg pack package-version 3.243 -</pre> 3.244 -<a name="repack"></a> 3.245 -<h3><font color="#6c0023">repack</font></h3> 3.246 -<p> 3.247 -The 'repack' command allows you to recreate a package from 3.248 -the files on a system where it was previously installed. 3.249 -To repack a package: 3.250 -</p> 3.251 -<pre> 3.252 - # tazpkg repack package 3.253 -</pre> 3.254 -<a name="repack-config"></a> 3.255 -<h3><font color="#6c0023">repack-config</font></h3> 3.256 -<p> 3.257 -The 'repack-config' command recreates a package 3.258 -of the system configuration files (see list-config). It is enough 3.259 -to install the package to find the current configuration. To repack 3.260 -the configuration files: 3.261 -</p> 3.262 -<pre> # tazpkg repack-config 3.263 -</pre> 3.264 -<a name="recharge"></a> 3.265 -<h3><font color="#6c0023">recharge</font></h3> 3.266 -<p> 3.267 -Recharge the list of available packages on the mirror. 3.268 -This command will download the most recent 'packages.list' 3.269 -of installable packages on the mirror and before starting 3.270 -will save the old list. Once the list is updated 3.271 -you can then use the 'list' and 'search' commands. To view 3.272 -and list the differences, you can use 'list-mirror --diff', and to view 3.273 -and update packages, you can simply 'upgrade'. To recharge the 3.274 -latest list of packages: 3.275 -</p> 3.276 -<pre> 3.277 - # tazpkg recharge 3.278 -</pre> 3.279 -<a name="upgrade"></a> 3.280 -<h3><font color="#6c0023">upgrade</font></h3> 3.281 -<p> 3.282 -Upgrade allows you to update all installed packages available 3.283 -on the current mirror. Upgrading packages is an important 3.284 -part of system security, it helps to keep you secure with 3.285 -the latest updates and fixes. The SliTaz project, 3.286 -although tiny, provides regular updates on security and generally 3.287 -offers the latest versions of software. Note that this 3.288 -function is aimed at people with SliTaz installed on a 3.289 -hard drive. Updated packages in LiveCD mode will be lost on 3.290 -system shutdown. To upgrade: 3.291 -</p> 3.292 -<pre> 3.293 - # tazpkg upgrade 3.294 -</pre> 3.295 -<a name="check"></a> 3.296 -<h3><font color="#6c0023">check</font></h3> 3.297 -<p> 3.298 -The 'check' command can check dependencies on installed 3.299 -packages and determine whether all the files needed for the 3.300 -repacking of packages are present: 3.301 -</p> 3.302 -<pre> 3.303 - # tazpkg check package 3.304 -</pre> 3.305 -<a name="block"></a> 3.306 -<h3><font color="#6c0023">block or unblock</font></h3> 3.307 -<p> 3.308 -The 'block' and 'unblock' commands permit you to block 3.309 -installed package versions so that they are not maintained 3.310 -by an 'upgrade'. The list of packages on hold are contained 3.311 -in the /var/lib/tazpkg/blocked-packages.list. This file can also 3.312 -be edited by hand. To block or unblock a package such as 3.313 -Grub: 3.314 -</p> 3.315 -<pre> 3.316 - # tazpkg block grub 3.317 - Or : 3.318 - # tazpkg unblock grub 3.319 -</pre> 3.320 -<a name="get"></a> 3.321 -<h3><font color="#6c0023">get</font></h3> 3.322 -<p> 3.323 -Get a package from the mirror (if it exists). The downloaded 3.324 -package is stored in the current directory. To find the path 3.325 -you can use 'pwd'. To get the Grub package: 3.326 -</p> 3.327 -<pre> 3.328 - # tazpkg get grub 3.329 -</pre> 3.330 -<a name="get-install"></a> 3.331 -<h3><font color="#6c0023">get-install</font></h3> 3.332 -<p> 3.333 -Get and install a package from a mirror on the internet. 3.334 -The 'get-install' command begins by checking whether the 3.335 -package exists on the mirror and if it has been already downloaded. 3.336 -For a list of packages on the mirror, we must 3.337 -use the 'list-mirror' command. To install the package Grub: 3.338 -</p> 3.339 -<pre> 3.340 - # tazpkg get-install grub 3.341 -</pre> 3.342 -<a name="clean-cache"></a> 3.343 -<h3><font color="#6c0023">clean-cache</font></h3> 3.344 -<p> 3.345 -Remove *.tazpkg packages downloaded to the cache. During 3.346 -installation, Tazpkg keeps a copy of packages downloaded 3.347 -from the web. This is done to save bandwidth in case of 3.348 -reinstallation, but you may want to free up space on the hard 3.349 -drive or re-download the packages: 3.350 -</p> 3.351 -<pre> 3.352 - # tazpkg clean-cache 3.353 -</pre> 3.354 -<a name="setup-mirror"></a> 3.355 -<h3><font color="#6c0023">setup-mirror</font></h3> 3.356 -<p> 3.357 -Setup the URL for the mirror. The 'setup-mirror' command 3.358 -will ask for the URL of the new mirror. You can specify 3.359 -multiple URLs separated by spaces. Note that you can also 3.360 -modify the main /var/lib/tazpkg/mirror file. The URL must 3.361 -point to the directory containing the 'packages.list' and 3.362 -packages: 3.363 -</p> 3.364 -<pre> 3.365 - # tazpkg setup-mirror 3.366 -</pre> 3.367 -<a name="reconfigure"></a> 3.368 -<h3><font color="#6c0023">reconfigure</font></h3> 3.369 -<p> 3.370 -Replays the post-install script from the package. 3.371 -Example using gcc: 3.372 -</p> 3.373 -<pre> # tazpkg reconfigure gcc 3.374 -</pre> 3.375 -<a name="depends"></a> 3.376 -<h3><font color="#6c0023">depends or rdepends</font></h3> 3.377 -<p> 3.378 -Displays a dependency tree or reverse dependency tree for a package. 3.379 -Examples using mpd: 3.380 -</p> 3.381 -<pre> # tazpkg depends mpd 3.382 - # tazpkg rdepends mpd 3.383 -</pre> 3.384 -<a name="add-undigest"></a> 3.385 -<h3><font color="#6c0023">add-undigest or setup-undigest</font></h3> 3.386 -<p> 3.387 -Set the URL of an additional unofficial mirror to test packages that 3.388 -are not yet present on the official mirrors. Note, you can also 3.389 -manually edit the file in /var/lib/tazpkg/undigest/'repository'. The URL 3.390 -must point to the directory containing the packages and 'packages.list': 3.391 -</p> 3.392 -<pre> 3.393 - # tazpkg add-undigest public-repository http://my.home.org/slitaz 3.394 - # tazpkg setup-undigest local-repository /home/slitaz/packages 3.395 -</pre> 3.396 -<a name="remove-undigest"></a> 3.397 -<h3><font color="#6c0023">remove-undigest</font></h3> 3.398 -<p> 3.399 -Removes the URL of an undigest mirror: 3.400 -</p> 3.401 -<pre> 3.402 - # tazpkg remove-undigest my-repository 3.403 -</pre> 3.404 -<a name="list-undigest"></a> 3.405 -<h3><font color="#6c0023">list-undigest</font></h3> 3.406 -<p> 3.407 -Lists additional undigest mirrors: 3.408 -</p> 3.409 -<pre> 3.410 - # tazpkg list-undigest 3.411 -</pre> 3.412 -<a name="convert"></a> 3.413 -<h3><font color="#6c0023">convert</font></h3> 3.414 -<p> 3.415 -Converts a Debian package (.deb), Redhat (.rpm), Slackware (.tgz) or 3.416 -Archlinux (.pkg.tar.gz) package into a SliTaz package (.tazpkg): 3.417 -</p> 3.418 -<pre> 3.419 - # tazpkg convert alien-package 3.420 -</pre> 3.421 -<a name="set-release"></a> 3.422 -<h3><font color="#6c0023">set-release</font></h3> 3.423 -<p> 3.424 -The 'set-release' command changes the current version and 3.425 -upgrades the packages to the latest release: 3.426 -</p> 3.427 -<pre> # tazpkg set-release cooking 3.428 -</pre> 3.429 -<a name="bugs"></a> 3.430 -<h3><font color="#6c0023">bugs</font></h3> 3.431 -<p> 3.432 -Generates a list of known bugs in the packages: 3.433 -</p> 3.434 -<pre> # tazpkg bugs 3.435 -</pre> 3.436 - 3.437 -<h2>MAINTAINER</h2> 3.438 -<p> 3.439 -Christophe Lincoln <pankso at slitaz.org> 3.440 -</p> 3.441 - 3.442 -</div> 3.443 -<!-- End content --> 3.444 -</body> 3.445 -</html> 3.446 -
4.1 --- a/en/doc/manuals/tazusb.en.html Sun Feb 21 22:47:28 2010 +0100 4.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 4.3 @@ -1,141 +0,0 @@ 4.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 4.5 - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 4.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 4.7 -<head> 4.8 - <title>TazUSB - SliTaz Live utility English manual</title> 4.9 - <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 4.10 - <meta name="description" content="slitaz bootable media LiveUSB key hd SD card" /> 4.11 - <meta name="expires" content="never" /> 4.12 - <meta name="modified" content="2008-07-18 20:00:00" /> 4.13 - <style type="text/css"><!-- 4.14 - body { font: 90% sans-serif, vernada, arial; margin: 0; } 4.15 - #header { background: #f0ba08; color: black; height: 50px; 4.16 - border-top: 1px solid black; border-bottom: 1px solid black; } 4.17 - #content { margin: 0px 50px 26px 50px; } 4.18 - h1 { margin: 14px 0px 0px 16px; } 4.19 - li { line-height: 1.4em; } 4.20 - pre { padding: 5px; color: black; background: #e1e0b0; } 4.21 - pre.script { padding: 10px; color: black; background: #e8e8e8; 4.22 - border: 1px inset #333333; } 4.23 - code { font-size: 100%; color: #669900; background: transparent; } 4.24 - hr { color: white; background: white; height: 1px; border: 0; } 4.25 - --></style> 4.26 -</head> 4.27 -<body bgcolor="#ffffff"> 4.28 -<div id="header"> 4.29 -<h1><font color="#3e1220">TazUSB Manual</font></h1> 4.30 -</div> 4.31 -<hr /> 4.32 -<!-- Start content --> 4.33 -<div id="content"> 4.34 - 4.35 -<h2>NAME</h2> 4.36 -<p> 4.37 -TazUSB - SliTaz LiveUSB utility 4.38 -</p> 4.39 - 4.40 -<h2>SYNTAX</h2> 4.41 -<pre> 4.42 -tazusb [command] [compression|device|file] 4.43 -</pre> 4.44 - 4.45 -<h2>DESCRIPTION</h2> 4.46 -<p> 4.47 -TazUSB is a utility designed for installing SliTaz to a USB drive. Unlike a hard drive install, the filesystem is kept in a compressed "rootfs.gz" file. The filesystem is loaded entirely into memory upon boot. This should increase responsiveness, protect the filesystem against accidental corruption and reduce read/writes to the USB drive. Once setup, this utility can also rewrite the root filesystem with any changes you have made since booting up, giving the effective benefits of a hard drive install. 4.48 -</p> 4.49 -<p> 4.50 -TazUSB supports both FAT32/EXT3 formatted drives using SYSLINUX and EXTLINUX respectively. "/home" is mounted on boot using the UUID of your particular flash drive. Unlike a device name, the UUID has the benefit of never changing from machine to machine. 4.51 -</p> 4.52 - 4.53 -<h2>COMMANDS</h2> 4.54 -<a name="usage"></a> 4.55 -<h3><font color="#6c0023">usage</font></h3> 4.56 -<p> 4.57 -The command 'usage' will display a short summary of all available commands. 4.58 -</p> 4.59 -<pre> 4.60 - # tazusb usage 4.61 -</pre> 4.62 - 4.63 -<a name="writefs"></a> 4.64 -<h3><font color="#6c0023">writefs</font></h3> 4.65 -<p> 4.66 -The command 'writefs' will take the current memory resident filesystem and create a "rootfs.gz" file. If your flash drive is mounted as /home (as it should be), the new filesystem will be copied to the drive for you, otherwise it is left on the root of the drive. Your previous filesystem will be renamed to "previous.gz" and can be accessed on bootup by typing "previous" at the "boot:" prompt. All previous filesystems are renamed to rootfs.gz.unixtimestamp. These are not removed automatically, so you should periodically delete these to keep disk usage down. 4.67 -</p> 4.68 -<p> 4.69 -Filesystem compression is supported in the form of lzma, gzip or none. Using no compression is very quick (under 5 seconds) and useful if you are experimenting with a lot of changes. By comparison, using lzma or gzip takes a few minutes but will dramatically reduce file size. This is recommended when committing permanent changes to the filesystem. 4.70 -</p> 4.71 -<pre> 4.72 - # tazusb writefs compression 4.73 -</pre> 4.74 -Example: 4.75 -<pre> 4.76 - # tazusb writefs lzma 4.77 -</pre> 4.78 - 4.79 -<a name="format"></a> 4.80 -<h3><font color="#6c0023">format</font></h3> 4.81 -<p> 4.82 -The command 'format' is used for formatting a device for use as a LiveUSB device. Currently, it only supports formatting as EXT3. 4.83 -</p> 4.84 -<pre> 4.85 - # tazusb format /dev/name 4.86 -</pre> 4.87 -Example: 4.88 -<pre> 4.89 - # tazusb format /dev/sda1 4.90 -</pre> 4.91 - 4.92 -<a name="gen-liveusb"></a> 4.93 -<h3><font color="#6c0023">gen-liveusb</font></h3> 4.94 -<p> 4.95 -"gen-liveusb" will install a fresh MBR, set your partition as bootable and install syslinux/extlinux depending on the detected filesystem. It will then copy the kernel and filesystem from the CDROM drive, and place this on the target USB drive. This will leave you with a bootable USB copy of SliTaz. 4.96 -</p> 4.97 -<pre> 4.98 - # tazusb gen-liveusb /dev/name 4.99 -</pre> 4.100 -Example: 4.101 -<pre> 4.102 - # tazusb gen-liveusb /dev/sda1 4.103 -</pre> 4.104 - 4.105 -<a name="gen-swap"></a> 4.106 -<h3><font color="#6c0023">gen-swap</font></h3> 4.107 -<p> 4.108 -The 'gen-swap' command re/creates a virtual swap file and places 4.109 -it in the /home directory to be activated on each boot. This is useful 4.110 -for old systems with low memory. 4.111 -</p> 4.112 -<pre> # tazusb gen-swap 4.113 -</pre> 4.114 - 4.115 -<a name="gen-iso2usb"></a> 4.116 -<h3><font color="#6c0023">gen-iso2usb</font></h3> 4.117 -<p> 4.118 -This command performs the same task as gen-liveusb, only copying the Kernel 4.119 -and filesystem from a downloaded ISO image instead of the CDROM drive. 4.120 -</p> 4.121 -<pre> # tazusb gen-iso2usb /path/to/iso 4.122 -</pre> 4.123 -Example: 4.124 -<pre> # tazusb gen-iso2usb /home/tux/slitaz.iso 4.125 -</pre> 4.126 - 4.127 -<a name="clean"></a> 4.128 -<h3><font color="#6c0023">clean</font></h3> 4.129 -<p> 4.130 -"clean" removes old rootfs.gz.unixtimestamp filesystems (see writefs) 4.131 -to keep disk usage down. 4.132 -</p> 4.133 -<pre> # tazusb clean 4.134 -</pre> 4.135 - 4.136 -<h2>MAINTAINER</h2> 4.137 -<p> 4.138 -Eric Joseph-Alexandre <erjo at slitaz.org> 4.139 -</p> 4.140 - 4.141 -<!-- End content --> 4.142 -</div> 4.143 -</body> 4.144 -</html>
5.1 --- a/en/doc/manuals/tazwok.en.html Sun Feb 21 22:47:28 2010 +0100 5.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 5.3 @@ -1,225 +0,0 @@ 5.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 5.5 - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 5.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 5.7 -<head> 5.8 - <title>Tazwok Manual</title> 5.9 - <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 5.10 - <meta name="description" content="" /> 5.11 - <meta name="expires" content="never" /> 5.12 - <meta name="modified" content="2008-07-18 20:30:00" /> 5.13 - <style type="text/css"><!-- 5.14 - body { font: 90% sans-serif, vernada, arial; margin: 0; } 5.15 - #header { background: #f0ba08; color: black; height: 50px; 5.16 - border-top: 1px solid black; border-bottom: 1px solid black; } 5.17 - #content { margin: 0px 50px 26px 50px; } 5.18 - h1 { margin: 14px 0px 0px 16px; } 5.19 - li { line-height: 1.4em; } 5.20 - pre { padding: 5px; color: black; background: #e1e0b0; } 5.21 - pre.script { padding: 10px; color: black; background: #e8e8e8; 5.22 - border: 1px inset #333333; } 5.23 - code { font-size: 100%; color: #669900; background: transparent; } 5.24 - hr { color: white; background: white; height: 1px; border: 0; } 5.25 - --></style> 5.26 -</head> 5.27 -<body bgcolor="#ffffff"> 5.28 -<div id="header"> 5.29 -<h1><font color="#3e1220">Tazwok Manual</font></h1> 5.30 -</div> 5.31 -<hr /> 5.32 -<!-- Start content --> 5.33 -<div id="content"> 5.34 - 5.35 -<h2>NAME</h2> 5.36 -<p> 5.37 -Tazwok - SliTaz sources and packages cooker. 5.38 -</p> 5.39 - 5.40 -<h2>SYNTAX</h2> 5.41 -<pre> tazwok [command] [package|list|category|dir] [--option] 5.42 -</pre> 5.43 - 5.44 -<h2>DESCRIPTION</h2> 5.45 -<p> 5.46 -Tazwok is a command line tool to configure and compile a package from source. Tazwok can also create packages 5.47 -ready to be used by Tazpkg, the SliTaz package manager. To work, Tazwok uses a directory containing 5.48 -the receipt and the necessary information (stuff) for the construction of the package. This receipt is also used by 5.49 -Tazpkg and consists of different variables and functions. Tazwok uses a configuration file (/etc/tazwok.conf) 5.50 -to find the path to the wok, the package sources, and any generated .tazpkg packages. Tazwok can also generate 5.51 -a list of packages with their md5, create packages interactively, search for packages in the wok, clean generated files and even 5.52 -cook several packages at once (See available commands). 5.53 -</p> 5.54 -<p> 5.55 -Tazwok is entirely built from scratch using SHell script, compatible with Bash, it runs under Ash - 5.56 -part of the Busybox project. Tazwok is distributed under the free GNU license GPL V3. The SliTaz 5.57 -Cookbook also provides documentation about Tazwok and the package receipts. 5.58 -</p> 5.59 - 5.60 -<h2>COMMANDS</h2> 5.61 -<a name="usage"></a> 5.62 -<h3><font color="#6c0023">usage</font></h3> 5.63 -<p> 5.64 -Usage displays a summary of available commands with a short description in English: 5.65 -</p> 5.66 -<pre> # tazwok usage 5.67 -</pre> 5.68 -<a name="stats"></a> 5.69 -<h3><font color="#6c0023">stats</font></h3> 5.70 -<p> 5.71 -Stats displays information contained in the configuration file and the number of packages 5.72 -available in the wok: 5.73 -</p> 5.74 -<pre> # tazwok stats 5.75 -</pre> 5.76 -<a name="list"></a> 5.77 -<h3><font color="#6c0023">list</font></h3> 5.78 -<p> 5.79 -List allows you to list all the packages contained in the wok or the default categories 5.80 -(you can create your own). It can also list packages by category: 5.81 -</p> 5.82 -<pre> # tazwok list 5.83 - # tazwok list category 5.84 -</pre> 5.85 -<a name="info"></a> 5.86 -<h3><font color="#6c0023">info</font></h3> 5.87 -<p> 5.88 -This command provides information on the package - name, version, etc. Info on the basic package receipt 5.89 -is the same as displayed by Tazpkg and the installed packages: 5.90 -</p> 5.91 -<pre> # tazwok info package 5.92 -</pre> 5.93 -<a name="check-log"></a> 5.94 -<h3><font color="#6c0023">check-log</font></h3> 5.95 -<p> 5.96 -When compiling a binary source, Tazwok generates a few messages stored in the file 5.97 -'process.log'. To view: 5.98 -</p> 5.99 -<pre> # tazwok check-log package 5.100 -</pre> 5.101 -<a name="search"></a> 5.102 -<h3><font color="#6c0023">search</font></h3> 5.103 -<p> 5.104 -Search allows you to search for packages in the wok. You can specify a term or package name: 5.105 -</p> 5.106 -<pre> # tazwok search name 5.107 -</pre> 5.108 -<a name="compile"></a> 5.109 -<h3><font color="#6c0023">compile</font></h3> 5.110 -<p> 5.111 -This command uses the compilation rules (compile_rules) specified in the receipt for the package in 5.112 -question to compile the sources. Note compilation rules are not always necessary - packages 5.113 -generated by 'genpkg' and 'cook' can also compile sources and generate the binary package. 5.114 -Example: 5.115 -</p> 5.116 -<pre> # tazwok compile package 5.117 -</pre> 5.118 -<a name="genpkg"></a> 5.119 -<h3><font color="#6c0023">genpkg</font></h3> 5.120 -<p> 5.121 -Genpkg will generate the .tazpkg package using the 'genpkg_rules' found in the receipt. 5.122 -Once the package is generated, it's stored in the repository of packages specified in the configuration 5.123 -file ('tazwok stats' to view). The package can be used by Tazpkg or Tazlito to generate a LiveCD 5.124 -distribution. Note that the standard files such as local, pixmap or name.desktop are automatically copied 5.125 -to $fs/usr/share, provided the paths are standard or if the file exists in /stuff. Example using 'genpkg': 5.126 -</p> 5.127 -<pre> # tazwok genpkg package 5.128 -</pre> 5.129 -<a name="cook"></a> 5.130 -<h3><font color="#6c0023">cook</font></h3> 5.131 -<p> 5.132 -Cook will simply compile and generate the package: 5.133 -</p> 5.134 -<pre> # tazwok cook package 5.135 -</pre> 5.136 -<a name="cook-list"></a> 5.137 -<h3><font color="#6c0023">cook-list</font></h3> 5.138 -<p> 5.139 -This command will launch 'tazwok cook' on all the packages contained in the list file specified in the argument. 5.140 -Cook-list is used for example, to cook the base system (base-system) without glibc. On SliTaz, you will find 5.141 -examples of cooking lists in the directory /usr/share/examples/tazwok.cooklists: 5.142 -</p> 5.143 -<pre> # tazwok cook-list packages.cooklist 5.144 -</pre> 5.145 -<a name="clean"></a> 5.146 -<h3><font color="#6c0023">clean</font></h3> 5.147 -<p> 5.148 -Clean can simply delete all files generated by compiling and packaging: 5.149 -</p> 5.150 -<pre> # tazwok clean package 5.151 -</pre> 5.152 -<a name="new-tree"></a> 5.153 -<h3><font color="#6c0023">new-tree</font></h3> 5.154 -<p> 5.155 -The 'new-tree' command can create a new package in the wok and can be used interactively. It 5.156 -will create a directory of the package and a receipt that can then be edited with your favorite 5.157 -text editor. The receipt can also be configured using the '--interactive' option. For help you can look at existing 5.158 -receipts or read the documentation in the Cookbook. Example: 5.159 -</p> 5.160 -<pre> # tazwok new-tree package 5.161 - # tazwok new-tree package --interactive 5.162 -</pre> 5.163 -<a name="gen-list"></a> 5.164 -<h3><font color="#6c0023">gen-list</font></h3> 5.165 -<p> 5.166 -The 'gen-list' command can generate a list of packages (packages.list), their md5 (packages.md5) and a list 5.167 -of options containing information (packages.txt). The lists are created on the basis of packages 5.168 -contained in a directory. The list in text format is built using a receipt contained in a wok. The default 5.169 -packages directory is the one specified in the configuration file, you can also specify the directory on the 5.170 -command line. Examples: 5.171 -</p> 5.172 -<pre> # tazwok gen-list 5.173 - # tazwok gen-list --text 5.174 - # tazwok gen-list /path/to/repository 5.175 -</pre> 5.176 -<a name="gen-clean-wok"></a> 5.177 -<h3><font color="#6c0023">gen-clean-wok and clean-wok</font></h3> 5.178 -<p> 5.179 -The 'gen-clean-wok' command can create a new wok, this is useful to save a version of the wok, or create a new wok 5.180 -to test with another. Running 'clean-wok' will clean all packages in the current wok and delete any generated 5.181 -files. To generate a clean wok or clean the current wok: 5.182 -</p> 5.183 -<pre> # tazwok gen-clean-wok path/to/new-wok 5.184 - # tazwok clean-wok 5.185 -</pre> 5.186 -<a name="remove"></a> 5.187 -<h3><font color="#6c0023">remove</font></h3> 5.188 -<p> 5.189 -Removes the package specified from the wok, including the receipt, stuff, all files, etc: 5.190 -</p> 5.191 -<pre> # tazwok remove package 5.192 -</pre> 5.193 -<a name="build-depends"></a> 5.194 -<h3><font color="#6c0023">build-depends</font></h3> 5.195 -<p> 5.196 -Build-depends generates a list of packages to build a wok: 5.197 -</p> 5.198 -<pre> # tazwok build-depends 5.199 -</pre> 5.200 -<a name="compare"></a> 5.201 -<h3><font color="#6c0023">cmp|compare</font></h3> 5.202 -<p> 5.203 -Compares the wok and the cooked packages and generates a report. 5.204 -Obsolete packages can be deleted with the --remove option. 5.205 -The --cook option compiles the packages. Examples: 5.206 -</p> 5.207 -<pre> # tazwok compare 5.208 - # tazwok compare --remove 5.209 - # tazwok compare --cook 5.210 -</pre> 5.211 -<a name="check"></a> 5.212 -<h3><font color="#6c0023">check</font></h3> 5.213 -<p> 5.214 -Checks the receipts for common errors: 5.215 -</p> 5.216 -<pre> # tazwok check 5.217 -</pre> 5.218 - 5.219 -<h2>MAINTAINER</h2> 5.220 -<p> 5.221 -Christophe Lincoln <pankso at slitaz.org> 5.222 -</p> 5.223 - 5.224 -<!-- End content --> 5.225 -</div> 5.226 - 5.227 -</body> 5.228 -</html>