website diff en/doc/cookbook/build-host.html @ rev 345

en: Edit Cookbook (quick)
author Paul Issott <paul@slitaz.org>
date Sat Mar 28 11:13:56 2009 +0000 (2009-03-28)
parents ad6c381b294a
children c927e3ab1dd9
line diff
     1.1 --- a/en/doc/cookbook/build-host.html	Sat Mar 28 01:15:01 2009 +0100
     1.2 +++ b/en/doc/cookbook/build-host.html	Sat Mar 28 11:13:56 2009 +0000
     1.3 @@ -49,7 +49,7 @@
     1.4  <ul>
     1.5  	<li>cooking/ - Cooking chroot and flavors.</li>
     1.6  	<li>stable/ - Stable tree.</li>
     1.7 -	<li>scripts/ - Small scripts to help maintaining host, project.</li>
     1.8 +	<li>scripts/ - Small scripts to help maintain the host, project.</li>
     1.9  	<li>repos/ - All the project repos (where the commits are pushed).</li>
    1.10  	<li>www/ - Virtual hosts (website, hg, boot, people, etc).</li>
    1.11  </ul>
    1.12 @@ -57,44 +57,39 @@
    1.13  <a name="scripts"></a>
    1.14  <h3>Using scripts: /home/slitaz/scripts</h3>
    1.15  <p>
    1.16 -To help maintaining the mirror, flavors and other services some scripts
    1.17 -are used, there are mostly all configured for the cooking version. To 
    1.18 +To help maintain the mirror, flavors and other services, some scripts
    1.19 +are used. They are mostly all configured for the cooking version. To 
    1.20  add them to your default path:
    1.21  </p>
    1.22 -<pre>
    1.23 - $ echo 'export PATH=/home/slitaz/scripts:$PATH' >> ~/.profile
    1.24 +<pre> $ echo 'export PATH=/home/slitaz/scripts:$PATH' &gt;&gt; ~/.profile
    1.25  </pre>
    1.26  <p>
    1.27 -Each script should have a small help and description, if none, just open
    1.28 -it:
    1.29 +Each script should have a tiny help file and description, if not, just open:
    1.30  </p>
    1.31 -<pre>
    1.32 - $ cd /home/slitaz/script &amp;&amp; ls
    1.33 +<pre> $ cd /home/slitaz/script &amp;&amp; ls
    1.34   $ ./script.sh help
    1.35  </pre>
    1.36  
    1.37  <a name="undigest-pkgs"></a>
    1.38  <h3>Cooking undigest packages</h3>
    1.39  <p>
    1.40 -You can use the undigest wok in the chroot environement to cook some
    1.41 +You can use the undigest wok in the chroot environment to cook some
    1.42  non supported packages. If you maintain official packages and they cook
    1.43 -succefully on tank you can test it on your local machine and then commit
    1.44 +successfully on tank, then you can test on your local machine and commit
    1.45  in the official wok. Mirror maintainers will then rebuild and upload the
    1.46  packages on mirror.slitaz.org.
    1.47  </p>
    1.48  <p>
    1.49 -To build packages in the undigest wok and in the chroot environement, 
    1.50 -some commands are better than a long text:
    1.51 +To build packages in the undigest wok and in the chroot environment:
    1.52 +commands are sometimes better than a long text:
    1.53  </p>
    1.54 -<pre>
    1.55 - $ ln -s /home/slitaz/cooking/chroot/home/undigest .
    1.56 +<pre> $ ln -s /home/slitaz/cooking/chroot/home/undigest .
    1.57  </pre>
    1.58  <p>
    1.59 -You can copy file with gFTP-sftp-scp directly in the wok or from the 
    1.60 +You can copy files with gFTP-sftp-scp directly into the wok or from the 
    1.61  current directory:
    1.62  </p>
    1.63 -<pre>
    1.64 - $ cp -a package undigest/wok
    1.65 +<pre> $ cp -a package undigest/wok
    1.66   $ su -c chroot.sh
    1.67   /# cd home/undigest
    1.68   /# tazwok cook package
    1.69 @@ -105,49 +100,45 @@
    1.70  <a name="cooking-pkgs"></a>
    1.71  <h3>Cooking official packages</h3>
    1.72  <p>
    1.73 -Mirror maintainers have root access and some have write access to the
    1.74 +Maintainers have root access and some have write access to the
    1.75  main mirror at mirror.slitaz.org, if you want to help in this task please 
    1.76 -contact one of the most active developpers (check hg repos).
    1.77 +contact one of the active developers (check hg repos).
    1.78  </p>
    1.79  <p>
    1.80 -Everything is cook in a chroot environement, default path for the main
    1.81 -wok is /home/slitaz, some changes can be done directly in this wok, the
    1.82 +Everything is cooked in a chroot environment, the default path for the main
    1.83 +wok is /home/slitaz. Some changes can be made directly in this wok: the
    1.84  real Hg is out of the chroot and copied in the chroot with wok.sh:
    1.85  </p>
    1.86 -<pre>
    1.87 - # wok.sh hgup
    1.88 +<pre> # wok.sh hgup
    1.89   # chroot.sh
    1.90  </pre>
    1.91  <p>
    1.92  Cook all missing packages, one by one or with 'tazwok cmp --cook', note
    1.93 -that comparaison it not requiert, if you know witch packages you must
    1.94 +that comparison (cmp) it not required, if you know which packages to
    1.95  cook:
    1.96  </p>
    1.97 -<pre>
    1.98 - /# tazwok cmp
    1.99 +<pre> /# tazwok cmp
   1.100   /# tazwok cook package-name
   1.101  </pre>
   1.102  <p>
   1.103 -Remove all old packages and then rebuild the lists:
   1.104 +Remove all the old packages and then rebuild the lists:
   1.105  </p>
   1.106 -<pre>
   1.107 - /# tazwok cmp --remove
   1.108 +<pre> /# tazwok cmp --remove
   1.109   /# tazwok gen-list --text
   1.110   /# exit
   1.111  </pre>
   1.112  <p>
   1.113  If you have write access to the mirror you can make a dry-push to check
   1.114 -and then upload, push will also remove old packages on the mirror.
   1.115 +and then upload; push will also remove any old packages on the mirror.
   1.116  </p>
   1.117  
   1.118  <a name="stable-pkgs"></a>
   1.119  <h3>Stable packages</h3>
   1.120  <p>
   1.121 -Packages for the stable release are build in a chroot environement like
   1.122 -the Cooking packages.
   1.123 +Packages for the stable release are also built in a chroot environment like
   1.124 +the Cooking packages:
   1.125  </p>
   1.126 -<pre>
   1.127 - # chroot.sh stable
   1.128 +<pre> # chroot.sh stable
   1.129  </pre>
   1.130  
   1.131  <a name="mirror-up"></a>
   1.132 @@ -155,18 +146,16 @@
   1.133  <p>
   1.134  Mirror maintainers can upload by hand with the script mirror.sh:
   1.135  </p>
   1.136 -<pre>
   1.137 - # mirror.sh help
   1.138 +<pre> # mirror.sh help
   1.139  </pre>
   1.140  
   1.141  <a name="website-up"></a>
   1.142  <h3>Update website by hand</h3>
   1.143  <p>
   1.144 -Wesite and packages web interface are updated nightly by cron and can
   1.145 -also be update by hand (used the day of release for example):
   1.146 +The Website and packages web interface are updated nightly by cron and can
   1.147 +also be updated by hand (used on the day of release for example):
   1.148  </p>
   1.149 -<pre>
   1.150 - # website.sh up
   1.151 +<pre> # website.sh up
   1.152   # website.sh help
   1.153  </pre>
   1.154