dragora/qi/doc/qi.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH QI "1" "July 2022" "qi 2.10-rc1" "User Commands"
.SH NAME
qi \- a simple but well-integrated package manager
.SH SYNOPSIS
.B qi
\fI\,COMMAND \/\fR[\fI\,OPTIONS\/\fR] [\fI\,FILE\/\fR]...
.SH DESCRIPTION
Qi is a simple but well\-integrated package manager.  It can create,
install, remove, and upgrade software packages.  Qi produces binary
packages using recipes, which are files containing specific instructions
to build each package from source.  Qi can manage multiple packages
under a single directory hierarchy.  This method allows to maintain a
set of packages and multiple versions of them.  This means that Qi could
be used as the main package manager or complement the existing one.
.SH OPTIONS
.SS "List of commands:"
.TP
warn
Warn about files that will be installed
.TP
install
Install packages
.TP
remove
Remove packages
.TP
upgrade
Upgrade packages
.TP
extract
Extract packages for debugging purposes
.TP
create
Create a .tlz package from directory
.TP
build
Build packages using recipe names
.TP
order
Resolve build order through .order files
.SS "Options when installing, removing, or upgrading software packages:"
.TP
\fB\-f\fR, \fB\-\-force\fR
Force upgrade of pre\-existing packages
.TP
\fB\-k\fR, \fB\-\-keep\fR
Keep package directory when remove/upgrade
.TP
\fB\-p\fR, \fB\-\-prune\fR
Prune conflicts
.TP
\fB\-P\fR, \fB\-\-packagedir=\fR<dir>
Set directory for package installations
.TP
\fB\-t\fR, \fB\-\-targetdir=\fR<dir>
Set target directory for symbolic links
.TP
\fB\-r\fR, \fB\-\-rootdir=\fR<dir>
Use the fully qualified named directory as
the root directory for all qi operations
Note: the target directory and the package
directory will be relative to the specified
directory, excepting the graft log file
.SS "Options when building software packages using recipes:"
.TP
\fB\-a\fR, \fB\-\-architecture\fR
Set architecture name for the package
.TP
\fB\-j\fR, \fB\-\-jobs\fR
Parallel jobs for the compiler
.TP
\fB\-k\fR, \fB\-\-keep\fR
Keep ${srcdir} or ${destdir} when build
.TP
\fB\-S\fR, \fB\-\-skip\-questions\fR
Skip questions on completed recipes
.TP
\fB\-1\fR, \fB\-\-increment\fR
Increment release number (${release} + 1)
.TP
\fB\-n\fR, \fB\-\-no\-package\fR
Do not create a .tlz package
.TP
\fB\-i\fR, \fB\-\-install\fR
Install package after the build
.TP
\fB\-u\fR, \fB\-\-upgrade\fR
Upgrade package after the build
.TP
\fB\-o\fR, \fB\-\-outdir=\fR<dir>
Where the packages produced will be written
.TP
\fB\-w\fR, \fB\-\-worktree=\fR<dir>
Where archives, patches, recipes are expected
.TP
\fB\-s\fR, \fB\-\-sourcedir=\fR<dir>
Where compressed sources will be found
.SS "Other options:"
.TP
\fB\-N\fR, \fB\-\-no\-rc\fR
Do not read the configuration file
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Be verbose (an extra \fB\-v\fR gives more)
.TP
\fB\-L\fR, \fB\-\-show\-location\fR
Print default directory locations and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
Display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
Output version information and exit
.SH ENVIRONMENT
.SS "Some influential environment variables:"
.TP
TMPDIR
Temporary directory for sources
.TP
QICFLAGS
C compiler flags (to be used on CFLAGS)
.TP
QICXXFLAGS
C++ compiler flags (to be used on CXXFLAGS)
.TP
QILDFLAGS
Flags for the linker (to be used on LDFLAGS)
.TP
QICPPFLAGS
C/C++ preprocessor flags (to be used on CPPFLAGS)
.TP
SOURCE_DATE_EPOCH
Last modification time for created packages
.SH "SEE ALSO"
The full documentation for
.B qi
is maintained as a Texinfo manual.  If the
.B info
and
.B qi
programs are properly installed at your site, the command
.IP
.B info qi
.PP
should give you access to the complete manual.