.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.29.
.TH "SRC2PKG" "1" "November 2007" "src2pkg version-1.8" "User Commands"
.SH "NAME"
src2pkg \- manual page for src2pkg version\-1.8
.SH "DESCRIPTION"
src2pkg \- Build an installable package from a source tarball.
.TP
src2pkg [-h,--help,--version]
.TP 
src2pkg [User Options] [Build Options]  file\-name
.TP 
src2pkg \fB\-[ABCDHINOPRSTUV(VV)WX\fr] [abcdefimnpsuv] file\-name
.IP 
The following options take no argument:
.TP 
\fB\-A\fR
Autogenerate a src2pkg script 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.
.TP
\fB\-JAIL\fR
Run installation commands in a 'jailed' root directory (default).
.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.
.IP 
The following options require an argument separated by the '=' sign:
Use quotes '' or "" 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/local] (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='').
Note: Variables shown above in parenthesis are the src2pkg script equivalents.
.SH "EXAMPLES"
.IP 
Examples:
.IP
src2pkg myprogram\-0.1.tar.bz2
.IP 
src2pkg \fB\-N\fR myprogram\-0.1.tar.bz2
.IP 
src2pkg \fB\-i=\fR'make install install\-data'\fB\-A\fR myprogram\-0.1.tar.bz2
.IP 
src2pkg \fB\-e=\fR'\-\-disable\-nls' \fB\-A\fR myprogram\-0.1.tar.bz2
.SH "USAGE"
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.
.BR 
.B src2pkg
will execute its' own scripts if one is named instead of a tarball.
The command 'src2pkg \-X' will search the current directory and run
the first *.scrpkg.auto or *.src2pkg script it finds.
.BR
Giving a valid URL to a source tarball or online *.src2pkg script will
automatically download the archive or script for you if you are connected
to the internet.
.BR
.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