.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.29.
.TH "SRC2PKG" "1" "December 2008" "src2pkg version-1.9.7" "User Commands"
.SH "NAME"
src2pkg \- manual page for src2pkg version\-1.9.7
.SH "DESCRIPTION"
src2pkg \- Builds an installable package from a source archive
or from other installable content.
.TP
src2pkg [-h(--help), -hh(--more-help), --version]
.TP 
src2pkg [User Options] [Build Options]  file\-name
.TP 
src2pkg \-[ABCDHINOPRSTUV(VV)WX] \-[abcdefimnpsuv] file\-name
.SH "EXTENDED OPTIONS"
\-[EL] \-[DEST,JAIL,REAL,SAFE] \-[TBZ,TGZ,TLZ,Z1,Z2,Z3,Z4] \-[ACF,ACN] [\-LOG]
.IP 
Capitalized 
.B User Options 
take no argument:
.TP 
\fB\-A\fR
Autogenerate a src2pkg script when and if the build succeeds.
.TP 
\fB\-B\fR
Keep backup of any files overwritten by this installation.
.TP
\fB\-C\fR
Place finished package in Current directory.
.TP
\fB\-D\fR
Don't apply diff or patch files automatically.
.TP
\fB\-H\fR
Place finished package in your HOME directory.
.TP
\fB\-I\fR
Install the created package when finished.
.TP 
\fB\-N\fR
Generate a starting src2pkg script and description file only.
.TP 
\fB\-O\fR
Use an OBJECT directory for building (USE_OBJ_DIR='YES').
.TP 
\fB\-P\fR
Preserve permissions in the source directory. (CORRECT_PERMS='NO')
.TP
\fb\-Q\fR
Query the user for interactive options during configuration and package creation.
.TP 
\fB\-R\fR
Replay errors in configuration or compilation(useful in QUIET mode).
.TP
\fB\-S\fR
Use a Shell script for installation(install.sh by default)
.TP 
\fB\-T\fR
Test\-build the source code without attempting to make a package.
.TP
\fB\-U\fR
Update the build script for compatibility if needed.
.TP
\fB\-V\fR
DEBUG -show detailed prompts for debugging.
.TP 
\fB\-VV\fR
Be verbose. Show all output from the steps (QUIET='NO').
.TP 
\fB\-W\fR
Remove (wipe out) temporary build files (CLEANUP=ALL).
.TP
\fB\-X\fR
Execute a build script in the current working directory.
.IP 
The following 
.B Build Options 
require an argument separated by the '=' sign. Use single '' or double "" quotes around the 
arguments if they contain spaces.
.TP 
\fB\-a\fR
Set the architecture of the package [\-a=noarch] (ARCH='').
.TP 
\fB\-b\fR
Set the build or release number [\-b=2] (BUILD='').
.TP 
\fB\-c\fR
Set the CONFIG_COMMAND option \-usually 'configure'.
.TP 
\fB\-d\fR
Set the list of douments to include [\-d='README AUTHORS'] (DOCLIST='').
.TP 
\fB\-e\fR
Pass extra arguments to configure [\-e='\-\-disable\-gnome'] (EXTRA_CONFIGS='').
.TP 
\fB\-f\fR
Set the CFLAGS variable [\-f='\-Wall \fB\-O3\fR'] (STD_FLAGS='').
.TP 
\fB\-i\fR
Set the install command line [\-i='make install'] (INSTALL_LINE).
.TP 
\fB\-m\fR
Set the 'make' command [\-m='make dep all'] (MAKE_COMMAND).
.TP 
\fB\-n\fR
Set the package name [\-n='newname'] (ALT_NAME='').
.TP 
\fB\-p\fR
Set the installation prefix [\-p=/usr] (PRE_FIX='').
.TP 
\fB\-s\fR
Set the configuration subdir [\-s=src] (CONFIG_SUBDIR='').
.TP 
\fB\-u\fR
Set the URL location of the source tarball.
.TP 
\fB\-v\fR
Set the version of the package [\-v=0.0.0a] (ALT_VERSION='').
.TP
.B Note: 
Variables shown above in parenthesis are the src2pkg script equivalents.
.IP
.B Special Options:
.TP
\fB\-h\fR
(\-\-help) Show the help message and then exit.
.TP
\fB\-hh\fR
(\-\-more\-help) Show the Advanced Options and then exit.
.TP
\fB\-v\fR
(--version) Show the src2pkg version and then exit.
.TP
\fB\-\-setup\fR
This special option compiles the binaries and libraries needed by src2pkg.
Usually you only need to do this when you first install src2pkg.
.IP
.B Extended Options:
.TP
\fB\-LOG\fR
Log the output from 'configure', 'make' and 'make install' to a file.
.TP
\fB\-ACF\fR
Use configuration options from *.spec or rules files, if found.
.TP
\fB\-ACN\fR
Use standard configuration options found in configure script.
.TP
\fB\-SAFE\fR
Run installation commands in a SAFE mode. (Implies the \-REAL option)
.TP
\fB\-JAIL\fR
Run installation commands in a 'jailed' root directory.
.TP
\fB\-REAL\fR
Run installation commands in the real root filesystem using backup.
.TP
\fB\-DEST\fR
Run installation commands using the DESTDIR variable if possible.
.TP
\fB\-E\fR
Create and use extended database files (slack-required and slack-supplies).
.TP
\fB\-L\fR
Delete extra language files (man-pages, locale and i18n) files.
.br
Be sure to configure /etc/src2pkg/DONT_PURGE.locales file first.
.TP
\fB\-TBZ\fR
Use bzip2 to compress the final package (this is the default).
.TP
\fB\-TGZ\fR
Use gzip to compress the final package (Not compatible with Slackware installpkg).
.TP
\fB\-TLZ\fR
Use lzma to compress the final package (Not compatible with Slackware installpkg).
.TP
\fB\-UPX\fR
Use upx-ucl or upx to compress binaries inside the package.
.TP
\fB\-EPX\fR
Use exepak to compress binaries inside the package.
.TP
\fB\-Z?\fR
SAVE_SPACE=? Squeeze packages by using more compression:
.br
The 'Z' options are cumulative - Z4 does all of Z1, Z2 and Z3.
.TP
\fB\-Z1\fR
Z1 uses bzip2 instead of gzip for man-pages.
.TP
\fB\-Z2\fR
Z2 creates a bzipped tar archive of the package doc directory.
.TP
\fB\-Z3\fR
Z3 compresses ELF binaries using upx or upx-ucl if present.
.TP
\fB\-Z4\fR
Z4 Link to a common copy of the GPL in /usr/share/licences.
.SH "EXAMPLES"
.IP
src2pkg myprogram\-0.1.tar.bz2
.IP 
src2pkg \-N myprogram\-0.1.tar.bz2
.IP 
src2pkg \-i='make install install\-data'\fB\-A\fR myprogram\-0.1.tar.bz2
.IP 
src2pkg \-e='\-\-disable\-nls' \fB\-A\fR myprogram\-0.1.tar.bz2
.SH "USAGE"
.IP
When given the name of a compressed source tarball
.B  src2pkg
performs all the commands necessary to unpack and compile 
the sources and then install them using the command 
\'make install\', tracking whatever directories, files or 
links are created and then making a Slackware\-type
tgz package from those files, etc.
.IP
.B src2pkg
will execute its' own scripts if one is named instead of a tarball,
or the command 'src2pkg \-X' will search the current directory and run
the first *.scrpkg.auto or *.src2pkg script it finds.
.IP
Giving a valid URL to a source tarball or *.src2pkg script online will
automatically download the archive or script for you if you are connected
to the internet and then build the package.
.IP
The options 
.B \-ACF
and
.B \-ACN
are used to allow src2pkg to try to find options automatically and pass them 
to the configure script. The 
.B \-ACF
option tells 
.B src2pkg
to look for options in an RPM *.spec file or debian 'rules' file, if either one
is present inside the sources. The
.B \-ACN
option tells 
.B src2pkg
to detect common standard options in the configure script itself. If present, they
will assigned default values and used to configure the sources. The list of possible
options which will be searched for can be configured in the 
.B /etc/src2pkg/src2pkg.conf
file by setting the 
.B AUTO_CONFIG_OPTIONS
variable.
.SH "SEE ALSO"
The full documentation for
.B  src2pkg
is maintained as part of the
.B  src2pkg
package.
.LP  
.B  See /usr/doc/src2pkg\\-x.x for further usage.
.PP