website rev 29

Tidy up Cookbook
author Paul Issott <paul@slitaz.org>
date Tue Apr 22 22:28:39 2008 +0000 (2008-04-22)
parents fce25eab68bf
children 94ad2069b748
files en/doc/cookbook/index.html en/doc/cookbook/wok-tools.html en/sitemap.html
line diff
     1.1 --- a/en/doc/cookbook/index.html	Tue Apr 22 20:46:47 2008 +0000
     1.2 +++ b/en/doc/cookbook/index.html	Tue Apr 22 22:28:39 2008 +0000
     1.3 @@ -29,11 +29,19 @@
     1.4  
     1.5  <h2><font color="#DF8F06">Developers documentation</font></h2>
     1.6  
     1.7 +<h3>Table of contents</h3>
     1.8 +
     1.9  <ul>
    1.10  	<li><a href="wok-tools.html">Wok &amp; Tools.</a></li>
    1.11  	<li><a href="receipts.html">Receipts.</a></li>
    1.12  </ul>
    1.13  
    1.14 +<h3>About this Cookbook</h3>
    1.15 +
    1.16 +<p>
    1.17 +This is the SliTaz GNU/Linux Cookbook, a collection of instructions and manuals about the distribution.
    1.18 +</p>
    1.19 +
    1.20  
    1.21  <!-- End of content -->
    1.22  </div>
     2.1 --- a/en/doc/cookbook/wok-tools.html	Tue Apr 22 20:46:47 2008 +0000
     2.2 +++ b/en/doc/cookbook/wok-tools.html	Tue Apr 22 22:28:39 2008 +0000
     2.3 @@ -31,7 +31,7 @@
     2.4  <h2><font color="#DF8F06">Wok &amp; Tools</font></h2>
     2.5  
     2.6  <ul>
     2.7 -	<li><a href="#tazwok">Tazwok and the wok.</a></li>
     2.8 +	<li><a href="#tazwok">Overview.</a></li>
     2.9  	<li><a href="#wok">Wok tools.</a></li>
    2.10  	<li><a href="#cook">Compile and generate packages.</a></li>
    2.11  	<li><a href="#opts">Options during compilation of package.</a></li>
    2.12 @@ -43,7 +43,7 @@
    2.13  </ul>
    2.14  
    2.15  <a name="tazwok"></a>
    2.16 -<h3>Tazwok and the wok</h3>
    2.17 +<h3>Overview - Tazwok and the wok</h3>
    2.18  <p>
    2.19  The idea is to use a directory (wok) containing all the available packages, each package contains 
    2.20  at least one receipt to download, unpack, compile and generate the binary package. To operate,
    2.21 @@ -57,7 +57,7 @@
    2.22  <p>
    2.23  To begin, tazwok must already be installed
    2.24  on the system and the main development tools (binutils, compiler, libraries-dev, make) must be downloaded.
    2.25 -On Slitaz you have to install the meta-package <code>slitaz-toolchain</code>:
    2.26 +On Slitaz you need to install the meta-package <code>slitaz-toolchain</code>:
    2.27  </p>
    2.28  <pre> # tazpkg recharge
    2.29   # tazpkg get-install slitaz-toolchain
    2.30 @@ -92,7 +92,7 @@
    2.31  <p>
    2.32  Once the work is finished, the package is located in the directory specified by the configuration file
    2.33  (default <code>/home/slitaz/packages</code>). If all went well, you can install the package on the host system
    2.34 -or use it to generate a LiveCD distribution via tazlito. To create a new package you can use  <code>new-tree</code> 
    2.35 +or use it to generate a LiveCD distribution via tazlito. To create a new package you can use <code>new-tree</code> 
    2.36  with the option <code>--interactive</code> and read the documentation on the options provided by the
    2.37  <a href="receipts.html">receipt</a>.
    2.38  </p>
    2.39 @@ -108,7 +108,7 @@
    2.40  <a name="opts"></a>
    2.41  <h3>Options during compilation of package</h3>
    2.42  <p>
    2.43 -You are free to use any options you want, it is necessary to respect the FSH, the docs in /usr/share/doc for example
    2.44 +You are free to use any options you want, it is necessary to respect the FSH, the docs in <code>/usr/share/doc</code>
    2.45  and follow the Freedesktop standards (.desktop). Then it's just a question of choice, for example you can disable 
    2.46  support for XML, have smaller binaries for PHP and get rid of libxml2, but in the case of PHP, it's not worth the
    2.47  cost in terms of loss of functionality. If you have any doubts, look at the receipts and compiler options in
    2.48 @@ -127,7 +127,7 @@
    2.49  <h3>Files included or excluded packages</h3>
    2.50  <p>
    2.51  Generally the base packages contain no man, info, doc or static libraries, we have to create them via a package-doc
    2.52 -or a package-dev. Note that SliTaz is not proposing to use the man command or info, so there's no manual or GNU
    2.53 +or a package-dev. Note that SliTaz is not intending to use the man or info command, so there's no manual or GNU
    2.54  info file. The creation of packages containing docs is really optional, especially if the material is in English
    2.55  (I say). By contrast a piece of text on the package in the Handbook is more appreciated.
    2.56  </p>
    2.57 @@ -142,7 +142,7 @@
    2.58  <a name="categories"></a>
    2.59  <h3>Categories of packages</h3>
    2.60  <p>
    2.61 -The categories of packages exist only for informational purposes and are not fixed. the idea is to classify
    2.62 +The categories of packages exist only for informational purposes and are not fixed, the idea is to classify
    2.63  packages so that a web page can be generated each night recovering data in the package receipt. For the short term, place
    2.64  developement packages in 'devel', Xorg in 'x-window' and the variety of new packages in 'extra'
    2.65  </p>
    2.66 @@ -150,7 +150,7 @@
    2.67  <a name="woktree"></a>
    2.68  <h3>Structure of a package in the wok</h3>
    2.69  <p>
    2.70 -The structure of the packages in the wok should be respected so that tazwok can find the correct files and directories.
    2.71 +The structure of the packages in the wok should always be respected so that tazwok can find the correct files and directories.
    2.72  Possible contents of a package (note the directory taz/ is created at time of cooking):
    2.73  </p>
    2.74  <ul>
     3.1 --- a/en/sitemap.html	Tue Apr 22 20:46:47 2008 +0000
     3.2 +++ b/en/sitemap.html	Tue Apr 22 22:28:39 2008 +0000
     3.3 @@ -85,6 +85,8 @@
     3.4          <li><a href="doc/">Documentation</a> - Web site doc.</li>
     3.5          <li><a href="doc/handbook/">Handbook</a> - LiveCD usage,
     3.6          package management, Tazlito.</li>
     3.7 +        <li><a href="doc/cookbook/">Cookbook</a> - Wok, 
     3.8 +        Tazwok &amp; package receipts.</li>
     3.9      </ul>
    3.10  </fieldset>
    3.11  </div>