wok annotate cookutils/description.txt @ rev 19073

Fix: (Picozu the HTML5 online image editor.)
author Leonardo Laporte <hackdorte@sapo.pt>
date Sat Apr 23 01:13:53 2016 -0300 (2016-04-23)
parents
children
rev   line source
al@18718 1 The SliTaz Cookutils provide tools and utils to build SliTaz packages.
al@18718 2
al@18718 3
al@18718 4 Cook
al@18718 5 ----
al@18718 6
al@18718 7 The cook tool should be used in a chroot environment: simply use the command
al@18718 8 `tazdev gen-chroot` to build one. You can also build packages directly but
al@18718 9 build deps will not be handled correctly since cook will install missing
al@18718 10 packages to perform a build and then remove them only if they were not
al@18718 11 installed before, this way we can keep a clean build environment.
al@18718 12
al@18718 13 We use standard SliTaz paths to work such as /home/slitaz/wok, if you work on
al@18718 14 cooking from stable or want to keep a clean system: create a chroot.
al@18718 15
al@18718 16
al@18718 17 Cooker
al@18718 18 ------
al@18718 19
al@18718 20 The Cooker is a Build Bot which automates the build process but doesn't make
al@18718 21 the dinner for you! We need quality receipts to cook successfully and the goal
al@18718 22 is not to have a bloated script so please Keep It Short and Simple.
al@18718 23
al@18718 24 The web interface consists of one CGI script and one CSS style. Cook logs can
al@18718 25 be produced by cook and the cooker just acts as a fronted to check them in
al@18718 26 a nice way. A web interface also highlights success and error and can show
al@18718 27 receipts and the cooker logs such as the last ordered list or commits check.
al@18718 28
al@18718 29
al@18718 30 Cookiso
al@18718 31 -------
al@18718 32
al@18718 33 Cookiso is the official tool to automate the ISO build. The goal is to provide
al@18718 34 a simple to use, rock solid tool with a web interface à la Cooker. It shares
al@18718 35 configuration and templates with the Cooker but can be run on its own so it
al@18718 36 can be used by contributors or customers to automate custom ISO building.
al@18718 37 Cookiso must be run in a chroot which can be the same chroot as the Cooker.
al@18718 38
al@18718 39
al@18718 40 Cross compiling
al@18718 41 ---------------
al@18718 42
al@18718 43 Cookutils lets you cross compile a package for a specific architecture. Say you
al@18718 44 want to build ARM binaries from a standard i486 machine. Cookutils provides
al@18718 45 helpers for the ARM platform, but the first thing to do is compile a cross
al@18718 46 toolchain and modify the main cook.conf variables to use the correct ARCH,
al@18718 47 CFLAGS and BUILD_SYSTEM