head 1.2; access; symbols; locks; strict; comment @.\" @; 1.2 date 2003.02.03.14.37.52; author swiergot; state Exp; branches; next 1.1; 1.1 date 2002.12.25.23.22.00; author swiergot; state Exp; branches; next ; desc @@ 1.2 log @- Updated versions and dates in manual pages. - Write current version to VERSION file. @ text @.TH "buildpkg" "8" "February 3rd, 2003" "buildpkg 0.2.4" "pwbuilder" .SH "NAME" .LP buildpkg \- a native interface to pwbuilder .SH "SYNTAX" .LP \fBbuildpkg\fR [\fIbuild\-options\fP] <\fIpackagename\fP> .br \fBbuildpkg\fR \fI\-\-build\fP [\fIbuild\-options\fP] <\fIfilename\fP> .br \fBbuildpkg\fR [\fIbuild\-options\fP] <\fIfilename\fP> .br \fBbuildpkg\fR \fI\-\-install\fP <\fIfilename\fP> .br \fBbuildpkg\fR \fI\-\-remove\fP <\fIpackagename\fP> .br \fBbuildpkg\fR \fI\-\-pack\fP <\fIpackagename\fP> .SH "DESCRIPTION" .LP \fBbuildpkg\fR is a shell script that allows to easily build \fBSlackware\fR packages. It can also manage sources \- install them, remove and pack. \fBbuildpkg\fR invokes \fBpwbuilder\fR to build a package. It it possible to pass extra options to \fBpwbuilder\fR, such as verbose output or target architecture. \fBbuildpkg\fR allows to build packages directly from packed sources \- \fIsrc.tgz\fR archives. With one command you can build a package according to your needs. .SH "BUILDING PACKAGES" .LP The simplest way to build a package is: \fBbuildpkg\fR \fIname\fR where \fIname\fR is directory \fB/usr/src/tgz/sources/\fR\fIname\fR with file \fIname\fR\fB.builder\fR which is a script that is to be executed to build the package. All other files needed to do that (sources, patches) should be in the directory. There is another method \- sources may be packed into \fIsrc.tgz\fR archive and you don't have to unpack them for building. All you need to build a package from \fIsrc.tgz\fR file is to execute the following command: \fBbuildpkg\fR \fI\-\-build\fR \fIfile.src.tgz\fR File \fIfile.src.tgz\fR must exist and contain directory \fBusr/src/tgz/sources/name\fR with file \fBname.builder\fR and other needed files. See \fBMANAGING SOURCES\fR section to find out the best way of creating \fIsrc.tgz\fR archives. You can also omit \fI\-\-build\fR option. \fBbuildpkg\fR will check if \fIname\fR argument is a readable file and ends with \fB.src.tgz\fR. If so, \fBbuildpkg\fR will assume that you want to build a package from \fIsrc.tgz\fR archive. To customize building process several options has been provided: .TP \fI\-\-output\fR Tells \fBpwbuilder\fR to show full output of \fI./configure\fR, \fImake\fR and \fImake install\fR. .TP \fI\-\-target\fR \fIarch\fR Sets \fIarch\fR as an architecture a package will be build for. If this option misses the default is i386. .TP \fI\-\-debug\fR Causes \fBpwbuilder\fR not to remove sources after building, no matter if building process went good or not. .TP \fI\-\-auto\fR Causes building to be automatic. If this option is not specified, you may be asked for some compile\-time options. Otherwise default values will be used. .TP \fI\-\-no\-pw\fR Forces \fBpwbuilder\fR not to make a package with \fBPackware\fR extensions. This turns off all \fIinstall/slack\-pw\-*\fR files, removes a vendor tag and all build variant tags from the package file name, and creates a \fI.txt\fR file with the package description instead of a \fI.ppi\fR file. .TP \fI\-\-scheme\fR \fIname\fR If \fI\-\-auto\fR option is used, this will let you change default values. If you specify \fIname\fR, \fBbuildpkg\fR looks for file \fB/usr/src/tgz/sources/package/scheme.\fR\fIname\fR and uses it. You can pass any number of \fI\-\-scheme\fR options. If don't know what scheme you can use, type: \fIbuildpkg \-\-help package\fR and \fBbuildpkg\fR will display available schemes for the package. .SH "MANAGING SOURCES" .LP You can manage your sources by using one of this options: .TP \fI\-\-install\fR \fIfile.src.tgz\fR Unpacks \fIsrc.tgz\fR archive and puts sources in \fB/usr/src/tgz/sources\fR. .TP \fI\-\-remove\fR \fIpackage\fR Removes directory \fB/usr/src/tgz/sources/\fR\fIpackage\fR. .TP \fI\-\-pack\fR \fIpackage\fR Makes \fIsrc.tgz\fR archive with sources from \fB/usr/src/tgz/sources/\fR\fIpackage\fR. .SH "MORE ON OPTIONS" .LP Instead of typing this long options you can use their short versions, for example: \fI\-i\fR for \fI\-\-install\fR, \fI\-b\fR for \fI\-\-build\fR, \fI\-n\fR for \fI\-\-no\-pw\fR and so on. .SH "FILES" .LP .TP \fI/usr/src/tgz/lib/builder.defs\fP The core script of \fBpwbuilder\fR. .TP \fI/usr/src/tgz/lib/builder.mkpkg\fP A part of script \fBbuilder.defs\fR that is responsible for creating package file. .SH "DIRECTORIES" .LP .TP \fI/usr/src/tgz/sources\fP All sources are keeped here. .TP \fI/usr/src/tgz/packages\fP Here goes packages after being built. .SH "EXAMPLES" .LP \fBbuildpkg\fR \fI\-\-auto\fR \fI\-\-scheme\fR \fInoimap\fR \fImutt\fR \fBbuildpkg\fR \fI\-\-build\fR \fIirssi\-0.8.5\-1pw.src.tgz\fR \fBbuildpkg\fR \fI\-\-install\fR \fIpinfo\-0.6.5\-1pw.src.tgz\fR \fBbuildpkg\fR \fI\-\-remove\fR \fIvlock\fR \fBbuildpkg\fR \fI\-\-pack\fR \fIjoe\fR .SH "AUTHORS" .LP Jaroslaw Swierczynski .SH "COPYRIGHT" Copyright (c) 2002-2003 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 find a copy of the GNU General Public License in file /usr/doc/pwbuilder\-*/COPYING. .SH "SEE ALSO" .LP packware(8) @ 1.1 log @- Initial release. - Version 0.5.9. @ text @d1 1 a1 1 .TH "buildpkg" "8" "August 24th, 2002" "buildpkg 0.2.2" "pwbuilder" d110 1 a110 1 Copyright (c) 2002 Jaroslaw Swierczynski @ .