================================================================================ pwbuilder 0.5.15 - TGZ packages building system Copyright (c) 2002 Jaroslaw Swierczynski ================================================================================ This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA You should find the copy of GNU General Public License in file /usr/doc/pwbuilder-0.5.15/COPYING. ================================================================================ 1. Since version 0.4.0, pwbuilder is fully functional and stable Slackware packages building system. It is very strongly (as strongly as I can) recommended not to use packware-devel, but the latest pwbuilder instead. 2. What all the files in the pwbuilder package do? The most important files are in /usr/src/tgz/lib. builder.defs defines all functions and variables you can use in building scripts. builder.mkpkg makes .tgz when everything is ready. The reason for putting this code in a separate file is fakeroot that allows to make .tgz archive with needed ownings. Remember that you can build a package as a non-root user. Every directory in /usr/src/tgz/sources contains .builder and source files for one package (and its subpackages). .builder is a script that does everything to build a package, from unpacking sources to make .tgz. Built packages go to /usr/src/tgz/packages. 3. To build a package you can simply execute .builder script corresponding desired package. But better way is to use buildpkg command that comes with pwbuilder. It allows to pass extra paremeters to .builder scripts. You can also use it to build a package directly from .src.tgz package. It's something like .src.rpm. It's generally a good idea. Run buildpkg without any parameters to get help. 4. How to write a .builder scripts? It's very simple. Just use a template /usr/src/tgz/sources/template.builder. You will find step-by-step instruction on writing building scripts in file BUILDER. -- Jaroslaw Swierczynski .