tazinst rev 4

Edit tazinst.en.html
author Paul Issott <paul@slitaz.org>
date Fri Feb 15 20:01:37 2013 +0000 (2013-02-15)
parents 36808f594aa0
children cc9e582d5abc
files doc/tazinst.en.html
line diff
     1.1 --- a/doc/tazinst.en.html	Thu Feb 14 13:12:23 2013 +0100
     1.2 +++ b/doc/tazinst.en.html	Fri Feb 15 20:01:37 2013 +0000
     1.3 @@ -29,8 +29,8 @@
     1.4  <h2>DESCRIPTION</h2>
     1.5  <p>
     1.6  	Tazinst is a lightweight SliTaz HDD installer. It installs SliTaz
     1.7 -	to a hard drive from a local media like a Live-CD, a LiveUSB key, an ISO
     1.8 -	image located on one of your disks, or from	the web by automatically
     1.9 +	to a hard drive from any local media such as a Live-CD, a LiveUSB key, an ISO
    1.10 +	image located on one of your disks, or from the web by automatically
    1.11  	downloading a SliTaz image.
    1.12  </p>
    1.13  <p>
    1.14 @@ -38,13 +38,13 @@
    1.15  	partition can be installed on another partition and if need be, formatted
    1.16  	before installation into any one of the available formats. Tazinst may
    1.17  	upon request install a bootloader on the target disk. A dual-boot with an
    1.18 -	existing Windows<sup>&trade;</sup> partition is possible, finding the
    1.19 +	existing Windows<sup>&trade;</sup> partition is possible - finding the
    1.20  	Windows<sup>&trade;</sup> partition can either be done automatically or
    1.21  	manually specified.
    1.22  </p>
    1.23  <p>
    1.24  	Tazinst can also update SliTaz installed on a hard disk partition which is
    1.25 -	handy in case of version changes. In this case, Slitaz is updated, data in
    1.26 +	handy in case of version changes. In this case, Slitaz is updated, any data in
    1.27  	/home is preserved and additional packages are reinstalled on to the new
    1.28  	version.
    1.29  </p>
    1.30 @@ -59,7 +59,7 @@
    1.31  <h3>Known limitations</h3>
    1.32  <p>
    1.33  	Tazinst doesn't allow SliTaz to boot on (U)EFI systems (mostly
    1.34 -	Windows<sup>&trade;	</sup>8 systems), except in BIOS compatibility mode.
    1.35 +	Windows<sup>&trade;</sup> 8 systems), except in BIOS compatibility mode.
    1.36  </p>
    1.37  
    1.38  
    1.39 @@ -74,7 +74,7 @@
    1.40  <a id="mode"></a>
    1.41  <h3>mode</h3>
    1.42  <p>
    1.43 -	Mode of install that will be performed by tazinst. Type <strong><code>
    1.44 +	Installation mode that will be performed by tazinst. Type <strong><code>
    1.45  	tazinst help mode</code></strong> in order to have a list of supported
    1.46  	modes.
    1.47  </p>
    1.48 @@ -82,9 +82,9 @@
    1.49  <a id="media"></a>
    1.50  <h3>media</h3>
    1.51  <p>
    1.52 -	The media containing the SliTaz source files, either: <strong>cdrom</strong>
    1.53 +	The media containing the SliTaz source files, either <strong>cdrom</strong>
    1.54  	(SliTaz LiveCD), <strong>usb</strong> (SliTaz LiveUSB),	<strong>iso</strong>
    1.55 -	(ISO image of SliTaz), <strong>web</strong> (ISO image on the Web).
    1.56 +	(ISO image of SliTaz), or <strong>web</strong> (ISO image on the Web).
    1.57  </p>
    1.58  
    1.59  <a id="source"></a>
    1.60 @@ -104,16 +104,16 @@
    1.61  	</tr>
    1.62  	<tr>
    1.63  	<td>iso</td>
    1.64 -	<td>name of the ISO file, ex: <strong><code>~/slitaz-rolling.iso</code>
    1.65 +	<td>name of the ISO file, example: <strong><code>~/slitaz-rolling.iso</code>
    1.66  	</strong>. Type <code><strong>tazinst list iso</code></strong> to list
    1.67  		iso files on your disks.</code></strong></td>
    1.68  	</tr>
    1.69  	<tr>
    1.70  	<td>web</td>
    1.71 -	<td>name of the	image on the web, ex: <strong><code>stable cooking rolling
    1.72 +	<td>name of the	image on the web, example: <strong><code>stable cooking rolling
    1.73  	base core gtkonly justx</code></strong>, for a full list type <strong>
    1.74  	<code>tazinst list web</code></strong>, or enter the full URL of the image,
    1.75 -	ex: <strong><code>
    1.76 +	example: <strong><code>
    1.77  	http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso</code></strong>.
    1.78  	</td>
    1.79  	</tr>
    1.80 @@ -132,7 +132,7 @@
    1.81  <h3>root_format</h3>
    1.82  <p>
    1.83  	Optional. If this setting is used, the target partition will be formatted
    1.84 -	in the file	system specified, otherwise the partition will be cleaned and
    1.85 +	in the file system specified, otherwise the partition will be cleaned and
    1.86  	/home will be preserved. Type <strong><code>tazinst help format</code>
    1.87  	</strong> to get the list of all supported filesystems, and <strong><code>
    1.88  	tazinst list root_format</code></strong> to see filesystems already
    1.89 @@ -150,21 +150,21 @@
    1.90  <a id="home_format"></a>
    1.91  <h3>home_format</h3>
    1.92  <p>
    1.93 -	Optional. If this setting is used, and a separate /home partition will be
    1.94 +	Optional. If this setting is used, a separate /home partition will be
    1.95  	created, this partition will be formatted in the file system specified.
    1.96  </p>
    1.97  
    1.98  <a id="hostname"></a>
    1.99  <h3>hostname</h3>
   1.100  <p>
   1.101 -	Optional. Name of the system, <strong><code>slitaz</code></strong> by
   1.102 +	Optional. Hostname of the system, <strong><code>slitaz</code></strong> by
   1.103  	default.
   1.104  </p>
   1.105  
   1.106  <a id="root_pwd"></a>
   1.107  <h3>root_pwd</h3>
   1.108  <p>
   1.109 -	Optional. Superuser password, <strong><code>root</code></strong>, by
   1.110 +	Optional. Superuser [root] password, <strong><code>root</code></strong>, by
   1.111  	default.
   1.112  </p>
   1.113  
   1.114 @@ -206,7 +206,7 @@
   1.115  <a id="new"></a>
   1.116  <h3>new</h3>
   1.117  <p>
   1.118 -	Generates a new self-documenting install file, containing settings, which
   1.119 +	Generates a new self-documenting install file containing settings which,
   1.120  	when set up as required	by the user, will allow tazinst to execute an
   1.121  	unattended installation. The default file is <code>./tazint.rc</code>, but
   1.122  	an optional file name may be given as a parameter.
   1.123 @@ -231,7 +231,7 @@
   1.124  <a id="unset"></a>
   1.125  <h3>unset</h3>
   1.126  <p>
   1.127 -	Unset, clear a setting.
   1.128 +	Unset, clears a setting.
   1.129  </p>
   1.130  <h5>Examples:</h5>
   1.131  <pre>
   1.132 @@ -242,7 +242,7 @@
   1.133  <a id="get"></a>
   1.134  <h3>get</h3>
   1.135  <p>
   1.136 -	Get the value of a setting. Without parameter, get the values of all
   1.137 +	Get the value of a setting. Without a parameter, gets the values of all
   1.138  	settings.
   1.139  </p>
   1.140  <h5>Examples:</h5>
   1.141 @@ -255,7 +255,7 @@
   1.142  <a id="check"></a>
   1.143  <h3>check</h3>
   1.144  <p>
   1.145 -	Check a setting for errors. Without parameter, check all settings.
   1.146 +	Check a setting for errors. Without a parameter, checks all settings.
   1.147  
   1.148  </p>
   1.149  <h5>Examples:</h5>
   1.150 @@ -268,7 +268,7 @@
   1.151  <a id="list"></a>
   1.152  <h3>list</h3>
   1.153  <p>
   1.154 -	List system ressources. Ressources are:
   1.155 +	List the system resources. Resources are:
   1.156  	<table>
   1.157  	<tr>
   1.158  	<td>mode</td>
   1.159 @@ -276,7 +276,7 @@
   1.160  	</tr>
   1.161  	<tr>
   1.162  	<td>media</td>
   1.163 -	<td>Available media to install from. Ex: cdrom is not listed on systems
   1.164 +	<td>Available media to install from. Example: cdrom is not listed on systems
   1.165  		with no cdrom drive</td>
   1.166  	</tr>
   1.167  	<tr>
   1.168 @@ -285,13 +285,13 @@
   1.169  	</tr>
   1.170  	<tr>
   1.171  	<td>iso</td>
   1.172 -	<td>Iso images located on local drives, in /root, all user's home and
   1.173 -		first subdir of all user's home</td>
   1.174 +	<td>Iso images located on local drives, in /root, and in all user's home and
   1.175 +		first subdirectory</td>
   1.176  	</tr>
   1.177  	<tr>
   1.178  	<td>web</td>
   1.179  	<td>Predefined names of iso images to download automatically from the
   1.180 -		Internet.</td>
   1.181 +		Internet</td>
   1.182  	</tr>
   1.183  	<tr>
   1.184  	<td>format</td>
   1.185 @@ -303,7 +303,7 @@
   1.186  	</tr>
   1.187  	<tr>
   1.188  	<td>partition_table</td>
   1.189 -	<td>Partition tables scheme of local disks</td>
   1.190 +	<td>Partition table schemes of local disks</td>
   1.191  	</tr>
   1.192  	<tr>
   1.193  	<td>winboot</td>
   1.194 @@ -323,7 +323,7 @@
   1.195  	Performs a SliTaz install on a HDD based on data in the install file.
   1.196  	If you selected to format your HDD, all data will be lost. If you do not,
   1.197  	all data except for any existing /home directory will be removed,
   1.198 -	the home directory will be kept as is.
   1.199 +	(the home directory will be kept as is).
   1.200  </p>
   1.201  <h5>Examples:</h5>
   1.202  <pre>
   1.203 @@ -334,7 +334,7 @@
   1.204  <a id="clean"></a>
   1.205  <h3>clean</h3>
   1.206  <p>
   1.207 -	Remove install and log files.
   1.208 +	Remove installation and log files.
   1.209  </p>
   1.210  <h5>Examples:</h5>
   1.211  <pre>
   1.212 @@ -365,7 +365,7 @@
   1.213  <a id="usage"></a>
   1.214  <h3>usage</h3>
   1.215  <p>
   1.216 -	Print a short help and exit
   1.217 +	Print a short help and exit.
   1.218  </p>
   1.219  <h5>Example:</h5>
   1.220  <pre>
   1.221 @@ -389,33 +389,33 @@
   1.222  <h3>Install</h3>
   1.223  
   1.224  <p>
   1.225 -	How to Install SliTaz on one partition of your hard disk drive. The root
   1.226 +	How to Install SliTaz on a partition of your hard disk drive. The root
   1.227  	partition is not formatted, all data except for any existing <code>/home
   1.228 -	</code> directory will be removed, the <code>home</code> directory will be
   1.229 -	kept as is.
   1.230 +	</code> directory will be removed, (the <code>home</code> directory will be
   1.231 +	kept as is).
   1.232  </p>
   1.233  
   1.234  <ol>
   1.235  <li>Create an install file:<pre># tazinst new</pre></li>
   1.236 -<li>Set mode as install:<pre># tazinst set mode install</pre></li>
   1.237 +<li>Set the mode as install:<pre># tazinst set mode install</pre></li>
   1.238  <li>Use a cdrom as source:<pre># tazinst set media cdrom</pre></li>
   1.239  <li>Select the partition to install SliTaz on:
   1.240  	<pre># tazinst set root_uuid /dev/hda1</pre></li>
   1.241  <li>Install a bootloader:<pre># tazinst set bootloader auto</pre>
   1.242 -<li>Execute installation:<pre># tazinst execute</pre>
   1.243 +<li>Execute an installation:<pre># tazinst execute</pre>
   1.244  </ol>
   1.245  
   1.246  <h3>Complex Install</h3>
   1.247  
   1.248  <p>
   1.249 -	How to Install SliTaz on your hard disk drive, with a separate home
   1.250 -	partition, and a Windows<sup>&trade;</sup> dual-boot. /home and root partitions
   1.251 -	are both formatted, all existing data will be lost.
   1.252 +	How to Install SliTaz on your hard disk drive with a separate home
   1.253 +	partition and a Windows<sup>&trade;</sup> dual-boot. The /home and root partitions
   1.254 +	are both formatted, (all existing data will be lost).
   1.255  </p>
   1.256  
   1.257  <ol>
   1.258  <li>Create an install file:<pre># tazinst new</pre></li>
   1.259 -<li>Set mode as install:<pre># tazinst set mode install</pre></li>
   1.260 +<li>Set the mode as install:<pre># tazinst set mode install</pre></li>
   1.261  <li>Use a Live USB as source:<pre># tazinst set media usb</pre></li>
   1.262  <li>Select a partition on the Live USB:
   1.263  	<pre># tazinst set source /dev/sda1</pre></li>
   1.264 @@ -430,8 +430,8 @@
   1.265  <li>Install a bootloader:<pre># tazinst set bootloader auto</pre>
   1.266  <li>Set up a Windows<sup>&trade;</sup> dual-boot:
   1.267  	<pre># tazinst set winboot auto</pre></li>
   1.268 -<li>Execute installation:<pre># tazinst execute</pre>
   1.269 -<li>Don't let traces behind:<pre># tazinst clean</pre>
   1.270 +<li>Execute an installation:<pre># tazinst execute</pre>
   1.271 +<li>Remove any traces behind:<pre># tazinst clean</pre>
   1.272  </ol>
   1.273  
   1.274  <h3>Upgrade</h3>
   1.275 @@ -446,14 +446,14 @@
   1.276  
   1.277  <ol>
   1.278  <li>Create an install file:<pre># tazinst new</pre></li>
   1.279 -<li>Set mode as upgrade:<pre># tazinst set mode upgrade</pre></li>
   1.280 +<li>Set the mode as upgrade:<pre># tazinst set mode upgrade</pre></li>
   1.281  <li>Use web as source:<pre># tazinst set media web</pre></li>
   1.282  <li>Select the stable image:
   1.283  	<pre># tazinst set source stable</pre></li>
   1.284  <li>Select the partition containing Slitaz to upgrade:
   1.285  	<pre># tazinst set root_uuid /dev/hda1</pre></li>
   1.286  <li>Install a bootloader:<pre># tazinst set bootloader auto</pre>
   1.287 -<li>Execute installation:<pre># tazinst execute</pre>
   1.288 +<li>Execute an installation:<pre># tazinst execute</pre>
   1.289  </ol>
   1.290  
   1.291  <h3>Tips</h3>
   1.292 @@ -473,26 +473,26 @@
   1.293  <p>
   1.294  	Settings are saved in the install file, then used by tazinst to execute
   1.295  	an unattended installation. The default file is <code>./tazint.rc</code>,
   1.296 -	but	an optional file name may be given as a parameter. The install file is
   1.297 +	but an optional file name may be given as a parameter. The install file is
   1.298  	self-documented. The clean command erases this file.
   1.299  </p>
   1.300  
   1.301  <h3>SYSTEM FILE</h3>
   1.302  <p>
   1.303  	The <code>/etc/slitaz/tazinst.conf</code> configuration file allows you to
   1.304 -	change the default settings of <code>tazinst</code>, in the case you want
   1.305 +	change the default settings of <code>tazinst</code> in case you want
   1.306  	to use default custom values.
   1.307  </p>
   1.308  
   1.309  <p>
   1.310  	All settings are customisable, if a particular setting is missing, just add
   1.311 -	the name of the setting in caps	and	enter the new value.
   1.312 +	the name of the setting in caps	and enter the new value.
   1.313  </p>
   1.314  
   1.315  <h4>Example:</h4>
   1.316  
   1.317  <p>
   1.318 -	If you intend to allways install SliTaz from the same iso on the web, you
   1.319 +	If you intend to always install SliTaz from the same iso on the web, you
   1.320  	just have to modify or add the following values:
   1.321  <pre>MEDIA="web"
   1.322  SOURCE="stable"</pre>
   1.323 @@ -501,7 +501,7 @@
   1.324  <h3>LOG FILE</h3>
   1.325  
   1.326  <p>
   1.327 -	The file <code>/var/log/tazinst.log</log> contains a log of the install
   1.328 +	The file <code>/var/log/tazinst.log</code> contains a log of the install
   1.329  	process. The clean command erases this file.
   1.330  </p>
   1.331