# HG changeset patch # User Paul Issott # Date 1208903319 0 # Node ID edd4e577664da29e2cd3bac9c94e132d80c437ab # Parent fce25eab68bfbb0ec77434776775ceb2481bbc86 Tidy up Cookbook diff -r fce25eab68bf -r edd4e577664d en/doc/cookbook/index.html --- a/en/doc/cookbook/index.html Tue Apr 22 20:46:47 2008 +0000 +++ b/en/doc/cookbook/index.html Tue Apr 22 22:28:39 2008 +0000 @@ -29,11 +29,19 @@

Developers documentation

+

Table of contents

+ +

About this Cookbook

+ +

+This is the SliTaz GNU/Linux Cookbook, a collection of instructions and manuals about the distribution. +

+ diff -r fce25eab68bf -r edd4e577664d en/doc/cookbook/wok-tools.html --- a/en/doc/cookbook/wok-tools.html Tue Apr 22 20:46:47 2008 +0000 +++ b/en/doc/cookbook/wok-tools.html Tue Apr 22 22:28:39 2008 +0000 @@ -31,7 +31,7 @@

Wok & Tools

-

Tazwok and the wok

+

Overview - Tazwok and the wok

The idea is to use a directory (wok) containing all the available packages, each package contains at least one receipt to download, unpack, compile and generate the binary package. To operate, @@ -57,7 +57,7 @@

To begin, tazwok must already be installed on the system and the main development tools (binutils, compiler, libraries-dev, make) must be downloaded. -On Slitaz you have to install the meta-package slitaz-toolchain: +On Slitaz you need to install the meta-package slitaz-toolchain:

 # tazpkg recharge
  # tazpkg get-install slitaz-toolchain
@@ -92,7 +92,7 @@
 

Once the work is finished, the package is located in the directory specified by the configuration file (default /home/slitaz/packages). If all went well, you can install the package on the host system -or use it to generate a LiveCD distribution via tazlito. To create a new package you can use new-tree +or use it to generate a LiveCD distribution via tazlito. To create a new package you can use new-tree with the option --interactive and read the documentation on the options provided by the receipt.

@@ -108,7 +108,7 @@

Options during compilation of package

-You are free to use any options you want, it is necessary to respect the FSH, the docs in /usr/share/doc for example +You are free to use any options you want, it is necessary to respect the FSH, the docs in /usr/share/doc and follow the Freedesktop standards (.desktop). Then it's just a question of choice, for example you can disable support for XML, have smaller binaries for PHP and get rid of libxml2, but in the case of PHP, it's not worth the cost in terms of loss of functionality. If you have any doubts, look at the receipts and compiler options in @@ -127,7 +127,7 @@

Files included or excluded packages

Generally the base packages contain no man, info, doc or static libraries, we have to create them via a package-doc -or a package-dev. Note that SliTaz is not proposing to use the man command or info, so there's no manual or GNU +or a package-dev. Note that SliTaz is not intending to use the man or info command, so there's no manual or GNU info file. The creation of packages containing docs is really optional, especially if the material is in English (I say). By contrast a piece of text on the package in the Handbook is more appreciated.

@@ -142,7 +142,7 @@

Categories of packages

-The categories of packages exist only for informational purposes and are not fixed. the idea is to classify +The categories of packages exist only for informational purposes and are not fixed, the idea is to classify packages so that a web page can be generated each night recovering data in the package receipt. For the short term, place developement packages in 'devel', Xorg in 'x-window' and the variety of new packages in 'extra'

@@ -150,7 +150,7 @@

Structure of a package in the wok

-The structure of the packages in the wok should be respected so that tazwok can find the correct files and directories. +The structure of the packages in the wok should always be respected so that tazwok can find the correct files and directories. Possible contents of a package (note the directory taz/ is created at time of cooking):