.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.29.
.TH "TRACKINSTALL" "1" "July 2010" "trackinstall\-2.7" "User Commands"
.SH "NAME"
trackinstall \- manual page for trackinstall\-2.7
.SH "DESCRIPTION"
.TP 
trackinstall \- Build an installable package from compiled sources or other content in the current directory.
.TP
trackinstall [\-h(\-\-help), \-hh(\-\-more\-help), \-\-version, \-\-list]
.TP
trackinstall [\-ABCHINPSV(VV)W] [\-abdinv]
.SH "EXTENDED OPTIONS"
\-E \-LANG \-[DEST,JAIL,REAL,SAFE,UNION] \-[DEB,PET,PET2,TAZ,TBZ,TGZ,TLZ,TXZ,Z1,Z2,Z3,Z4] 
\-LOG \-BUMP -\CWD \-\-resume=funcname \-\-pause=[before|after|funcname]
\-[L32,L64] \-\-libdirsuffix
.IP 
Capitalized User Options take no argument:
.TP 
\fB\-A\fR
Auto\-generate a TrackBild script if successful.
.TP 
\fB\-B\fR
Keep backup of any files overwritten by this installation.
.TP 
\fB\-I\fR
Install the created package when finished.
.TP 
\fB\-C\fR
Place final package in the current directory.
.TP
\fB\-CWD\fR
Use the current directory for all build locations.
.TP 
\fB\-H\fR
Place final package in your home directory.
.TP 
\fB\-N\fR
New TrackBuild script and slack\-desc file only.
.TP 
\fB\-P\fR
Preserve permissions in the source directory.
.TP
\fb\-Q\fR
Query the user for interactive options during package creation.
.TP 
\fB\-S\fR
Run special install commands \- 'sh install.sh' by default
.TP 
\fB\-V\fR
DEBUG -show detailed prompts for debugging.
.TP 
\fB\-VV\fR
Be verbose. Show all output from the steps.
.TP 
\fB\-W\fR
Wipe up \fB\-cleanup\fR temporary files when finished.
.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\-SAFE\fR
Run installation commands in a SAFE mode(root only). (Implies the \-REAL option)
.TP
\fB\-DEST\fR
Run installation commands using the DESTDIR variable if possible.
.TP
\fB\-UNION\fR
Run installation commands using a unionfs/chroot, if available.
.IP 
Lowercase Build 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 (ARCH) of the package [\-a=noarch].
.TP 
\fB\-b\fR
Set the package build/release number [\-b=4].
.TP 
\fB\-d\fR
Specify the documents to include [\-d='README foo.HOWTO AUTHORS'].
.TP 
\fB\-i\fR
Set the install command line [\-i='make install'].
.TP 
\fB\-n\fR
Use alternate name for package and desc file [\-n=newname]
.TP 
\fB\-p\fR
Set the installation prefix [\-p=/usr] (PRE_FIX='').
.TP 
\fB\-v\fR
Use alternate version number for the package [\-v=0.0.0a].
.IP
Help 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\-\-list\fR
Show a list of the trackinstall instruction functions (for use with \-\-resume= option)
.IP
Extended Options:
.TP
\fB\-\-pause=??\fR
(before|after) Pause before or after running each function.
.TP
\fB\-\-resume=??\fR
Resume a build starting at the named instruction function. 
Run 'trackinstall --list' to see a list of the named functions.
.TP
\fB\-\-splitpkg\fR Create separate 'devel', 'i18n', 'docs' and/or 'solibs' packages.
.TP
\fB\-E\fR
Use extended database files (slack-required and slack-supplies).
.TP
\fB\-LANG\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\-L(32/64)\fR
Set the LIBDIRSUFFIX variable to adjust installation paths for multilib systems.
.br
Set to -LNULL(or L0 or -Lnull), if needed, to use no suffix in the installation paths.
.TP
\fB\-\-libdirsuffix=??\fR
As above, but use this syntax if setting to anything besides 32, 64 or NULL.
.TP
\fB\-DEB\fR
Create the final package as a debian *.deb archive.
.TP
\fB\-PET\fR
Create the final package as a '.pet' archive.
.TP
\fB\-PET2\fR
Create the final package as a '.pet' archive for 'woof'.
.TP
\fB\-RPM\fR
Create the final package as an '.rpm' archive.
.TP
\fB\-TAZ\fR
Create the final package as a slitaz '.tazpkg' archive.
.TP
\fB\-TBZ\fR
Use bzip2 to compress the final package.
.TP
\fB\-TGZ\fR
Use gzip to compress the final package (this is the default).
.TP
\fB\-TLZ\fR
Use lzma to compress the final package.
.TP
\fB\-TXZ\fR
Use xz (lzma2) to compress the final package.
.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 Use bzip2 instead of gzip for man-pages.
.TP
\fB\-Z2\fR
Z2 Compresses ELF binaries using upx or upx-ucl if present.
.TP
\fB\-Z3\fR
Z3 Link to a common copy of the GPL in /usr/share/licences.
.TP
\fB\-Z4\fR
Z4 Archive the package doc directory and remove 'info' files.
.SH "EXAMPLES"
.IP
trackinstall \fB\-C\fR \fB\-W\fR
.IP
Build the package in the current directory and delete temporary files.
.IP 
trackinstall \fB\-b\fR=\fI2\fR
.IP 
Set the BUILD number to '2'
.IP 
trackinstall \fB\-i=\fR'make install install_data'
.IP 
install with 'make install install_data (same as running 'make install' and 'make install_data')
.IP 
trackinstall \fB\-P\fR \fB\-S\fR \fB\-i=\fR'bash ./install.script'
.IP 
Preserve permissions and use 'bash ./install.script' instead of 'make install'
.SH "USAGE"
Calling
.B  trackinstall
without arguments acts very much like checkinstall, running
the command 'make install', tracking whatever directories,
files & links are created and then making a Slackware\-type
tgz package from those files, etc.
.BR 
Using
.B  trackinstall
with the '\-S' option allows you to track other types of
installation which use no Makefile.
.BR 

.SH "SEE ALSO"
The full documentation for
.B  trackinstall
is maintained as part of the
.B  src2pkg
package.
.LP  
.B  See /usr/doc/src2pkg\\-x.x for further usage.
.PP