tazpkg diff doc/tazpkg.en.html @ rev 844
Finish modularization. Beta release: still have few FIXMEs and TODOs.
author | Aleksej Bobylev <al.bobylev@gmail.com> |
---|---|
date | Mon Oct 05 03:53:47 2015 +0300 (2015-10-05) |
parents | c45468fb179e |
children | e54a3ba8cc25 |
line diff
1.1 --- a/doc/tazpkg.en.html Sat Aug 15 12:23:33 2015 +0100 1.2 +++ b/doc/tazpkg.en.html Mon Oct 05 03:53:47 2015 +0300 1.3 @@ -1,11 +1,11 @@ 1.4 <!DOCTYPE html> 1.5 <html lang="en"> 1.6 <head> 1.7 - <meta charset="utf-8" /> 1.8 + <meta charset="UTF-8"> 1.9 <title>TazPkg Manual</title> 1.10 - <meta name="viewport" content="width=device-width,initial-scale=1"/> 1.11 - <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" /> 1.12 - <script type="text/javascript" src="../slitaz-doc.js"></script> 1.13 + <meta name="viewport" content="width=device-width,initial-scale=1"> 1.14 + <link rel="stylesheet" href="../slitaz-doc.css"> 1.15 + <script src="../slitaz-doc.js"></script> 1.16 </head> 1.17 <body> 1.18 1.19 @@ -13,60 +13,61 @@ 1.20 <h1>TazPkg Manual</h1> 1.21 </header> 1.22 1.23 -<!-- Start content --> 1.24 -<div id="content"> 1.25 1.26 1.27 -<h2>Name</h2> 1.28 1.29 -<p>TazPkg — Tiny autonomous zone package manager</p> 1.30 +<section><header>Name</header> 1.31 1.32 +<p>TazPkg — Tiny autonomous zone package manager.</p> 1.33 +</section> 1.34 1.35 -<h2>Syntax</h2> 1.36 + 1.37 +<section><header>Syntax</header> 1.38 1.39 <pre> 1.40 tazpkg [command] [options...] 1.41 </pre> 1.42 +</section> 1.43 1.44 1.45 -<h2>Description</h2> 1.46 +<section><header>Description</header> 1.47 1.48 -<p>TazPkg is a lightweight package manager to install, list, download, update or 1.49 -remove precompiled packages on a GNU/Linux system. TazPkg offers commands for 1.50 -searching and creating packages and was created independently for the project. 1.51 -The format of the packages using the *.tazpkg extension is a cpio archive 1.52 -containing a filesystem compressed with gzip, a receipt and an optional 1.53 -description. TazPkg also manages dependencies based on package receipts. Each 1.54 -receipt contains all the information about a package and can also include pre- 1.55 -and post-installation functions. The same receipt is used by Cookutils to 1.56 -compile sources and generate a .tazpkg package.</p> 1.57 +<p>TazPkg is a lightweight package manager to install, list, download, update or remove precompiled 1.58 +packages on a GNU/Linux system. TazPkg offers commands for searching and creating packages and was 1.59 +created independently for the project. The format of the packages using the *.tazpkg extension is 1.60 +a cpio archive containing a filesystem compressed with lzma, a receipt and an optional description. 1.61 +TazPkg also manages dependencies based on package receipts. Each receipt contains all the 1.62 +information about a package and can also include pre- and post-installation functions. The same 1.63 +receipt is used by <a href="../cookutils/cookutils.en.html" target="_blank">Cookutils</a> to compile 1.64 +sources and generate a .tazpkg package.</p> 1.65 1.66 -<p>TazPkg is entirely built from scratch using Shell script, compatible with 1.67 -Bash; it runs under Ash — part of the Busybox project. TazPkg is distributed 1.68 -under the free GNU license <a href="file:///usr/share/licenses/gpl.txt" 1.69 -target="_blank">GPL V3</a>.</p> 1.70 +<p>TazPkg is entirely built from scratch using Shell script, compatible with Bash; it runs under 1.71 +Ash — part of the Busybox project. TazPkg is distributed under the free GNU license <a 1.72 +href="file:///usr/share/licenses/gpl.txt" target="_blank">GPL V3</a>.</p> 1.73 +</section> 1.74 1.75 1.76 -<h2>Environment</h2> 1.77 +<section><header>Environment</header> 1.78 1.79 <p>TazPkg uses some environment variables:</p> 1.80 1.81 <ul> 1.82 - <li><tt>LANGUAGE</tt>: defines the language of output and user 1.83 - confirmations. <x-details>Note, <tt>LANG</tt> and <tt>LC_ALL</tt> 1.84 - environment variables also affect output language</x-details></li> 1.85 - <li><tt>LC_TIME</tt>: defines the date format in the <a 1.86 - href="#activity">activity</a> command</li> 1.87 - <!-- li><tt>TAZPKG_ROOT</tt>: if defined it points to the root of file system 1.88 - where TazPkg should work. Note, value defined using <tt>--root=</tt> 1.89 - option has precedence over this environment variable</li --> 1.90 + <li><tt>LANGUAGE</tt>: defines the language of output and user confirmations. 1.91 + <x-details>Note, <tt>LANG</tt> and <tt>LC_ALL</tt> environment variables also affect output 1.92 + language</x-details></li> 1.93 + <li><tt>LC_TIME</tt>: defines the date format in the <a href="#activity">activity</a> 1.94 + command</li> 1.95 + <li><tt>root</tt>: if defined it points to the root of file system where TazPkg should work. 1.96 + Note, value defined using <tt>--root=</tt> option has precedence over this environment 1.97 + variable</li> 1.98 </ul> 1.99 +</section> 1.100 1.101 1.102 -<h2>Files</h2> 1.103 +<section><header>Files</header> 1.104 1.105 1.106 -<h3>Configuration files</h3> 1.107 +<article><header>Configuration files</header> 1.108 1.109 <ul> 1.110 <li><tt><a href="file:///etc/slitaz/slitaz.conf" 1.111 @@ -74,173 +75,162 @@ 1.112 <li><tt><a href="file:///etc/slitaz/tazpkg.conf" 1.113 target="_blank">/etc/slitaz/tazpkg.conf</a></tt></li> 1.114 </ul> 1.115 +</article> 1.116 1.117 1.118 -<h3>Package database files</h3> 1.119 +<article><header>Package database files</header> 1.120 1.121 <p>Default placement of the package database is <tt>/var/lib/tazpkg</tt>.</p> 1.122 1.123 <ul> 1.124 - <li><tt><a href="file:///var/lib/tazpkg/ID" target="_blank">ID</a></tt> 1.125 - (deprecated): identifier of the current SliTaz repository state. 1.126 + <li><tt><a href="file:///var/lib/tazpkg/ID" target="_blank">ID</a></tt> (deprecated): identifier 1.127 + of the current SliTaz repository state. 1.128 <x-details>The value changes when new or updated packages appear in the 1.129 repository.</x-details></li> 1.130 - <li><tt><a href="file:///var/lib/tazpkg/IDs" target="_blank">IDs</a></tt>: 1.131 - identifier of the current SliTaz repository state and the UNIX time stamp. 1.132 - <x-details>The ID value changes when new or updated packages appear in 1.133 - the repository. Time stamp allows you to track how long a change is made in 1.134 - the repository and to track the freshness of repository mirrors. 1.135 - (To convert UNIX time stamp to the date: 1.136 + <li><tt><a href="file:///var/lib/tazpkg/IDs" target="_blank">IDs</a></tt>: identifier of the 1.137 + current SliTaz repository state and the UNIX time stamp. 1.138 + <x-details>The ID value changes when new or updated packages appear in the repository. Time 1.139 + stamp allows you to track how long a change is made in the repository and to track the 1.140 + freshness of repository mirrors. (To convert UNIX time stamp to the date: 1.141 <code>date -d@<em>timestamp</em></code>)</x-details></li> 1.142 - <li><tt><a href="file:///var/lib/tazpkg/mirror" 1.143 - target="_blank">mirror</a></tt>: URL of the current repository mirror in 1.144 - use. <x-details>URL points to the remote folder containing packages and 1.145 - database files.</x-details></li> 1.146 - <li><tt><a href="file:///var/lib/tazpkg/mirrors" 1.147 - target="_blank">mirrors</a></tt>: list of URLs of available repository 1.148 - mirrors. <x-details>Note the difference between URLs from these two 1.149 - files; you should append URL from this file by 1.150 - <tt>packages/<em>cooking</em>/</tt> (for <tt><em>cooking</em></tt>-based 1.151 - Slitaz version).</x-details></li> 1.152 - <li><tt><a href="file:///var/lib/tazpkg/packages.list" 1.153 - target="_blank">packages.list</a></tt> (deprecated): list of package 1.154 - names with version numbers available in the repository.</li> 1.155 - <li><tt><a href="file:///var/lib/tazpkg/packages.desc" 1.156 - target="_blank">packages.desc</a></tt> (deprecated): list contained 1.157 - package name, version, short description, category and upstream 1.158 + <li><tt><a href="file:///var/lib/tazpkg/mirror" target="_blank">mirror</a></tt>: URL of the 1.159 + current repository mirror in use. 1.160 + <x-details>URL points to the remote folder containing packages and database 1.161 + files.</x-details></li> 1.162 + <li><tt><a href="file:///var/lib/tazpkg/mirrors" target="_blank">mirrors</a></tt>: list of URLs 1.163 + of available repository mirrors. 1.164 + <x-details>Note the difference between URLs from these two files; you should append URL from 1.165 + this file by <tt>packages/<em>cooking</em>/</tt> (for <tt><em>cooking</em></tt>-based Slitaz 1.166 + version).</x-details></li> 1.167 + <li><tt><a href="file:///var/lib/tazpkg/packages.list" target="_blank">packages.list</a></tt> 1.168 + (deprecated): list of package names with version numbers available in the repository.</li> 1.169 + <li><tt><a href="file:///var/lib/tazpkg/packages.desc" target="_blank">packages.desc</a></tt> 1.170 + (deprecated): list contained package name, version, short description, category and upstream 1.171 URL.</li> 1.172 - <li><tt><a href="file:///var/lib/tazpkg/packages.txt" 1.173 - target="_blank">packages.txt</a></tt> (deprecated): list containing 1.174 - package name, version, short description and two package sizes 1.175 - <x-details>(first — traffic to download package, second — HDD size for 1.176 - installed package)</x-details>.</li> 1.177 - <li><tt><a href="file:///var/lib/tazpkg/packages.md5" 1.178 - target="_blank">packages.md5</a></tt> (deprecated): list containing MD5 1.179 - checksum with package file name.</li> 1.180 - <li><tt><a href="file:///var/lib/tazpkg/packages.info" 1.181 - target="_blank">packages.info</a></tt>: list was built to replace and 1.182 - extend above lists. <x-details>For every package available in the 1.183 - repository it contains: package name, version, category, short 1.184 - description, upstream URL, tags, package sizes, depends and MD5 1.185 - checksum. Development continues, and the list can be extended by other 1.186 - fields, if necessary.</x-details></li> 1.187 - <li><tt><a href="file:///var/lib/tazpkg/packages.equiv" 1.188 - target="_blank">packages.equiv</a></tt>: list of equivalent packages 1.189 - available in the repository. <x-details>Format of the list item: 1.190 - <tt><em>package</em>=<em>rule rule…</em></tt>.<br> 1.191 - Format of the rule: <tt><em>alternative:newname</em></tt> — if 1.192 - <tt><em>alternative</em></tt> is installed then 1.193 - <tt><em>newname</em></tt> will be installed instead of the 1.194 + <li><tt><a href="file:///var/lib/tazpkg/packages.txt" target="_blank">packages.txt</a></tt> 1.195 + (deprecated): list containing package name, version, short description and two package sizes 1.196 + <x-details>(first — traffic to download package, second — HDD size for installed 1.197 + package)</x-details>.</li> 1.198 + <li><tt><a href="file:///var/lib/tazpkg/packages.md5" target="_blank">packages.md5</a></tt> 1.199 + (deprecated): list containing MD5 checksum with package file name.</li> 1.200 + <li><tt><a href="file:///var/lib/tazpkg/packages.info" target="_blank">packages.info</a></tt>: 1.201 + list was built to replace and extend above lists. 1.202 + <x-details>For every package available in the repository it contains: package name, version, 1.203 + category, short description, upstream URL, tags, package sizes, depends and MD5 checksum. 1.204 + Development continues, and the list can be extended by other fields, if 1.205 + necessary.</x-details></li> 1.206 + <li><tt><a href="file:///var/lib/tazpkg/packages.equiv" target="_blank">packages.equiv</a></tt>: 1.207 + list of equivalent packages available in the repository. 1.208 + <x-details>Format of the list item: <tt><em>package</em>=<em>rule rule…</em></tt>.<br> 1.209 + Format of the rule: <tt><em>alternative:newname</em></tt> — if <tt><em>alternative</em></tt> 1.210 + is installed then <tt><em>newname</em></tt> will be installed instead of the 1.211 <tt><em>package</em></tt>.<br> 1.212 - In the second format of the rule <tt><em>alternative:</em></tt> part is 1.213 - omitted — in this case <tt><em>newname</em></tt> <em>can be</em> 1.214 - installed instead of the <tt><em>package</em></tt> (in the user 1.215 - choice).</x-details></li> 1.216 - <li><tt><a href="file:///var/lib/tazpkg/packages.diff" 1.217 - target="_blank">packages.diff</a></tt>: list created when you run 1.218 - <tt><a href="#recharge">recharge</a></tt> command. <x-details>List 1.219 - contains package names with versions of the new packages available in 1.220 - the repository with the last recharge.</x-details></li> 1.221 - <li><tt><a href="file:///var/lib/tazpkg/packages.up" 1.222 - target="_blank">packages.up</a></tt>: list created when you run 1.223 - <tt><a href="#upgrade">upgrade</a></tt> command. <x-details>List 1.224 - contains package names you can upgrade with the last 1.225 + In the second format of the rule <tt><em>alternative:</em></tt> part is omitted — in this 1.226 + case <tt><em>newname</em></tt> <em>can be</em> installed instead of the 1.227 + <tt><em>package</em></tt> (in the user choice).</x-details></li> 1.228 + <li><tt><a href="file:///var/lib/tazpkg/packages.diff" target="_blank">packages.diff</a></tt>: 1.229 + list created when you run <tt><a href="#recharge">recharge</a></tt> command. 1.230 + <x-details>List contains package names with versions of the new packages available in the 1.231 + repository with the last recharge.</x-details></li> 1.232 + <li><tt><a href="file:///var/lib/tazpkg/packages.up" target="_blank">packages.up</a></tt>: list 1.233 + created when you run <tt><a href="#upgrade">upgrade</a></tt> command. 1.234 + <x-details>List contains package names you can upgrade with the last 1.235 recharge.</x-details></li> 1.236 - <li><tt><a href="file:///var/lib/tazpkg/descriptions.txt" 1.237 - target="_blank">descriptions.txt</a></tt>: list of the “long” 1.238 - descriptions of the all packages available on the repository.</li> 1.239 - <li><tt>packages-desc.<em>language</em></tt> — optional list of the packages 1.240 - translated short descriptions <x-details>(see the package 1.241 - tazpkg-desc-ru)</x-details>.</li> 1.242 - <li><tt>descriptions.<em>language</em>.txt</tt> — optional list of the 1.243 - packages translated “long” descriptions <x-details>(see the package 1.244 - tazpkg-desc-ru)</x-details>.</li> 1.245 - <li><tt>packages.icons</tt> — optional list of the packages icons for 1.246 - TazPanel.</li> 1.247 - <li><tt><a href="file:///var/lib/tazpkg/blocked-packages.list" 1.248 - target="_blank">blocked-packages.list</a></tt>: optional list of the 1.249 - packages blocked for update.</li> 1.250 - <li><tt><a href="file:///var/lib/tazpkg/extra.list" 1.251 - target="_blank">extra.list</a></tt>: list of the extra packages 1.252 - <x-details>(non-free packages; free packages but not compiled from 1.253 - sources). List contains package name, short description, upstream URL, 1.254 - category, version, license.</x-details></li> 1.255 - <li><tt>files.list.lzma</tt>: very large compressed list which contains all 1.256 - the files of all the packages available in the repository 1.257 - <x-details>(nearly 5,000 packages and nearly 0.7 million 1.258 - files now)</x-details>.</li> 1.259 - <li><tt>files-list.md5</tt>: MD5 checksum of the 1.260 - <tt>files.list.lzma</tt>.</li> 1.261 - <li><tt><a href="file:///var/lib/tazpkg/installed.info" 1.262 - target="_blank">installed.info</a></tt>: list of the installed packages 1.263 - with the exact format of the <tt>packages.info</tt> list. 1.264 - <x-details>Idea is just to copy list item from <tt>packages.info</tt> to 1.265 - the <tt>installed.info</tt> during package installation.</x-details></li> 1.266 - <li><tt><a href="file:///var/lib/tazpkg/installed.md5" 1.267 - target="_blank">installed.md5</a></tt> (deprecated): list containing MD5 1.268 - checksum with file names of all installed packages.</li> 1.269 + <li><tt><a href="file:///var/lib/tazpkg/descriptions.txt" 1.270 + target="_blank">descriptions.txt</a></tt>: list of the “long” descriptions of the all 1.271 + packages available on the repository.</li> 1.272 + <li><tt>packages-desc.<em>language</em></tt> — optional list of the packages translated short 1.273 + descriptions 1.274 + <x-details>(see the package tazpkg-desc-ru)</x-details>.</li> 1.275 + <li><tt>descriptions.<em>language</em>.txt</tt> — optional list of the packages translated 1.276 + “long” descriptions 1.277 + <x-details>(see the package tazpkg-desc-ru)</x-details>.</li> 1.278 + <li><tt>packages.icons</tt> — optional list of the packages icons for TazPanel.</li> 1.279 + <li><tt><a href="file:///var/lib/tazpkg/blocked-packages.list" 1.280 + target="_blank">blocked-packages.list</a></tt>: optional list of the packages blocked for 1.281 + update.</li> 1.282 + <li><tt><a href="file:///var/lib/tazpkg/extra.list" target="_blank">extra.list</a></tt>: list of 1.283 + the extra packages 1.284 + <x-details>(non-free packages; free packages but not compiled from sources). List contains 1.285 + package name, short description, upstream URL, category, version, license.</x-details></li> 1.286 + <li><tt>files.list.lzma</tt>: very large compressed list which contains all the files of all the 1.287 + packages available in the repository 1.288 + <x-details>(nearly 5,000 packages and nearly 0.7 million files now)</x-details>.</li> 1.289 + <li><tt>files-list.md5</tt>: MD5 checksum of the <tt>files.list.lzma</tt>.</li> 1.290 + <li><tt><a href="file:///var/lib/tazpkg/installed.info" target="_blank">installed.info</a></tt>: 1.291 + list of the installed packages with the exact format of the <tt>packages.info</tt> list. 1.292 + <x-details>Idea is just to copy list item from <tt>packages.info</tt> to the 1.293 + <tt>installed.info</tt> during package installation.</x-details></li> 1.294 + <li><tt><a href="file:///var/lib/tazpkg/installed.md5" target="_blank">installed.md5</a></tt> 1.295 + (deprecated): list containing MD5 checksum with file names of all installed packages.</li> 1.296 + <li><tt><a href="file:///var/lib/tazpkg/priority" target="_blank">priority</a></tt>: optional 1.297 + list of the repositories priority. 1.298 + <x-details>One repository name per line. Undigest repositories are called by their names and 1.299 + main repository by “main”. If priority list absent, then default priority is: main 1.300 + repository and all existing undigest repositories in the alphabetical 1.301 + order.</x-details></li> 1.302 </ul> 1.303 1.304 -<p>All the deprecated files will be deleted after we verify that the programs do 1.305 -not use them (and modify the programs as necessary).</p> 1.306 +<p>All the deprecated files will be deleted after we verify that the programs do not use them (and 1.307 +modify the programs as necessary).</p> 1.308 1.309 -<p>In addition to the common package database files there is also individual 1.310 -folders for all installed packages placed by default in the 1.311 -<tt>/var/lib/tazpkg/installed/<em>package</em></tt>. Every folder here may 1.312 -contain the following files:</p> 1.313 +<p>In addition to the common package database files there is also individual folders for all 1.314 +installed packages placed by default in the <tt>/var/lib/tazpkg/installed/<em>package</em></tt>. 1.315 +Every folder here may contain the following files:</p> 1.316 1.317 <ul> 1.318 <li><tt>receipt</tt> (mandatory) — the package recipe</li> 1.319 <li><tt>files.list</tt> (mandatory) — list of package files</li> 1.320 - <li><tt>md5sum</tt> (mandatory) — checksums of package files (other checksum 1.321 - files can be specified in the settings: <tt>cksum</tt> (CRC32), 1.322 - <tt>md5sum</tt> (MD5), <tt>sha1sum</tt> (SHA1), <tt>sha256sum</tt> 1.323 - (SHA256), <tt>sha512sum</tt> (SHA512), <tt>sha3sum</tt> (SHA3-512))</li> 1.324 + <li><tt>md5sum</tt> (mandatory) — checksums of package files (other checksum files can be 1.325 + specified in the settings: <tt>cksum</tt> (CRC32), <tt>md5sum</tt> (MD5), <tt>sha1sum</tt> 1.326 + (SHA1), <tt>sha256sum</tt> (SHA256), <tt>sha512sum</tt> (SHA512), <tt>sha3sum</tt> 1.327 + (SHA3-512))</li> 1.328 <li><tt>description.txt</tt> (optional) — “long” description</li> 1.329 - <li><tt>modifiers</tt> (optional) — list of packages that have replaced some 1.330 - of the files of this package</li> 1.331 - <li><tt>volatile.cpio.gz</tt> (optional) — archive of “official” 1.332 - configuration files</li> 1.333 + <li><tt>modifiers</tt> (optional) — list of packages that have replaced some of the files of 1.334 + this package</li> 1.335 + <li><tt>volatile.cpio.gz</tt> (optional) — archive of “official” configuration files</li> 1.336 </ul> 1.337 +</article> 1.338 1.339 1.340 -<h3>Cache</h3> 1.341 +<article><header>Cache</header> 1.342 1.343 -<p>Default placement of the packages cache is <tt>/var/cache/tazpkg</tt> with 1.344 -sub-folders for the different repositories. <x-details>It is exactly 1.345 -<tt>/var/cache/tazpkg/<em>cooking</em>/packages</tt> for the 1.346 +<p>Default placement of the packages cache is <tt>/var/cache/tazpkg</tt> with sub-folders for the 1.347 +different repositories. 1.348 +<x-details>It is exactly <tt>/var/cache/tazpkg/<em>cooking</em>/packages</tt> for the 1.349 <tt><em>cooking</em></tt>-based SliTaz version.</x-details></p> 1.350 +</article> 1.351 1.352 1.353 -<h3>Misc files</h3> 1.354 +<article><header>Misc files</header> 1.355 1.356 <p>File with default placement <tt><a href="file:///var/log/slitaz/tazpkg.log" 1.357 target="_blank">/var/log/slitaz/tazpkg.log</a></tt> stores TazPkg activity log. 1.358 -<x-details>Log stores five types of actions: installing, uninstalling, blocking, 1.359 -unblocking, reconfiguring packages.</x-details></p> 1.360 +<x-details>Log stores five types of actions: installing, uninstalling, blocking, unblocking, 1.361 +reconfiguring packages.</x-details></p> 1.362 1.363 -<p>Shared MIME information which allows to “guess” SliTaz package files, package 1.364 -receipts and SliTaz flavor files. <x-details>File placed here: <tt><a 1.365 -href="file:///usr/share/mime/packages/tazpkg.xml" 1.366 +<p>Shared MIME information which allows to “guess” SliTaz package files, package receipts and 1.367 +SliTaz flavor files. 1.368 +<x-details>File placed here: <tt><a href="file:///usr/share/mime/packages/tazpkg.xml" 1.369 target="_blank">/usr/share/mime/packages/tazpkg.xml</a></tt>.</x-details></p> 1.370 1.371 <p>Plug-in for the TazPanel (SliTaz administration and configuration panel) 1.372 -<tt>/var/www/tazpanel/pkgs.cgi</tt> allows you to manage SliTaz packages in the 1.373 -<a href="http://127.0.0.1:82/pkgs.cgi" target="_blank">web application</a>.</p> 1.374 +<tt>/var/www/tazpanel/pkgs.cgi</tt> allows you to manage SliTaz packages in the <a 1.375 +href="http://127.0.0.1:82/pkgs.cgi" target="_blank">web application</a>.</p> 1.376 1.377 -<p>TazPkg documentation is placed in the <tt>/usr/share/doc/tazpkg</tt> 1.378 -folder.</p> 1.379 +<p>TazPkg documentation is placed in the <tt>/usr/share/doc/tazpkg</tt> folder.</p> 1.380 +</article> 1.381 +</section> 1.382 1.383 1.384 1.385 1.386 -<h2>Commands</h2> 1.387 +<section><header>Commands</header> 1.388 1.389 -<p>The first <tt>tazpkg</tt> parameter is a command followed by other mandatory 1.390 -and optional parameters as will be described hereinafter. Options begin with 1.391 -double dashes, you can arrange them in any order and in any place, even before 1.392 -the command. Unknown and inappropriate options are ignored. The following 1.393 -commands are equivalent:</p> 1.394 +<p>The first <tt>tazpkg</tt> parameter is a command followed by other mandatory and optional 1.395 +parameters as will be described hereinafter. Options begin with double dashes, you can arrange them 1.396 +in any order and in any place, even before the command. Unknown and inappropriate options are 1.397 +ignored. The following commands are equivalent:</p> 1.398 1.399 <pre> 1.400 $ tazpkg info nano --root=<em>/mnt/sda6</em> 1.401 @@ -248,199 +238,185 @@ 1.402 $ tazpkg info --root=<em>/mnt/sda6</em> nano <em>--color</em> 1.403 </pre> 1.404 1.405 -<!-- p>You can add global option <tt>--root=…</tt> to any TazPkg command. This 1.406 -option allows to work with other SliTaz installations. Option points to the root 1.407 -of mounted file system from other SliTaz installation. <x-details>By the way, 1.408 -using this option allows to install SliTaz to the other file system “from 1.409 -scratch”, and upgrade SliTaz packages remotely.</x-details></p --> 1.410 +<p>You can add global option <tt>--root=…</tt> to any TazPkg command. This option allows to work 1.411 +with other SliTaz installations. Option points to the root of mounted file system from other SliTaz 1.412 +installation. 1.413 +<x-details>By the way, using this option allows to install SliTaz to the other file system “from 1.414 +scratch”, and upgrade SliTaz packages remotely.</x-details></p> 1.415 1.416 1.417 -<h3>Service commands</h3> 1.418 +<article><header>Service commands</header> 1.419 1.420 <ul> 1.421 <li><a href="#usage">usage</a>: print short usage</li> 1.422 <li><a href="#help">help</a>: show help on the TazPkg commands</li> 1.423 <li><a href="#activity">activity</a>: show TazPkg activity log</li> 1.424 - <li><a href="#clean-cache">clean-cache</a>: clean all packages downloaded in 1.425 - cache directory</li> 1.426 + <li><a href="#clean-cache">clean-cache</a>: clean all packages downloaded in cache 1.427 + directory</li> 1.428 <li><a href="#shell">shell</a>: run interactive TazPkg shell</li> 1.429 </ul> 1.430 +</article> 1.431 1.432 1.433 -<h3>Working with lists</h3> 1.434 +<article><header>Working with lists</header> 1.435 1.436 <ul> 1.437 <li><a href="#list">list</a>: list installed packages on the system</li> 1.438 - <li><a href="#list-mirror">list-mirror</a>: list all available packages on 1.439 - the mirror</li> 1.440 - <li><a href="#list-config">list-config</a>: list the configuration 1.441 - files</li> 1.442 + <li><a href="#list-mirror">list-mirror</a>: list all available packages on the mirror</li> 1.443 + <li><a href="#list-config">list-config</a>: list the configuration files</li> 1.444 </ul> 1.445 +</article> 1.446 1.447 1.448 -<h3>Search</h3> 1.449 +<article><header>Search</header> 1.450 1.451 <ul> 1.452 - <li><a href="#search">search</a>: search for a package by pattern or 1.453 - name</li> 1.454 - <li><a href="#search-pkgname">search-pkgname</a>: search on mirror for 1.455 - package having a particular file</li> 1.456 - <li><a href="#search-file">search-file</a>: search for file in all installed 1.457 - packages files</li> 1.458 + <li><a href="#search">search</a>: search for a package by pattern or name</li> 1.459 + <li><a href="#search-pkgname">search-pkgname</a>: search on mirror for package having a 1.460 + particular file</li> 1.461 + <li><a href="#search-file">search-file</a>: search for file in all installed packages files</li> 1.462 </ul> 1.463 +</article> 1.464 1.465 1.466 -<h3>Installing and removing packages</h3> 1.467 +<article><header>Installing and removing packages</header> 1.468 1.469 <ul> 1.470 - <li><a href="#get">get</a>: download a package into the current 1.471 - directory</li> 1.472 + <li><a href="#get">get</a>: download a package into the current directory</li> 1.473 <li><a href="#install">install</a>: install a local package</li> 1.474 - <li><a href="#get-install">get-install</a>: download and install a package 1.475 - from the mirror</li> 1.476 - <li><a href="#install-list">install-list</a>: install all packages from a 1.477 - list of packages</li> 1.478 - <li><a href="#install-list">get-install-list</a>: download and install a 1.479 - list of packages from the mirror</li> 1.480 - <li><a href="#remove">remove</a>: remove the specified package and all 1.481 - installed files</li> 1.482 - <li><a href="#reconfigure">reconfigure</a>: replay post install script from 1.483 - package</li> 1.484 - <li><a href="#link">link</a>: link a package from another SliTaz 1.485 - installation</li> 1.486 - <li><a href="#set-release">set-release</a>: change release and update 1.487 - packages</li> 1.488 - <li><a href="#add-flavor">add-flavor</a>: install the flavor list of 1.489 - packages</li> 1.490 - <li><a href="#add-flavor">install-flavor</a>: install the flavor list of 1.491 - packages and remove other ones</li> 1.492 + <li><a href="#get-install">get-install</a>: download and install a package from the mirror</li> 1.493 + <li><a href="#get-list">get-list</a>: download a list of packages from the mirror</li> 1.494 + <li><a href="#get-list">install-list</a>: install all packages from a list of packages</li> 1.495 + <li><a href="#get-list">get-install-list</a>: download and install a list of packages from the 1.496 + mirror</li> 1.497 + <li><a href="#remove">remove</a>: remove the specified package and all installed files</li> 1.498 + <li><a href="#reconfigure">reconfigure</a>: replay post install script from package</li> 1.499 + <li><a href="#link">link</a>: link a package from another SliTaz installation</li> 1.500 + <li><a href="#set-release">set-release</a>: change release and update packages</li> 1.501 + <li><a href="#add-flavor">add-flavor</a>: install the flavor list of packages</li> 1.502 + <li><a href="#add-flavor">install-flavor</a>: install the flavor list of packages and remove 1.503 + other ones</li> 1.504 </ul> 1.505 +</article> 1.506 1.507 1.508 -<h3>Working with packages</h3> 1.509 +<article><header>Working with packages</header> 1.510 1.511 <ul> 1.512 <li><a href="#info">info</a>: print information about a package</li> 1.513 <li><a href="#desc">desc</a>: print description of a package</li> 1.514 - <li><a href="#list-files">list-files</a>: list the files installed with a 1.515 - package</li> 1.516 - <li><a href="#block">block, unblock</a>: block an installed package version 1.517 - or unblock it for upgrade</li> 1.518 - <li><a href="#check">check</a>: verify consistency of installed 1.519 - packages</li> 1.520 + <li><a href="#list-files">list-files</a>: list the files installed with a package</li> 1.521 + <li><a href="#block">block, unblock</a>: block an installed package version or unblock it for 1.522 + upgrade</li> 1.523 + <li><a href="#check">check</a>: verify consistency of installed packages</li> 1.524 <li><a href="#bugs">bugs</a>: show known bugs in packages</li> 1.525 <li><a href="#depends">depends</a>: display dependencies tree</li> 1.526 <li><a href="#depends">rdepends</a>: display reverse dependencies tree</li> 1.527 - <li><a href="#extract">extract</a>: extract a (*.tazpkg) package into a 1.528 - directory</li> 1.529 + <li><a href="#extract">extract</a>: extract a (*.tazpkg) package into a directory</li> 1.530 <li><a href="#pack">pack</a>: pack an unpacked or prepared package tree</li> 1.531 - <li><a href="#repack">repack</a>: create a package archive from an installed 1.532 - package</li> 1.533 - <li><a href="#repack-config">repack-config</a>: create a package archive 1.534 - with configuration files</li> 1.535 - <li><a href="#recompress">recompress</a>: rebuild a package with a better 1.536 - compression ratio</li> 1.537 + <li><a href="#repack">repack</a>: create a package archive from an installed package</li> 1.538 + <li><a href="#repack-config">repack-config</a>: create a package archive with configuration 1.539 + files</li> 1.540 + <li><a href="#recompress">recompress</a>: rebuild a package with a better compression ratio</li> 1.541 <li><a href="#convert">convert</a>: convert alien package to tazpkg</li> 1.542 - <li><a href="#list-suggested">list-suggested</a>: print list of suggested 1.543 - packages</li> 1.544 + <li><a href="#list-suggested">list-suggested</a>: print list of suggested packages</li> 1.545 </ul> 1.546 +</article> 1.547 1.548 1.549 -<h3>Working with repositories</h3> 1.550 +<article><header>Working with repositories</header> 1.551 1.552 <ul> 1.553 - <li><a href="#recharge">recharge</a>: recharge your packages database from 1.554 - the mirror</li> 1.555 - <li><a href="#upgrade">upgrade</a>: check packages, list and install latest 1.556 - upgrades</li> 1.557 - <li><a href="#setup-mirror">setup-mirror</a>: change the mirror URL 1.558 - configuration</li> 1.559 - <li><a href="#add-undigest">setup-undigest</a>: update an undigest 1.560 - mirror</li> 1.561 + <li><a href="#recharge">recharge</a>: recharge your packages database from the mirror</li> 1.562 + <li><a href="#upgrade">upgrade</a>: check packages, list and install latest upgrades</li> 1.563 + <li><a href="#setup-mirror">setup-mirror</a>: change the mirror URL configuration</li> 1.564 + <li><a href="#add-undigest">setup-undigest</a>: update an undigest mirror</li> 1.565 <li><a href="#list-undigest">list-undigest</a>: list undigest mirrors</li> 1.566 <li><a href="#add-undigest">add-undigest</a>: add an undigest mirror</li> 1.567 - <li><a href="#remove-undigest">remove-undigest</a>: remove an undigest 1.568 - mirror</li> 1.569 + <li><a href="#remove-undigest">remove-undigest</a>: remove an undigest mirror</li> 1.570 </ul> 1.571 +</article> 1.572 +</section> 1.573 1.574 1.575 1.576 1.577 -<h2>Service commands</h2> 1.578 +<section><header>Service commands</header> 1.579 1.580 1.581 -<h3 id="usage">usage</h3> 1.582 +<article id="usage"><h3>usage</h3> 1.583 1.584 <p>Show the full list of the TazPkg commands with a brief description.</p> 1.585 1.586 <pre> 1.587 $ tazpkg usage 1.588 -$ tazpkg 1.589 </pre> 1.590 +</article> 1.591 1.592 1.593 -<h3 id="help">help</h3> 1.594 +<article id="help"><h3>help</h3> 1.595 1.596 -<p>Display help for the selected command (<tt>help</tt> or <tt>-h</tt>). You can 1.597 -enter a short name of the command, the full name or a part of the full name. You 1.598 -can ignore hyphens at the beginning of the short name. If the requested part of 1.599 -the full name match the several commands, you will be asked to clarify the 1.600 -request.</p> 1.601 +<p>Display help for the selected command (<tt>help</tt> or <tt>-h</tt>). You can enter a short name 1.602 +of the command, the full name or a part of the full name. You can ignore hyphens at the beginning of 1.603 +the short name. If the requested part of the full name match the several commands, you will be asked 1.604 +to clarify the request.</p> 1.605 1.606 <pre> 1.607 $ tazpkg help <em>-gi</em> 1.608 $ tazpkg -h <em>us</em> 1.609 </pre> 1.610 +</article> 1.611 1.612 1.613 -<h3 id="activity">activity</h3> 1.614 +<article id="activity"><h3>activity</h3> 1.615 1.616 -<p>Display TazPkg activity log (<tt>activity</tt> or <tt>log</tt> or 1.617 -<tt>-a</tt>). Optional parameter <tt>--nb=</tt> lets you set number of displayed 1.618 -lines.</p> 1.619 +<p>Display TazPkg activity log (<tt>activity</tt> or <tt>log</tt> or <tt>-a</tt>). Optional 1.620 +parameter <tt>--nb=</tt> lets you set number of displayed lines.</p> 1.621 1.622 <pre> 1.623 $ tazpkg activity 1.624 $ tazpkg -a --nb=<em>20</em> 1.625 </pre> 1.626 +</article> 1.627 1.628 1.629 -<h3 id="clean-cache">clean-cache</h3> 1.630 +<article id="clean-cache"><h3>clean-cache</h3> 1.631 1.632 -<p>Remove *.tazpkg packages downloaded to the cache (<tt>clean-cache</tt> or 1.633 -<tt>-cc</tt>). During installation, TazPkg keeps a copy of packages downloaded 1.634 -from the Web. This is done to save bandwidth in case of reinstallation, but you 1.635 -may want to free up space on the hard drive or re-download the packages.</p> 1.636 +<p>Remove *.tazpkg packages downloaded to the cache (<tt>clean-cache</tt> or <tt>-cc</tt>). During 1.637 +installation, TazPkg keeps a copy of packages downloaded from the Web. This is done to save 1.638 +bandwidth in case of reinstallation, but you may want to free up space on the hard drive or 1.639 +re-download the packages.</p> 1.640 1.641 <pre> 1.642 # tazpkg clean-cache 1.643 # tazpkg -cc 1.644 </pre> 1.645 +</article> 1.646 1.647 1.648 -<h3 id="shell">shell</h3> 1.649 +<article id="shell"><h3>shell</h3> 1.650 1.651 -<p>Run interactive TazPkg shell. Here you can enter all the TazPkg commands 1.652 -listed above.</p> 1.653 +<p>Run interactive TazPkg shell. Here you can enter all the TazPkg commands listed above.</p> 1.654 1.655 <pre> 1.656 $ tazpkg shell 1.657 # tazpkg shell 1.658 </pre> 1.659 +</article> 1.660 +</section> 1.661 1.662 1.663 1.664 1.665 -<h2>Working with lists</h2> 1.666 +<section><header>Working with lists</header> 1.667 1.668 1.669 -<h3 id="list">list</h3> 1.670 +<article id="list"><h3>list</h3> 1.671 1.672 -<p>List packages installed on the system (<tt>list</tt> or <tt>-l</tt>). This 1.673 -command displays a column list of all installed packages. It also allows you to 1.674 -list the categories (<tt>c</tt> or <tt>cat</tt> or <tt>categories</tt>), 1.675 -packages based on category and packages placed on hold (<tt>b</tt> or 1.676 -<tt>blocked</tt>). You can also use the <tt><a href="#search">search</a></tt> 1.677 +<p>List packages installed on the system (<tt>list</tt> or <tt>-l</tt>). This command displays a 1.678 +column list of all installed packages. It also allows you to list the categories (<tt>c</tt> or 1.679 +<tt>cat</tt> or <tt>categories</tt>), packages based on category and packages placed on hold 1.680 +(<tt>b</tt> or <tt>blocked</tt>). You can also use the <tt><a href="#search">search</a></tt> 1.681 command for a list based on a term or package name.</p> 1.682 1.683 <pre> 1.684 @@ -449,168 +425,198 @@ 1.685 $ tazpkg list <em>games</em> 1.686 $ tazpkg list blocked 1.687 </pre> 1.688 +</article> 1.689 1.690 1.691 -<h3 id="list-mirror">list-mirror</h3> 1.692 +<article id="list-mirror"><h3>list-mirror</h3> 1.693 1.694 -<p>List packages available on the mirror (<tt>list-mirror</tt> or <tt>-lm</tt>). 1.695 -This command will display the packages list recharged from the mirror. If it 1.696 -doesn't exist, you will be asked to launch <code>tazpkg 1.697 -<a href="#recharge">recharge</a></code> as administrator (root) for a list of 1.698 -available packages. The <tt>--diff</tt> option is used to display the 1.699 -differences between the last and current list of packages.</p> 1.700 +<p>List packages available on the mirror (<tt>list-mirror</tt> or <tt>-lm</tt>). This command will 1.701 +display the packages list recharged from the mirror. If it doesn't exist, you will be asked to 1.702 +launch <code>tazpkg <a href="#recharge">recharge</a></code> as administrator (root) for a list of 1.703 +available packages. The <tt>--diff</tt> option is used to display the differences between the last 1.704 +and current list of packages.</p> 1.705 1.706 <pre> 1.707 $ tazpkg list-mirror 1.708 $ tazpkg -lm --diff 1.709 </pre> 1.710 +</article> 1.711 1.712 1.713 -<h3 id="list-config">list-config</h3> 1.714 +<article id="list-config"><h3>list-config</h3> 1.715 1.716 -<p>Lists the system configuration files. The <tt>--box</tt> option displays in 1.717 -table form. You can specify package name to display configuration files only for 1.718 -this package.</p> 1.719 +<p>Lists the system configuration files. The <tt>--box</tt> option displays in table form. You can 1.720 +specify package name to display configuration files only for this package.</p> 1.721 1.722 <pre> 1.723 $ tazpkg list-config 1.724 $ tazpkg list-config --box 1.725 $ tazpkg list-config <em>slim</em> 1.726 -$ tazpkg list-config --box <em>slim</em> 1.727 +$ tazpkg list-config <em>slim</em> --box 1.728 </pre> 1.729 +</article> 1.730 +</section> 1.731 1.732 1.733 1.734 1.735 -<h2>Search</h2> 1.736 +<section><header>Search</header> 1.737 1.738 1.739 -<h3 id="search">search</h3> 1.740 +<article id="search"><h3>search</h3> 1.741 1.742 -<p>Search for packages by owner or package name (<tt>search</tt> or 1.743 -<tt>-s</tt>). This command will search for the term wanted in the installed 1.744 -packages (<tt>-i</tt> or <tt>--installed</tt>) and the list of available 1.745 -packages on the mirror (<tt>-l</tt> or <tt>--list</tt>).</p> 1.746 +<p>Search for packages by owner or package name (<tt>search</tt> or <tt>-s</tt>). This command will 1.747 +search for the term wanted in the installed packages (<tt>-i</tt> or <tt>--installed</tt>) and the 1.748 +list of available packages on the mirror (<tt>-l</tt> or <tt>--list</tt>).</p> 1.749 1.750 -<p>To obtain the latest list of installable packages on the mirror, just run 1.751 -<code>tazpkg recharge</code> before conducting a search.</p> 1.752 +<p>To obtain the latest list of installable packages on the mirror, just run <code>tazpkg 1.753 +recharge</code> before conducting a search.</p> 1.754 1.755 <pre> 1.756 $ tazpkg search <em>gcc</em> 1.757 $ tazpkg search <em>mt</em> -i 1.758 $ tazpkg search <em>bit</em> -l 1.759 </pre> 1.760 +</article> 1.761 1.762 1.763 -<h3 id="search-pkgname">search-pkgname</h3> 1.764 +<article id="search-pkgname"><h3>search-pkgname</h3> 1.765 1.766 -<p>Search for a file on mirror and output only the packages names 1.767 -(<tt>search-pkgname</tt> or <tt>-sp</tt>).</p> 1.768 +<p>Search for a file on mirror and output only the packages names (<tt>search-pkgname</tt> or 1.769 +<tt>-sp</tt>).</p> 1.770 1.771 <pre> 1.772 $ tazpkg search-pkgname <em>libnss</em> 1.773 $ tazpkg -sp <em>/usr/share/fonts</em> 1.774 </pre> 1.775 +</article> 1.776 1.777 1.778 -<h3 id="search-file">search-file</h3> 1.779 +<article id="search-file"><h3>search-file</h3> 1.780 1.781 -<p>Search for a file among the files installed by the packages 1.782 -(<tt>search-file</tt> or <tt>-sf</tt>). This command is very useful to find the 1.783 -full path to a file and determine if a file is present on the system. Option 1.784 -<tt>--mirror</tt> allows to search for a file among all the files available on 1.785 -the mirror.</p> 1.786 +<p>Search for a file among the files installed by the packages (<tt>search-file</tt> or 1.787 +<tt>-sf</tt>). This command is very useful to find the full path to a file and determine if a file 1.788 +is present on the system. Option <tt>--mirror</tt> allows to search for a file among all the files 1.789 +available on the mirror.</p> 1.790 1.791 <pre> 1.792 $ tazpkg search-file <em>libnss</em> 1.793 $ tazpkg -sf <em>/usr/share/fonts</em> --mirror 1.794 </pre> 1.795 +</article> 1.796 +</section> 1.797 1.798 1.799 1.800 1.801 -<h2>Installing and removing packages</h2> 1.802 +<section><header>Installing and removing packages</header> 1.803 1.804 1.805 -<h3 id="get">get</h3> 1.806 +<article id="get"><h3>get</h3> 1.807 1.808 -<p>Get a package from the mirror (<tt>get</tt> or <tt>-g</tt>). The downloaded 1.809 -package is stored in the current directory. To find the path you can use 1.810 -<code>pwd</code>.</p> 1.811 +<p>Get a package from the mirror (<tt>get</tt> or <tt>-g</tt>). The downloaded package is stored in 1.812 +the current directory. You will get regular package, or get-package, or extra-package (in that 1.813 +order). You can specify <tt>--extra</tt> option to get an extra-package only.</p> 1.814 + 1.815 +<p>You can specify multiple packages on the command line or give tazpkg a list of the packages you 1.816 +want to download or use <tt><a href="#get-list">get-list</a></tt> command.</p> 1.817 1.818 <pre> 1.819 # tazpkg get <em>grub</em> 1.820 # tazpkg get <em>nano</em> --root=<em>/mnt/sda6</em> 1.821 +# tazpkg get <em>palemoon</em> --extra 1.822 +# tazpkg -g <em>nano mc</em> 1.823 +# tazpkg -g --list=<em>/tmp/office</em> 1.824 </pre> 1.825 +</article> 1.826 1.827 1.828 -<h3 id="install">install</h3> 1.829 +<article id="install"><h3>install</h3> 1.830 1.831 -<p>This command allows the installation of a local package with the 1.832 -<tt>.tazpkg</tt> extension (<tt>install</tt> or <tt>-i</tt>). See 1.833 -<tt><a href="#get-install">get-install</a></tt> to install a package from the 1.834 -internet. Note that you can force the installation via the <tt>--forced</tt> 1.835 -option. Option <tt>--newconf</tt> allows you to rewrite all user configuration files 1.836 -using the new files from package. Option <tt>--nodeps</tt> allows you to install only 1.837 -a specified package without its dependencies.</p> 1.838 +<p>This command allows the installation of a local package with the <tt>.tazpkg</tt> extension 1.839 +(<tt>install</tt> or <tt>-i</tt>).</p> 1.840 + 1.841 +<p>Option <tt>--forced</tt> allows you to update an already installed package. Option 1.842 +<tt>--newconf</tt> allows you to rewrite all user configuration files using the new files from a 1.843 +package. Option <tt>--nodeps</tt> allows you to install only a specified package without its 1.844 +dependencies.</p> 1.845 + 1.846 +<p>You can specify multiple packages on the command line or give tazpkg a list of the packages you 1.847 +want to install or use <tt><a href="#get-list">install-list</a></tt> command.</p> 1.848 + 1.849 +<p>See <tt><a href="#get-install">get-install</a></tt> to install a package from the internet.</p> 1.850 1.851 <pre> 1.852 # tazpkg install <em>package-1.0.tazpkg</em> 1.853 # tazpkg -i <em>path/to/package-1.0.tazpkg</em> --forced 1.854 # tazpkg -i <em>path/to/package-1.0.tazpkg</em> --root=<em>/mnt/rootfs</em> 1.855 +# tazpkg -i <em>nano-2.4.0.tazpkg mc-4.8.14.tazpkg</em> 1.856 +# tazpkg -i --list=<em>/tmp/development</em> 1.857 </pre> 1.858 +</article> 1.859 1.860 1.861 -<h3 id="get-install">get-install</h3> 1.862 +<article id="get-install"><h3>get-install</h3> 1.863 1.864 -<p>Get and install a package from a mirror on the internet (<tt>get-install</tt> 1.865 -or <tt>-gi</tt>). Command begins by checking whether the package exists on the 1.866 -mirror and if it has been already downloaded. For a list of packages on the 1.867 -mirror, we must use the <tt><a href="#list-mirror">list-mirror</a></tt> 1.868 -command. Note that you can force the installation via the <tt>--forced</tt> 1.869 -option. Option <tt>--newconf</tt> allows you to rewrite all user configuration files 1.870 -using the new files from a package. Option <tt>--nodeps</tt> allows you to install only 1.871 -a specified package without its dependencies.</p> 1.872 - 1.873 -<p>Option <tt>--forced</tt> allows you to update an already installed package.</p> 1.874 +<p>Get and install a package from a mirror on the internet (<tt>get-install</tt> or <tt>-gi</tt>). 1.875 +Command begins by checking whether the package exists on the mirror and if it has been already 1.876 +downloaded.</p> 1.877 + 1.878 +<p>Option <tt>--forced</tt> allows you to update an already installed package. Option 1.879 +<tt>--newconf</tt> allows you to rewrite all user configuration files using the new files from a 1.880 +package. Option <tt>--nodeps</tt> allows you to install only a specified package without its 1.881 +dependencies.</p> 1.882 + 1.883 +<p>You can specify multiple packages on the command line or give tazpkg a list of the packages you 1.884 +want to get and install or use <tt><a href="#get-list">get-install-list</a></tt> 1.885 +command.</p> 1.886 + 1.887 +<p>For a list of packages on the mirror, you must use the <tt><a 1.888 +href="#list-mirror">list-mirror</a></tt> command.</p> 1.889 1.890 <pre> 1.891 # tazpkg get-install <em>grub</em> 1.892 # tazpkg -gi <em>grub</em> --forced 1.893 # tazpkg -gi <em>nano</em> --root=<em>/mnt/sda6</em> 1.894 +# tazpkg -gi <em>nano mc</em> 1.895 +# tazpkg -gi --list=<em>/tmp/multimedia</em> 1.896 </pre> 1.897 +</article> 1.898 1.899 1.900 -<h3 id="install-list">install-list, get-install-list</h3> 1.901 +<article id="get-list"><h3>get-list, install-list, get-install-list</h3> 1.902 1.903 -<p>Install a set of packages listed in a file. This command allows you to 1.904 -(download and) install several packages with a single command and can also be 1.905 -forced.</p> 1.906 +<p>Get and/or install a set of packages listed in a file. This command allows you to work with the 1.907 +several packages with a single command.</p> 1.908 + 1.909 +<p>All options are the same as for respective simple commands: <tt><a href="#get">get</a></tt>, 1.910 +<tt><a href="#install">install</a></tt> and <tt><a href="#get-install">get-install</a></tt>.</p> 1.911 1.912 <pre> 1.913 # tazpkg install-list <em>my-packages.list</em> 1.914 # tazpkg get-install-list <em>my-packages.list</em> --forced 1.915 </pre> 1.916 +</article> 1.917 1.918 1.919 -<h3 id="remove">remove</h3> 1.920 +<article id="remove"><h3>remove</h3> 1.921 1.922 -<p>Remove a package (<tt>remove</tt> or <tt>-r</tt>). You will be asked for 1.923 -confirmation (y/N) of removing the package, as well as for removing packages 1.924 -depending on this package, and for reinstalling packages modified by this 1.925 -package. This command will delete all files installed with the package.</p> 1.926 +<p>Remove a package (<tt>remove</tt> or <tt>-r</tt>). You will be asked for confirmation (y/N) of 1.927 +removing the package, as well as for removing packages depending on this package, and for 1.928 +reinstalling packages modified by this package. This command will delete all files installed with 1.929 +the package.</p> 1.930 1.931 -<p>Option <tt>--auto</tt> removes and reinstalls packages without your 1.932 -confirmation.</p> 1.933 +<p>Option <tt>--auto</tt> removes and reinstalls packages without your confirmation.</p> 1.934 1.935 <pre> 1.936 # tazpkg remove <em>bc</em> 1.937 # tazpkg -r <em>gtk+-3</em> --root=<em>/mnt/sda6</em> 1.938 # tazpkg -r <em>nano</em> --auto 1.939 </pre> 1.940 +</article> 1.941 1.942 1.943 -<h3 id="reconfigure">reconfigure</h3> 1.944 +<article id="reconfigure"><h3>reconfigure</h3> 1.945 1.946 <p>Replays the post-install script from the package.</p> 1.947 1.948 @@ -618,106 +624,111 @@ 1.949 # tazpkg reconfigure <em>gcc</em> 1.950 # tazpkg reconfigure <em>gcc</em> --root=<em>/mnt/sda6</em> 1.951 </pre> 1.952 +</article> 1.953 1.954 1.955 -<h3 id="link">link</h3> 1.956 +<article id="link"><h3>link</h3> 1.957 1.958 -<p>This command allows the installation of a package from another media device. 1.959 -The set up is done through symbolic links and consumes very little memory. It is 1.960 -generally used within the system RAM to install add-ons from a USB key.</p> 1.961 +<p>This command allows the installation of a package from another media device. The set up is done 1.962 +through symbolic links and consumes very little memory. It is generally used within the system RAM 1.963 +to install add-ons from a USB key.</p> 1.964 1.965 <pre> 1.966 # tazpkg link <em>openoffice /media/usbdisk</em> 1.967 </pre> 1.968 +</article> 1.969 1.970 1.971 -<h3 id="set-release">set-release</h3> 1.972 +<article id="set-release"><h3>set-release</h3> 1.973 1.974 -<p>The <tt>set-release</tt> command changes the current version and upgrades all 1.975 -of the packages to the latest release.</p> 1.976 +<p>This command changes the current version and upgrades all of the packages to the latest 1.977 +release.</p> 1.978 1.979 <pre> 1.980 # tazpkg set-release <em>cooking</em> 1.981 </pre> 1.982 +</article> 1.983 1.984 1.985 -<h3 id="add-flavor">add-flavor, install-flavor</h3> 1.986 +<article id="add-flavor"><h3>add-flavor, install-flavor</h3> 1.987 1.988 -<p>Install a set of packages from a flavor. In addition, <tt>install-flavor</tt> 1.989 -purges other installed packages.</p> 1.990 +<p>Install a set of packages from a flavor. In addition, <tt>install-flavor</tt> purges other 1.991 +installed packages.</p> 1.992 1.993 <pre> 1.994 # tazpkg add-flavor <em>gtkonly</em> 1.995 # tazpkg install-flavor <em>justx</em> 1.996 </pre> 1.997 +</article> 1.998 +</section> 1.999 1.1000 1.1001 1.1002 1.1003 -<h2>Working with packages</h2> 1.1004 +<section><header>Working with packages</header> 1.1005 1.1006 1.1007 -<h3 id="info">info</h3> 1.1008 +<article id="info"><h3>info</h3> 1.1009 1.1010 -<p>Show all the available information related to your package. You can specify 1.1011 -the name of the installed package or a package that is not yet installed, but 1.1012 -available in the repository. You can also get information about a local file 1.1013 -package by entering an absolute or relative path to the file <tt>.tazpkg</tt>. 1.1014 -The information contained in the TazPkg database and in the package recipe — 1.1015 -its version, category, maintainer, Web site and all the dependencies (see also 1.1016 -Cookutils for more information on recipes).</p> 1.1017 +<p>Show all the available information related to your package. You can specify the name of the 1.1018 +installed package or a package that is not yet installed, but available in the repository. You can 1.1019 +also get information about a local file package by entering an absolute or relative path to the file 1.1020 +<tt>.tazpkg</tt>. The information contained in the TazPkg database and in the package recipe — its 1.1021 +version, category, maintainer, Web site and all the dependencies (see also <a 1.1022 +href="../cookutils/cookutils.en.html" target="_blank">Cookutils</a> for more information on 1.1023 +recipes).</p> 1.1024 1.1025 <pre> 1.1026 $ tazpkg info <em>busybox</em> 1.1027 $ tazpkg info <em>minitube</em> 1.1028 $ tazpkg info <em>packages/comix-4.0.4.tazpkg</em> 1.1029 </pre> 1.1030 +</article> 1.1031 1.1032 1.1033 -<h3 id="desc">desc</h3> 1.1034 +<article id="desc"><h3>desc</h3> 1.1035 1.1036 -<p>Description of the package (if it exists) (<tt>desc</tt> or <tt>-d</tt>). 1.1037 -This command displays the <tt>description.txt</tt> file of each package (a 1.1038 -simple text file, justified to 80 characters to fit in a standard terminal).</p> 1.1039 +<p>Description of the package (<tt>desc</tt> or <tt>-d</tt>).</p> 1.1040 1.1041 <pre> 1.1042 $ tazpkg desc <em>busybox</em> 1.1043 </pre> 1.1044 +</article> 1.1045 1.1046 1.1047 -<h3 id="list-files">list-files</h3> 1.1048 +<article id="list-files"><h3>list-files</h3> 1.1049 1.1050 -<p>List all files installed with a package (<tt>list-files</tt> or 1.1051 -<tt>-lf</tt>). This command will simply read and display the <tt>files.list</tt> 1.1052 -of each package which is automatically generated when the package is created and 1.1053 -is also used to remove files when uninstalling a package.</p> 1.1054 +<p>List all files installed with a package (<tt>list-files</tt> or <tt>-lf</tt>). This command will 1.1055 +simply read and display the <tt>files.list</tt> of each package which is automatically generated 1.1056 +when the package is created and is also used to remove files when uninstalling a package.</p> 1.1057 1.1058 <pre> 1.1059 $ tazpkg list-files <em>bc</em> 1.1060 </pre> 1.1061 +</article> 1.1062 1.1063 1.1064 -<h3 id="block">block, unblock, chblock</h3> 1.1065 +<article id="block"><h3>block, unblock, chblock</h3> 1.1066 1.1067 -<p>The <tt>block</tt> (or <tt>-b</tt>) and <tt>unblock</tt> (or <tt>-u</tt>) 1.1068 -commands permit you to block installed package versions so that they are not 1.1069 -maintained by an <tt><a href="#upgrade">upgrade</a></tt>. Command 1.1070 -<tt>chblock</tt> changes the blocking state of the package. The list of packages on 1.1071 -hold are contained in the <tt>/var/lib/tazpkg/blocked-packages.list</tt>. This 1.1072 -file can also be edited by hand.</p> 1.1073 +<p>The <tt>block</tt> (or <tt>-b</tt>) and <tt>unblock</tt> (or <tt>-u</tt>) commands permit you to 1.1074 +block installed package versions so that they are not maintained by an <tt><a 1.1075 +href="#upgrade">upgrade</a></tt>. Command <tt>chblock</tt> changes the blocking state of the 1.1076 +package. The list of packages on hold are contained in the 1.1077 +<tt>/var/lib/tazpkg/blocked-packages.list</tt>. This file can also be edited by hand.</p> 1.1078 1.1079 <pre> 1.1080 # tazpkg block <em>grub</em> 1.1081 # tazpkg unblock <em>grub</em> 1.1082 # tazpkg chblock <em>grub</em> 1.1083 </pre> 1.1084 +</article> 1.1085 1.1086 1.1087 -<h3 id="check">check</h3> 1.1088 +<article id="check"><h3>check</h3> 1.1089 1.1090 -<p>The <tt>check</tt> command can check dependencies on installed packages and 1.1091 -determine whether all the files needed for the repacking of packages are 1.1092 -present.</p> 1.1093 +<p>Check dependencies on installed packages and determine whether all the files needed for the 1.1094 +repacking of packages are present. You can specify package name to check or check all installed 1.1095 +packages. Option <tt>--full</tt> makes few more checks and need more time.</p> 1.1096 1.1097 <pre> 1.1098 $ tazpkg check 1.1099 @@ -725,167 +736,168 @@ 1.1100 $ tazpkg check <em>nano</em> 1.1101 $ tazpkg check <em>sakura</em> --full 1.1102 </pre> 1.1103 +</article> 1.1104 1.1105 1.1106 -<h3 id="bugs">bugs</h3> 1.1107 +<article id="bugs"><h3>bugs</h3> 1.1108 1.1109 -<p>Generates a list of known bugs in the packages. You can specify a single 1.1110 -package to show bugs.</p> 1.1111 +<p>Generates a list of known bugs in the packages. You can specify a single package to show 1.1112 +bugs.</p> 1.1113 1.1114 <pre> 1.1115 $ tazpkg bugs 1.1116 -$ tazpkg bugs <em>my_package</em> 1.1117 +$ tazpkg bugs <em>nano</em> 1.1118 </pre> 1.1119 +</article> 1.1120 1.1121 1.1122 -<h3 id="depends">depends, rdepends</h3> 1.1123 +<article id="depends"><h3>depends, rdepends</h3> 1.1124 1.1125 <p>Displays a dependency tree or reverse dependency tree for a package.</p> 1.1126 1.1127 -<p>For <code>depends</code> command: option <tt>--mark</tt> marks installed 1.1128 -packages with plus sign and not installed with a minus/dash. Option 1.1129 -<tt>--total</tt> calculates the number of displayed packages and their size. Also, 1.1130 -with both options at a time you'll get the number and size of packages to be 1.1131 -installed.</p> 1.1132 +<p>For <code>depends</code> command: option <tt>--mark</tt> marks installed packages with plus sign 1.1133 +and not installed with a minus/dash. Option <tt>--total</tt> calculates the number of displayed 1.1134 +packages and their size. Also, with both options at a time you'll get the number and size of 1.1135 +packages to be installed.</p> 1.1136 1.1137 -<p>For <code>rdepends</code> command: without the <tt>--all</tt> option you'll get 1.1138 -the list of only installed reverse dependency packages, with this option — a list 1.1139 -of all available packages. Option <tt>--mark</tt> marks packages as in the 1.1140 -<code>depends</code> command.</p> 1.1141 +<p>For <code>rdepends</code> command: <em>without</em> the <tt>--all</tt> option you'll get the list 1.1142 +of only installed reverse dependency packages, <em>with</em> this option — a list of all available 1.1143 +packages. Option <tt>--mark</tt> marks packages as in the <code>depends</code> command.</p> 1.1144 1.1145 <pre> 1.1146 -# tazpkg depends <em>mpd</em> 1.1147 -# tazpkg rdepends <em>mpd</em> 1.1148 +$ tazpkg depends <em>mpd</em> 1.1149 +$ tazpkg rdepends <em>mpd</em> 1.1150 </pre> 1.1151 +</article> 1.1152 1.1153 1.1154 -<h3 id="extract">extract</h3> 1.1155 +<article id="extract"><h3>extract</h3> 1.1156 1.1157 -<p>Extract a package into a directory (<tt>extract</tt> or <tt>-e</tt>). If you 1.1158 -do not specify the destination directory, the package will be extracted in the 1.1159 -current directory using the name <tt><em>package-version</em></tt>.</p> 1.1160 +<p>Extract a package into a directory (<tt>extract</tt> or <tt>-e</tt>). If you do not specify the 1.1161 +destination directory, the package will be extracted in the current directory using the name 1.1162 +<tt><em>package-version</em></tt>.</p> 1.1163 1.1164 <pre> 1.1165 $ tazpkg extract <em>package.tazpkg</em> 1.1166 $ tazpkg extract <em>package.tazpkg target/dir</em> 1.1167 </pre> 1.1168 +</article> 1.1169 1.1170 1.1171 -<h3 id="pack">pack</h3> 1.1172 +<article id="pack"><h3>pack</h3> 1.1173 1.1174 -<p>The <tt>pack</tt> command will create a package from a directory prepared in 1.1175 -advance or from an unpacked package. It can also manually create a .tazpkg 1.1176 -package (see the Cookutils documentation for the automatic creation of 1.1177 -packages).</p> 1.1178 +<p>Create a package from a directory prepared in advance or from an unpacked package. It can also 1.1179 +manually create a <tt>.tazpkg</tt> package (see the <a href="../cookutils/cookutils.en.html" 1.1180 +target="_blank">Cookutils</a> documentation for the automatic creation of packages).</p> 1.1181 1.1182 <pre> 1.1183 # tazpkg pack <em>package-version</em> 1.1184 </pre> 1.1185 +</article> 1.1186 1.1187 1.1188 -<h3 id="repack">repack</h3> 1.1189 +<article id="repack"><h3>repack</h3> 1.1190 1.1191 -<p>The <tt>repack</tt> command allows you to recreate a package from the files 1.1192 -on a system where it was previously installed.</p> 1.1193 +<p>Recreate a package from the files on a system where it was previously installed.</p> 1.1194 1.1195 <pre> 1.1196 -$ tazpkg repack <em>package</em> 1.1197 +# tazpkg repack <em>package</em> 1.1198 </pre> 1.1199 +</article> 1.1200 1.1201 1.1202 -<h3 id="repack-config">repack-config</h3> 1.1203 +<article id="repack-config"><h3>repack-config</h3> 1.1204 1.1205 -<p>The <tt>repack-config</tt> command recreates a package of the system 1.1206 -configuration files (see <tt><a href="#list-config">list-config</a></tt>). It is 1.1207 -enough to install the package to find the current configuration.</p> 1.1208 +<p>Recreate a package of the system configuration files (see <tt><a 1.1209 +href="#list-config">list-config</a></tt>). It is enough to install the package to find the current 1.1210 +configuration.</p> 1.1211 1.1212 <pre> 1.1213 # tazpkg repack-config 1.1214 </pre> 1.1215 +</article> 1.1216 1.1217 1.1218 -<h3 id="recompress">recompress</h3> 1.1219 +<article id="recompress"><h3>recompress</h3> 1.1220 1.1221 -<p>Recompress .tazpkg cpio archive with lzma.</p> 1.1222 +<p>Recompress <tt>.tazpkg</tt> cpio archive with lzma.</p> 1.1223 1.1224 <pre> 1.1225 -$ tazpkg recompress <em>package.tazpkg</em> 1.1226 +# tazpkg recompress <em>package.tazpkg</em> 1.1227 </pre> 1.1228 +</article> 1.1229 1.1230 1.1231 -<h3 id="convert">convert</h3> 1.1232 +<article id="convert"><h3>convert</h3> 1.1233 1.1234 -<p>Converts an "alien" package into a SliTaz package (.tazpkg) (<tt>convert</tt> 1.1235 -or <tt>-c</tt>).</p> 1.1236 +<p>Converts an “alien” package into a SliTaz package (<tt>.tazpkg</tt>) (<tt>convert</tt> or 1.1237 +<tt>-c</tt>).</p> 1.1238 1.1239 <p>Supported packages formats:</p> 1.1240 1.1241 <ul> 1.1242 - <li><a href="https://packages.debian.org/search" target="_blank">Debian 1.1243 - packages</a> (<tt>*.deb</tt>, <tt>*.udeb</tt>)</li> 1.1244 - <li><a href="http://rpmfind.net/linux/rpm2html/search.php" 1.1245 - target="_blank">RPM packages</a> (<tt>*.rpm</tt>)</li> 1.1246 + <li><a href="https://packages.debian.org/search" target="_blank">Debian packages</a> 1.1247 + (<tt>*.deb</tt>, <tt>*.udeb</tt>)</li> 1.1248 + <li><a href="http://rpmfind.net/linux/rpm2html/search.php" target="_blank">RPM packages</a> 1.1249 + (<tt>*.rpm</tt>)</li> 1.1250 <li><a href="http://www.slax.org/" target="_blank">Slax packages</a> 1.1251 (<tt>*.sb</tt>)</li> 1.1252 <li><a href="http://puppylinux.org/" target="_blank">Puppy packages</a> 1.1253 (<tt>*.sfs</tt>, <tt>*.pet</tt>)</li> 1.1254 - <li><a href="http://www.slackware.com/packages/" target="_blank">Slackware 1.1255 - packages</a> (<tt>*.tgz</tt>)</li> 1.1256 + <li><a href="http://www.slackware.com/packages/" target="_blank">Slackware packages</a> 1.1257 + (<tt>*.tgz</tt>)</li> 1.1258 <li><a href="http://www.nutyx.org/" target="_blank">NuTyX packages</a> 1.1259 (<tt>*.cards.tar.xz</tt>)</li> 1.1260 - <li><a href="https://www.archlinux.org/packages/" target="_blank">Arch 1.1261 - Linux</a> / <a href="http://pkgs.alpinelinux.org/packages" 1.1262 - target="_blank">Alpine Linux packages</a> (<tt>*.apk</tt>, 1.1263 - <tt>*.pkg.tar.gz</tt>, <tt>*.pkg.tar.xz</tt>)</li> 1.1264 - <li><a href="http://wiki.openwrt.org/doc/packages" target="_blank">OpenWrt 1.1265 - packages</a> (<tt>*.ipk</tt>, <tt>*.opk</tt>)</li> 1.1266 - <li><a href="http://0.tuxfamily.org/doku.php/paquets/start" 1.1267 - target="_blank">0Linux packages</a> (<tt>*.spack</tt>)</li> 1.1268 - <li><a href="http://www.paldo.org/index-section-packages.html" 1.1269 - target="_blank">paldo packages</a> (<tt>*.tar.bz2</tt>)</li> 1.1270 - <li><a href="http://www.voidlinux.eu/packages/" target="_blank">Void 1.1271 - packages</a> (<tt>*.xbps</tt>)</li> 1.1272 - <li><a href="http://tinycorelinux.net/" target="_blank">Tinycore 1.1273 - packages</a> (<tt>*.tce</tt>, <tt>*.tcel</tt>, <tt>*.tcem</tt>, 1.1274 - <tt>*.tcz</tt>)</li> 1.1275 + <li><a href="https://www.archlinux.org/packages/" target="_blank">Arch Linux</a> / 1.1276 + <a href="http://pkgs.alpinelinux.org/packages" target="_blank">Alpine Linux packages</a> 1.1277 + (<tt>*.apk</tt>, <tt>*.pkg.tar.gz</tt>, <tt>*.pkg.tar.xz</tt>)</li> 1.1278 + <li><a href="http://wiki.openwrt.org/doc/packages" target="_blank">OpenWrt packages</a> 1.1279 + (<tt>*.ipk</tt>, <tt>*.opk</tt>)</li> 1.1280 + <li><a href="http://0.tuxfamily.org/doku.php/paquets/start" target="_blank">0Linux packages</a> 1.1281 + (<tt>*.spack</tt>)</li> 1.1282 + <li><a href="http://www.paldo.org/index-section-packages.html" target="_blank">paldo packages</a> 1.1283 + (<tt>*.tar.bz2</tt>)</li> 1.1284 + <li><a href="http://www.voidlinux.eu/packages/" target="_blank">Void packages</a> 1.1285 + (<tt>*.xbps</tt>)</li> 1.1286 + <li><a href="http://tinycorelinux.net/" target="_blank">Tinycore packages</a> 1.1287 + (<tt>*.tce</tt>, <tt>*.tcel</tt>, <tt>*.tcem</tt>, <tt>*.tcz</tt>)</li> 1.1288 </ul> 1.1289 1.1290 <pre> 1.1291 # tazpkg convert <em>alien-package-file</em> 1.1292 </pre> 1.1293 +</article> 1.1294 1.1295 1.1296 -<h3 id="list-suggested">list-suggested</h3> 1.1297 +<article id="list-suggested"><h3>list-suggested</h3> 1.1298 1.1299 -<p>List suggested packages for each of your installed packages. With option 1.1300 -<tt>--all</tt> it shows all suggested packages, and without option it shows only 1.1301 -non installed suggested packages.</p> 1.1302 +<p>List suggested packages for each of your installed packages. With option <tt>--all</tt> it shows 1.1303 +all suggested packages, and without option it shows only non installed suggested packages.</p> 1.1304 1.1305 <pre> 1.1306 $ tazpkg list-suggested 1.1307 $ tazpkg list-suggested --all 1.1308 </pre> 1.1309 +</article> 1.1310 +</section> 1.1311 1.1312 1.1313 1.1314 1.1315 -<h2>Working with repositories</h2> 1.1316 +<section><header>Working with repositories</header> 1.1317 1.1318 1.1319 -<h3 id="recharge">recharge</h3> 1.1320 +<article id="recharge"><h3>recharge</h3> 1.1321 1.1322 -<p>Recharge the list of available packages on the mirror. This command will 1.1323 -download the most recent packages database of installable packages on the mirror 1.1324 -and before starting will save the old database. Once the DB is updated, you can 1.1325 -then use the <tt><a href="#list">list</a></tt> and 1.1326 -<tt><a href="#search">search</a></tt> commands. To view and list the 1.1327 -differences, you can use <code>list-mirror --diff</code>; and to view and update 1.1328 -packages, you can simply <tt><a href="#upgrade">upgrade</a></tt>.</p> 1.1329 +<p>Recharge the list of available packages on the mirror. This command will download the most recent 1.1330 +packages database of installable packages on the mirror and before starting will save the old 1.1331 +database. Once the DB is updated, you can then use the <tt><a href="#list">list</a></tt> and 1.1332 +<tt><a href="#search">search</a></tt> commands. To view and list the differences, you can use 1.1333 +<code>list-mirror --diff</code>; and to view and update packages, you can simply 1.1334 +<tt><a href="#upgrade">upgrade</a></tt>.</p> 1.1335 1.1336 -<p>Command without options will recharge databases of all your repositories. You 1.1337 -can specify the repository to be recharged: "main" for main repo, or undigest 1.1338 -repository name. Option <tt>--root=</tt> allows you to specify the root of the filesystem 1.1339 -where you want to recharge DB.</p> 1.1340 +<p>Command without options will recharge databases of all your repositories. You can specify the 1.1341 +repository to be recharged: “main” for main repo, or undigest repository name.</p> 1.1342 1.1343 <pre> 1.1344 # tazpkg recharge 1.1345 @@ -893,91 +905,94 @@ 1.1346 # tazpkg recharge <em>My_Undigest</em> 1.1347 # tazpkg recharge --root=<em>/mnt/sda6</em> 1.1348 </pre> 1.1349 +</article> 1.1350 1.1351 1.1352 -<h3 id="upgrade">upgrade</h3> 1.1353 +<article id="upgrade"><h3>upgrade</h3> 1.1354 1.1355 -<p>Upgrade allows you to update all installed packages available on the current 1.1356 -mirror (<tt>upgrade</tt> or <tt>up</tt>). Upgrading packages is an important 1.1357 -part of system security, it helps to keep you secure with the latest updates and 1.1358 -fixes. The SliTaz project, although tiny, provides regular updates on security 1.1359 -and generally offers the latest versions of software. Note that this function is 1.1360 -aimed at people with SliTaz installed on a hard drive. Updated packages in 1.1361 -Live CD mode will be lost on system shutdown.</p> 1.1362 +<p>Upgrade allows you to update all installed packages available on the current mirror 1.1363 +(<tt>upgrade</tt> or <tt>up</tt>). Upgrading packages is an important part of system security, it 1.1364 +helps to keep you secure with the latest updates and fixes. The SliTaz project, although tiny, 1.1365 +provides regular updates on security and generally offers the latest versions of software. Note that 1.1366 +this function is aimed at people with SliTaz installed on a hard drive. Updated packages in Live CD 1.1367 +mode will be lost on system shutdown.</p> 1.1368 1.1369 <p>At the beginning the packages database is updated automatically (<tt><a 1.1370 -href="#recharge">recharge</a></tt>) in order to provide you with the current 1.1371 -list of packages that you can update.</p> 1.1372 +href="#recharge">recharge</a></tt>) in order to provide you with the current list of packages that 1.1373 +you can update.</p> 1.1374 1.1375 -<p>Without options it runs in interactive mode and asks before install. You can 1.1376 -specify one of the next options: <tt>-c</tt> or <tt>--check</tt> to check only 1.1377 -for available upgrades; <tt>-i</tt> or <tt>--install</tt> to check for upgrades 1.1378 -and install them all.</p> 1.1379 +<p>Without options it runs in interactive mode and asks before install. You can specify one of the 1.1380 +next options: <tt>-c</tt> or <tt>--check</tt> to check only for available upgrades; <tt>-i</tt> or 1.1381 +<tt>--install</tt> to check for upgrades and install them all.</p> 1.1382 1.1383 <pre> 1.1384 # tazpkg upgrade 1.1385 # tazpkg up --check 1.1386 # tazpkg up -i 1.1387 </pre> 1.1388 +</article> 1.1389 1.1390 1.1391 -<h3 id="setup-mirror">setup-mirror</h3> 1.1392 +<article id="setup-mirror"><h3>setup-mirror</h3> 1.1393 1.1394 -<p>Setup the URL for the mirror. The <tt>setup-mirror</tt> (or <tt>-sm</tt>) 1.1395 -command will ask for the URL of the new mirror. Note that you can also modify 1.1396 -the main <tt>/var/lib/tazpkg/mirror</tt> file. The URL must point to the 1.1397 -directory containing the <tt>packages.info</tt> and packages.</p> 1.1398 +<p>Setup the URL for the mirror (<tt>setup-mirror</tt> or <tt>-sm</tt>). Command will ask for the 1.1399 +URL of the new mirror. Note that you can also modify the main <tt>/var/lib/tazpkg/mirror</tt> file. 1.1400 +The URL must point to the directory containing the <tt>packages.info</tt> and packages.</p> 1.1401 1.1402 <pre> 1.1403 # tazpkg setup-mirror 1.1404 </pre> 1.1405 +</article> 1.1406 1.1407 1.1408 -<h3 id="add-undigest">add-undigest, setup-undigest</h3> 1.1409 +<article id="add-undigest"><h3>add-undigest, setup-undigest</h3> 1.1410 1.1411 -<p>Set the URL of an additional unofficial mirror to test packages that are not 1.1412 -yet present on the official mirrors. Note, you can also manually edit the file 1.1413 -in <tt>/var/lib/tazpkg/undigest/<em>repository</em></tt>. The URL must point to 1.1414 -the directory containing the packages and <tt>packages.info</tt>.</p> 1.1415 +<p>Set the URL of an additional unofficial mirror to test packages that are not yet present on the 1.1416 +official mirrors. Note, you can also manually edit the file in 1.1417 +<tt>/var/lib/tazpkg/undigest/<em>repository</em></tt>. The URL must point to the directory 1.1418 +containing the packages and <tt>packages.info</tt>.</p> 1.1419 1.1420 <pre> 1.1421 # tazpkg add-undigest <em>public-repository http://my.home.org/slitaz</em> 1.1422 # tazpkg setup-undigest <em>local-repository /home/slitaz/packages</em> 1.1423 </pre> 1.1424 +</article> 1.1425 1.1426 1.1427 -<h3 id="list-undigest">list-undigest</h3> 1.1428 +<article id="list-undigest"><h3>list-undigest</h3> 1.1429 1.1430 -<p>Lists additional undigest mirrors. Option <tt>--box</tt> will output list in 1.1431 -the table form.</p> 1.1432 +<p>Lists additional undigest mirrors. Option <tt>--box</tt> will output list in the table form.</p> 1.1433 1.1434 <pre> 1.1435 -# tazpkg list-undigest 1.1436 -# tazpkg list-undigest --box 1.1437 +$ tazpkg list-undigest 1.1438 +$ tazpkg list-undigest --box 1.1439 </pre> 1.1440 +</article> 1.1441 1.1442 1.1443 -<h3 id="remove-undigest">remove-undigest</h3> 1.1444 +<article id="remove-undigest"><h3>remove-undigest</h3> 1.1445 1.1446 -<p>Removes the URL of an undigest mirror. You will be asked for 1.1447 -confirmation.</p> 1.1448 +<p>Removes the URL of an undigest mirror. You will be asked for confirmation.</p> 1.1449 1.1450 <pre> 1.1451 # tazpkg remove-undigest <em>my-repository</em> 1.1452 </pre> 1.1453 +</article> 1.1454 +</section> 1.1455 1.1456 1.1457 1.1458 1.1459 -<h2>Maintainer</h2> 1.1460 +<section><header>Maintainer</header> 1.1461 1.1462 <p>Christophe Lincoln <pankso at slitaz.org></p> 1.1463 +</section> 1.1464 1.1465 -</div> 1.1466 -<!-- End content --> 1.1467 + 1.1468 + 1.1469 1.1470 <footer> 1.1471 - Copyright © 2015 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a> 1.1472 + Copyright © 2015 <a href="http://www.slitaz.org/en/">SliTaz GNU/Linux</a> 1.1473 </footer> 1.1474 1.1475 </body>