website 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 0a45c573b38c
children 8cc07d8687ea
files en/doc/cookbook/build-host.html en/doc/cookbook/index.html en/doc/cookbook/reltasks.html
line diff
     1.1 --- a/en/doc/cookbook/build-host.html	Sat Mar 28 01:45:51 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  
     2.1 --- a/en/doc/cookbook/index.html	Sat Mar 28 01:45:51 2009 +0100
     2.2 +++ b/en/doc/cookbook/index.html	Sat Mar 28 11:13:56 2009 +0000
     2.3 @@ -34,7 +34,7 @@
     2.4  <ul>
     2.5  	<li><a href="wok-tools.html">Wok &amp; Tools</a> - SliTaz Package Tools.</li>
     2.6  	<li><a href="receipts.html">Receipts</a> - Receipts for creating SliTaz packages.</li>
     2.7 -	<li><a href="build-host.html">Build Host</a> - SliTaz Buils host (tank).</li>
     2.8 +	<li><a href="build-host.html">Build Host</a> - SliTaz Build host (tank).</li>
     2.9  	<li><a href="boot-scripts.html">Boot Scripts</a> - The startup and shutdown scripts.</li>
    2.10  	<li><a href="slitaz-tools.html">SliTaz Tools</a> - The Toolbox.</li>
    2.11  	<li><a href="reltasks.html">Release Tasks</a> - List of things to do before publishing a new version (Cooking or stable).</li>
     3.1 --- a/en/doc/cookbook/reltasks.html	Sat Mar 28 01:45:51 2009 +0100
     3.2 +++ b/en/doc/cookbook/reltasks.html	Sat Mar 28 11:13:56 2009 +0000
     3.3 @@ -37,29 +37,29 @@
     3.4  <h3>Check list</h3>
     3.5  <ul>
     3.6  	<li>Release version is specified by /etc/slitaz-release, this file
     3.7 -	is contrĂ´led by slitaz-base-files. Base files are tageg just before
     3.8 -	a stable reale to chage the version string and let Tazpkg use the new
     3.9 -	pacpages.</li>
    3.10 +	is controlled by slitaz-base-files. Base files are tagged just before
    3.11 +	a stable release to change the version string and let Tazpkg use the new
    3.12 +	packages.</li>
    3.13  	<li>Check that the SliTaz version specified in /etc/issue message is 
    3.14 -	the same as displayed in the isolinux.msg.</li>
    3.15 +	the same as displayed in isolinux.msg.</li>
    3.16  	<li>Add and check that documents and images are in the root of the CD - ie.
    3.17  	README, index.html, style.css and the directory of images. All files are
    3.18  	in the slitaz-tools archive; just copy the addfiles/ and        
    3.19  	regenerate the ISO.</li>
    3.20  	<li>Test, test, and test ...</li>
    3.21 -	<li>Prepare the website announcement and RSS feeds. Mailing list is used
    3.22 -	for translation and texte should be send 1 or 2 days before release.</li>
    3.23 +	<li>Prepare the website announcement and RSS feeds. The Mailing list is used
    3.24 +	for translation and any text should be submitted 1 or 2 days before release.</li>
    3.25  </ul>
    3.26  
    3.27  <h3>Stable documentation</h3>
    3.28  <p>
    3.29 -SliTaz stable release provide the release notes on the LiveCD trought
    3.30 -the package <code>slitaz-doc</code>, the repos is tagged just before release
    3.31 -and archived on the mirror. After the wok have been copied to wok-stable
    3.32 -the doc are back to a cooking cycle and just provide and index with basic
    3.33 -information. On the system doc are located in: /usr/share/doc/slitaz, a 
    3.34 -desktop file and icon are provide in the sources package and can be used
    3.35 -to have a qick access to documentation.
    3.36 +SliTaz stable release provides the release notes on the LiveCD through
    3.37 +the package <code>slitaz-doc</code>, the repos are tagged just before release
    3.38 +and are archived on the mirror. After the wok have been copied to wok-stable,
    3.39 +the docs are back to a cooking cycle and just provide an index with basic
    3.40 +information. On the system, docs are located in: /usr/share/doc/slitaz, a 
    3.41 +desktop file and icon are provided in the sources package and can be used
    3.42 +to have quick access to the documentation.
    3.43  </p>
    3.44  <ul>
    3.45  	<li><a href="http://hg.slitaz.org/slitaz-doc/">SliTaz Doc repo</a></li>