tazpkg rev 467
Update English Manaul (content and style)
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Fri Apr 08 15:15:01 2011 +0200 (2011-04-08) |
| parents | 3b65ee0dcc6d |
| children | fefb13793488 |
| files | doc/tazpkg.en.html |
line diff
1.1 --- a/doc/tazpkg.en.html Fri Apr 08 15:06:30 2011 +0200 1.2 +++ b/doc/tazpkg.en.html Fri Apr 08 15:15:01 2011 +0200 1.3 @@ -1,31 +1,26 @@ 1.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 1.5 - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.6 -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 1.7 +<!DOCTYPE html> 1.8 +<html xmlns="http://www.w3.org/1999/xhtml"> 1.9 <head> 1.10 <title>Tazpkg Manual</title> 1.11 - <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.12 - <meta name="description" content="" /> 1.13 - <meta name="expires" content="never" /> 1.14 - <meta name="modified" content="2008-07-18 19:45:00" /> 1.15 - <style type="text/css"><!-- 1.16 - body { font: 90% sans-serif, vernada, arial; margin: 0; } 1.17 - #header { background: #f0ba08; color: black; height: 50px; 1.18 - border-top: 1px solid black; border-bottom: 1px solid black; } 1.19 - #content { margin: 0px 50px 26px 50px; } 1.20 - h1 { margin: 14px 0px 0px 16px; } 1.21 - li { line-height: 1.4em; } 1.22 - pre { padding: 5px; color: black; background: #e1e0b0; } 1.23 - pre.script { padding: 10px; color: black; background: #e8e8e8; 1.24 - border: 1px inset #333333; } 1.25 - code { font-size: 100%; color: #669900; background: transparent; } 1.26 - hr { color: white; background: white; height: 1px; border: 0; } 1.27 - --></style> 1.28 + <meta charset="utf-8" /> 1.29 + <style type="text/css"> 1.30 + body { font: 88% sans-serif, vernada, arial; margin: 0; } 1.31 + #header { background:#351a0a; height: 40px; border-bottom: 8px solid#d66018; } 1.32 + #content { margin: 40px 80px; text-align: justify; } 1.33 + #footer { text-align: center; padding: 20px; border-top: 1px solid#ddd; } 1.34 + h1 { margin: 0; padding: 8px; color:#fff; font-size: 20px; } 1.35 + h2 { color:#444; } h3 { color:#666; font-size: 140%; } 1.36 + pre { background-color:#f8f8f8; border: 1px solid#ddd; padding: 10px; 1.37 + -moz-border-radius: 4px; -webkit-border-radius: 4px; border-radius: 4px;} 1.38 + </style> 1.39 </head> 1.40 -<body bgcolor="#ffffff"> 1.41 +<body> 1.42 + 1.43 +<body> 1.44 <div id="header"> 1.45 -<h1><font color="#3e1220">Tazpkg Manual</font></h1> 1.46 + <h1>Tazpkg Manual</h1> 1.47 </div> 1.48 -<hr /> 1.49 + 1.50 <!-- Start content --> 1.51 <div id="content"> 1.52 1.53 @@ -61,7 +56,7 @@ 1.54 </p> 1.55 1.56 <h2>COMMANDS</h2> 1.57 -<h3><font color="#6c0023">list</font></h3> 1.58 +<h3>list</h3> 1.59 <p> 1.60 List packages installed on the system. This command displays 1.61 a column list of all installed packages, It also allows you to list the 1.62 @@ -70,12 +65,13 @@ 1.63 on a term or package name: 1.64 </p> 1.65 <pre> 1.66 - # tazpkg list 1.67 - # tazpkg list cat|categories 1.68 - # tazpkg list blocked 1.69 +# tazpkg list 1.70 +# tazpkg list cat|categories 1.71 +# tazpkg list blocked 1.72 </pre> 1.73 + 1.74 <a name="xhtml-list"></a> 1.75 -<h3><font color="#6c0023">xhtml-list</font></h3> 1.76 +<h3>xhtml-list</h3> 1.77 <p> 1.78 The 'xhtml-list' command can create a XHTML list 1.79 of all the packages installed on the system which can be read 1.80 @@ -85,11 +81,12 @@ 1.81 generated list via the command line: 1.82 </p> 1.83 <pre> 1.84 - # tazpkg xhtml-list 1.85 - # tazpkg xhtml-list list-name.html 1.86 +# tazpkg xhtml-list 1.87 +# tazpkg xhtml-list list-name.html 1.88 </pre> 1.89 + 1.90 <a name="list-mirror"></a> 1.91 -<h3><font color="#6c0023">list-mirror</font></h3> 1.92 +<h3>list-mirror</h3> 1.93 <p> 1.94 List packages available on the mirror. This command will 1.95 display the 'packages.list' file recharged from the mirror. 1.96 @@ -99,11 +96,12 @@ 1.97 the differences between the last and current list of packages: 1.98 </p> 1.99 <pre> 1.100 - # tazpkg list-mirror 1.101 - # tazpkg list-mirror --diff 1.102 +# tazpkg list-mirror 1.103 +# tazpkg list-mirror --diff 1.104 </pre> 1.105 + 1.106 <a name="info"></a> 1.107 -<h3><font color="#6c0023">info</font></h3> 1.108 +<h3>info</h3> 1.109 <p> 1.110 Display any information available in the receipt for the 1.111 package in question - its version, category, maintainer, 1.112 @@ -111,29 +109,31 @@ 1.113 information on receipts): 1.114 </p> 1.115 <pre> 1.116 - # tazpkg info busybox 1.117 +# tazpkg info busybox 1.118 </pre> 1.119 <a name="desc"></a> 1.120 -<h3><font color="#6c0023">desc</font></h3> 1.121 +<h3>desc</h3> 1.122 <p> 1.123 Description of the package (if it exists). This command 1.124 displays the 'description.txt' file of each package (a simple 1.125 text file, justified to 80 characters to fit in a standard terminal): 1.126 </p> 1.127 <pre> 1.128 - # tazpkg desc busybox 1.129 +# tazpkg desc busybox 1.130 </pre> 1.131 + 1.132 <a name="list-config"></a> 1.133 -<h3><font color="#6c0023">list-config</font></h3> 1.134 +<h3>list-config</h3> 1.135 <p> 1.136 Lists the system configuration files. The --box option displays 1.137 in table format: 1.138 </p> 1.139 -<pre> # tazpkg list-config 1.140 - # tazpkg list-config --box 1.141 +<pre># tazpkg list-config 1.142 +# tazpkg list-config --box 1.143 </pre> 1.144 + 1.145 <a name="list-files"></a> 1.146 -<h3><font color="#6c0023">list-files</font></h3> 1.147 +<h3>list-files</h3> 1.148 <p> 1.149 List all files installed with a package. This command will 1.150 simply read and display the 'files.list' of each package which is 1.151 @@ -142,10 +142,11 @@ 1.152 To list the files installed with the package bc: 1.153 </p> 1.154 <pre> 1.155 - # tazpkg list-files bc 1.156 +# tazpkg list-files bc 1.157 </pre> 1.158 + 1.159 <a name="search"></a> 1.160 -<h3><font color="#6c0023">search</font></h3> 1.161 +<h3>search</h3> 1.162 <p> 1.163 Search for packages by owner or package name. This command 1.164 will search for the term wanted in the installed packages and the 1.165 @@ -154,10 +155,11 @@ 1.166 run 'tazpkg recharge' before conducting a search: 1.167 </p> 1.168 <pre> 1.169 - # tazpkg search gcc 1.170 +# tazpkg search gcc 1.171 </pre> 1.172 + 1.173 <a name="search-file"></a> 1.174 -<h3><font color="#6c0023">search-file</font></h3> 1.175 +<h3>search-file</h3> 1.176 <p> 1.177 The 'search-file' command allows you to search for a file 1.178 among the files installed by the packages. This command is very 1.179 @@ -167,8 +169,9 @@ 1.180 <pre> 1.181 $ tazpkg search-file libnss 1.182 </pre> 1.183 + 1.184 <a name="install"></a> 1.185 -<h3><font color="#6c0023">install</font></h3> 1.186 +<h3>install</h3> 1.187 <p> 1.188 This command allows the installation of a local package with 1.189 the .tazpkg extension. See 'get-install' to install a 1.190 @@ -178,23 +181,24 @@ 1.191 packages via the -root= option: 1.192 </p> 1.193 <pre> 1.194 - # tazpkg install package-1.0.tazpkg 1.195 - Or : 1.196 - # tazpkg install path/to/package-1.0.tazpkg --forced 1.197 - Or : 1.198 - # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs 1.199 +# tazpkg install package-1.0.tazpkg 1.200 +# tazpkg install path/to/package-1.0.tazpkg --forced 1.201 +# tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs 1.202 </pre> 1.203 -<h3><font color="#6c0023">install-list or get-install-list</font></h3> 1.204 + 1.205 +<a name="install-list"></a> 1.206 +<h3>install-list or get-install-list</h3> 1.207 <p> 1.208 Install a set of packages listed in a file. This command 1.209 allows you to (download and) install several packages with a single command 1.210 and can also be forced: 1.211 </p> 1.212 -<pre> # tazpkg install-list my-packages.list 1.213 - # tazpkg get-install-list my-packages.list --forced 1.214 +<pre># tazpkg install-list my-packages.list 1.215 +# tazpkg get-install-list my-packages.list --forced 1.216 </pre> 1.217 + 1.218 <a name="link"></a> 1.219 -<h3><font color="#6c0023">link</font></h3> 1.220 +<h3>link</h3> 1.221 <p> 1.222 This command allows the installation of a package from another media 1.223 device. The set up is done through symbolic links and consumes very little 1.224 @@ -202,10 +206,11 @@ 1.225 from an USB key: 1.226 </p> 1.227 <pre> 1.228 - # tazpkg link openoffice /media/usbdisk 1.229 +# tazpkg link openoffice /media/usbdisk 1.230 </pre> 1.231 + 1.232 <a name="remove"></a> 1.233 -<h3><font color="#6c0023">remove</font></h3> 1.234 +<h3>remove</h3> 1.235 <p> 1.236 Remove a package. You will be asked for confirmation (y/N). 1.237 This command will delete all files installed with the package. 1.238 @@ -214,21 +219,23 @@ 1.239 with the package bc: 1.240 </p> 1.241 <pre> 1.242 - # tazpkg remove bc 1.243 +# tazpkg remove bc 1.244 </pre> 1.245 + 1.246 <a name="extract"></a> 1.247 -<h3><font color="#6c0023">extract</font></h3> 1.248 +<h3>extract</h3> 1.249 <p> 1.250 Extract a package into a directory. If you do not specify 1.251 the destination directory, the package will be extracted 1.252 in the current directory using the name package-version: 1.253 </p> 1.254 <pre> 1.255 - # tazpkg extract package.tazpkg 1.256 - # tazpkg extract package.tazpkg target/dir 1.257 +# tazpkg extract package.tazpkg 1.258 +# tazpkg extract package.tazpkg target/dir 1.259 </pre> 1.260 + 1.261 <a name="pack"></a> 1.262 -<h3><font color="#6c0023">pack</font></h3> 1.263 +<h3>pack</h3> 1.264 <p> 1.265 The 'pack' command will create a package from a directory 1.266 prepared in advance or from an unpacked package. It can 1.267 @@ -236,30 +243,34 @@ 1.268 for the automatic creation of packages). To pack a package: 1.269 </p> 1.270 <pre> 1.271 - # tazpkg pack package-version 1.272 +# tazpkg pack package-version 1.273 </pre> 1.274 + 1.275 <a name="repack"></a> 1.276 -<h3><font color="#6c0023">repack</font></h3> 1.277 +<h3>repack</h3> 1.278 <p> 1.279 The 'repack' command allows you to recreate a package from 1.280 the files on a system where it was previously installed. 1.281 To repack a package: 1.282 </p> 1.283 <pre> 1.284 - # tazpkg repack package 1.285 +# tazpkg repack package 1.286 </pre> 1.287 + 1.288 <a name="repack-config"></a> 1.289 -<h3><font color="#6c0023">repack-config</font></h3> 1.290 +<h3>repack-config</h3> 1.291 <p> 1.292 The 'repack-config' command recreates a package 1.293 of the system configuration files (see list-config). It is enough 1.294 to install the package to find the current configuration. To repack 1.295 the configuration files: 1.296 </p> 1.297 -<pre> # tazpkg repack-config 1.298 +<pre> 1.299 +# tazpkg repack-config 1.300 </pre> 1.301 + 1.302 <a name="recharge"></a> 1.303 -<h3><font color="#6c0023">recharge</font></h3> 1.304 +<h3>recharge</h3> 1.305 <p> 1.306 Recharge the list of available packages on the mirror. 1.307 This command will download the most recent 'packages.list' 1.308 @@ -271,10 +282,11 @@ 1.309 latest list of packages: 1.310 </p> 1.311 <pre> 1.312 - # tazpkg recharge 1.313 +# tazpkg recharge 1.314 </pre> 1.315 + 1.316 <a name="upgrade"></a> 1.317 -<h3><font color="#6c0023">upgrade</font></h3> 1.318 +<h3>up (upgrade)</h3> 1.319 <p> 1.320 Upgrade allows you to update all installed packages available 1.321 on the current mirror. Upgrading packages is an important 1.322 @@ -284,23 +296,28 @@ 1.323 offers the latest versions of software. Note that this 1.324 function is aimed at people with SliTaz installed on a 1.325 hard drive. Updated packages in LiveCD mode will be lost on 1.326 -system shutdown. To upgrade: 1.327 +system shutdown. To upgrade or display the full up options: 1.328 </p> 1.329 <pre> 1.330 - # tazpkg upgrade 1.331 +# tazpkg up 1.332 +# tazpkg --help-up 1.333 +# tazpkg up --recharge --install 1.334 +# tazpkg up -r -i 1.335 </pre> 1.336 + 1.337 <a name="check"></a> 1.338 -<h3><font color="#6c0023">check</font></h3> 1.339 +<h3>check</h3> 1.340 <p> 1.341 The 'check' command can check dependencies on installed 1.342 packages and determine whether all the files needed for the 1.343 repacking of packages are present: 1.344 </p> 1.345 <pre> 1.346 - # tazpkg check package 1.347 +# tazpkg check package 1.348 </pre> 1.349 + 1.350 <a name="block"></a> 1.351 -<h3><font color="#6c0023">block or unblock</font></h3> 1.352 +<h3>block or unblock</h3> 1.353 <p> 1.354 The 'block' and 'unblock' commands permit you to block 1.355 installed package versions so that they are not maintained 1.356 @@ -310,22 +327,23 @@ 1.357 Grub: 1.358 </p> 1.359 <pre> 1.360 - # tazpkg block grub 1.361 - Or : 1.362 - # tazpkg unblock grub 1.363 +# tazpkg block grub 1.364 +# tazpkg unblock grub 1.365 </pre> 1.366 + 1.367 <a name="get"></a> 1.368 -<h3><font color="#6c0023">get</font></h3> 1.369 +<h3>get</h3> 1.370 <p> 1.371 Get a package from the mirror (if it exists). The downloaded 1.372 package is stored in the current directory. To find the path 1.373 you can use 'pwd'. To get the Grub package: 1.374 </p> 1.375 <pre> 1.376 - # tazpkg get grub 1.377 +# tazpkg get grub 1.378 </pre> 1.379 + 1.380 <a name="get-install"></a> 1.381 -<h3><font color="#6c0023">get-install</font></h3> 1.382 +<h3>get-install</h3> 1.383 <p> 1.384 Get and install a package from a mirror on the internet. 1.385 The 'get-install' command begins by checking whether the 1.386 @@ -334,10 +352,11 @@ 1.387 use the 'list-mirror' command. To install the package Grub: 1.388 </p> 1.389 <pre> 1.390 - # tazpkg get-install grub 1.391 +# tazpkg get-install grub 1.392 </pre> 1.393 + 1.394 <a name="clean-cache"></a> 1.395 -<h3><font color="#6c0023">clean-cache</font></h3> 1.396 +<h3>clean-cache</h3> 1.397 <p> 1.398 Remove *.tazpkg packages downloaded to the cache. During 1.399 installation, Tazpkg keeps a copy of packages downloaded 1.400 @@ -346,10 +365,11 @@ 1.401 drive or re-download the packages: 1.402 </p> 1.403 <pre> 1.404 - # tazpkg clean-cache 1.405 +# tazpkg clean-cache 1.406 </pre> 1.407 + 1.408 <a name="setup-mirror"></a> 1.409 -<h3><font color="#6c0023">setup-mirror</font></h3> 1.410 +<h3>setup-mirror</h3> 1.411 <p> 1.412 Setup the URL for the mirror. The 'setup-mirror' command 1.413 will ask for the URL of the new mirror. You can specify 1.414 @@ -359,27 +379,30 @@ 1.415 packages: 1.416 </p> 1.417 <pre> 1.418 - # tazpkg setup-mirror 1.419 +# tazpkg setup-mirror 1.420 </pre> 1.421 + 1.422 <a name="reconfigure"></a> 1.423 -<h3><font color="#6c0023">reconfigure</font></h3> 1.424 +<h3>reconfigure</h3> 1.425 <p> 1.426 Replays the post-install script from the package. 1.427 Example using gcc: 1.428 </p> 1.429 -<pre> # tazpkg reconfigure gcc 1.430 +<pre> 1.431 +# tazpkg reconfigure gcc 1.432 </pre> 1.433 <a name="depends"></a> 1.434 -<h3><font color="#6c0023">depends or rdepends</font></h3> 1.435 +<h3>depends or rdepends</h3> 1.436 <p> 1.437 Displays a dependency tree or reverse dependency tree for a package. 1.438 Examples using mpd: 1.439 </p> 1.440 -<pre> # tazpkg depends mpd 1.441 - # tazpkg rdepends mpd 1.442 +<pre> 1.443 +# tazpkg depends mpd 1.444 +# tazpkg rdepends mpd 1.445 </pre> 1.446 <a name="add-undigest"></a> 1.447 -<h3><font color="#6c0023">add-undigest or setup-undigest</font></h3> 1.448 +<h3>add-undigest or setup-undigest</h3> 1.449 <p> 1.450 Set the URL of an additional unofficial mirror to test packages that 1.451 are not yet present on the official mirrors. Note, you can also 1.452 @@ -387,48 +410,55 @@ 1.453 must point to the directory containing the packages and 'packages.list': 1.454 </p> 1.455 <pre> 1.456 - # tazpkg add-undigest public-repository http://my.home.org/slitaz 1.457 - # tazpkg setup-undigest local-repository /home/slitaz/packages 1.458 +# tazpkg add-undigest public-repository http://my.home.org/slitaz 1.459 +# tazpkg setup-undigest local-repository /home/slitaz/packages 1.460 </pre> 1.461 + 1.462 <a name="remove-undigest"></a> 1.463 -<h3><font color="#6c0023">remove-undigest</font></h3> 1.464 +<h3>remove-undigest</h3> 1.465 <p> 1.466 Removes the URL of an undigest mirror: 1.467 </p> 1.468 <pre> 1.469 - # tazpkg remove-undigest my-repository 1.470 +# tazpkg remove-undigest my-repository 1.471 </pre> 1.472 + 1.473 <a name="list-undigest"></a> 1.474 -<h3><font color="#6c0023">list-undigest</font></h3> 1.475 +<h3>list-undigest</h3> 1.476 <p> 1.477 Lists additional undigest mirrors: 1.478 </p> 1.479 <pre> 1.480 - # tazpkg list-undigest 1.481 +# tazpkg list-undigest 1.482 </pre> 1.483 + 1.484 <a name="convert"></a> 1.485 -<h3><font color="#6c0023">convert</font></h3> 1.486 +<h3>convert</h3> 1.487 <p> 1.488 Converts a Debian package (.deb), Redhat (.rpm), Slackware (.tgz) or 1.489 Archlinux (.pkg.tar.gz) package into a SliTaz package (.tazpkg): 1.490 </p> 1.491 <pre> 1.492 - # tazpkg convert alien-package 1.493 +# tazpkg convert alien-package 1.494 </pre> 1.495 + 1.496 <a name="set-release"></a> 1.497 -<h3><font color="#6c0023">set-release</font></h3> 1.498 +<h3>set-release</h3> 1.499 <p> 1.500 The 'set-release' command changes the current version and 1.501 upgrades all of the packages to the latest release: 1.502 </p> 1.503 -<pre> # tazpkg set-release cooking 1.504 +<pre> 1.505 +# tazpkg set-release cooking 1.506 </pre> 1.507 + 1.508 <a name="bugs"></a> 1.509 -<h3><font color="#6c0023">bugs</font></h3> 1.510 +<h3>bugs</h3> 1.511 <p> 1.512 Generates a list of known bugs in the packages: 1.513 </p> 1.514 -<pre> # tazpkg bugs 1.515 +<pre> 1.516 +# tazpkg bugs 1.517 </pre> 1.518 1.519 <h2>MAINTAINER</h2>