qi: make release of qi 1.1
[dragora.git] / qi / doc / qi.1
blob950b74d9df5563d08f243acb68f14c21a726f8f0
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.10.
2 .TH QI "1" "May 2019" "qi 1.1" "User Commands"
3 .SH NAME
4 qi \- a simple but well-integrated package manager
5 .SH SYNOPSIS
6 .B qi
7 [\fI\,OPTION\/\fR...] [\fI\,FILE\/\fR]...
8 .SH DESCRIPTION
9 Qi \- A user\-friendly package manager.
10 .SS "Operation mode:"
11 .TP
12 \fB\-b\fR
13 Build packages using recipe names
14 .TP
15 \fB\-c\fR
16 Create .tlz package from directory
17 .TP
18 \fB\-d\fR
19 Delete packages
20 .TP
21 \fB\-i\fR
22 Install packages
23 .TP
24 \fB\-o\fR
25 Resolve build order through .order files
26 .TP
27 \fB\-u\fR
28 Update packages (implies \fB\-i\fR, \fB\-d\fR with \fB\-p\fR)
29 .TP
30 \fB\-w\fR
31 Warn about files that will be linked
32 .TP
33 \fB\-x\fR
34 Extract a package for debugging purposes
35 .SS "Common options:"
36 .TP
37 \fB\-N\fR
38 Do not read the configuration file
39 .TP
40 \fB\-P\fR <DIR>
41 Package directory for installations.
42 .IP
43 Only valid for \fB\-i\fR, \fB\-d\fR, or \fB\-u\fR options
44 .TP
45 \fB\-f\fR
46 This option can force the build of a recipe,
47 or force the update of a pre\-existing package.
48 .IP
49 Only valid for \fB\-b\fR, \fB\-u\fR options
50 .TP
51 \fB\-t\fR <DIR>
52 Target directory for symbolic links.
53 .IP
54 Only valid for \fB\-i\fR, \fB\-d\fR, or \fB\-u\fR options
55 .TP
56 \fB\-k\fR
57 Keep `${srcdir}' or `${destdir}' in build mode,
58 keep package directory in delete mode.
59 .IP
60 Only valid for \fB\-b\fR, \fB\-d\fR or \fB\-u\fR options
61 .TP
62 \fB\-p\fR
63 Prune conflicts on package installations
64 .TP
65 \fB\-r\fR <DIR>
66 Use the fully qualified named directory as the
67 root directory for all qi operations.  The target
68 directory and package directory will be relative to
69 the specified directory, including the log file for
70 graft
71 .TP
72 \fB\-v\fR
73 Be verbose (a 2nd \fB\-v\fR gives more)
74 .SS "Options for 'build' mode (-b):"
75 .TP
76 \fB\-O\fR
77 <DIR>   Where the packages produced are written
78 .TP
79 \fB\-W\fR
80 <DIR>   Where archives, patches, and recipes are expected
81 .TP
82 \fB\-Z\fR
83 <DIR>   Where (compressed) sources will be found
84 .TP
85 \fB\-a\fR
86 Architecture to use [detected]
87 .TP
88 \fB\-j\fR
89 Parallel jobs for the compiler
90 .TP
91 \fB\-1\fR
92 Increment release number (`${release}' + 1)
93 .TP
94 \fB\-n\fR
95 Don't create a .tlz package
96 .TP
97 \fB\-S\fR
98 Selects the option to skip completed recipes
99 .SS "Informative options:"
101 \fB\-L\fR
102 Print default directory locations
104 \fB\-h\fR
105 Display this help and exit
107 \fB\-V\fR
108 Output version information
109 .SS "Some influential environment variables:"
111 TMPDIR
112 Temporary directory for sources
114 QICFLAGS
115 C compiler flags
117 QICXXFLAGS
118 C++ compiler flags
120 QILDFLAGS
121 Linker flags
123 When FILE is \-, read standard input.
124 .SH COPYRIGHT
125 Copyright \(co 2016\-2019 Matias Andres Fonzo.
126 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
128 This is free software: you are free to change and redistribute it.
129 There is NO WARRANTY, to the extent permitted by law.
130 .SH "SEE ALSO"
131 The full documentation for
132 .B qi
133 is maintained as a Texinfo manual.  If the
134 .B info
136 .B qi
137 programs are properly installed at your site, the command
139 .B info qi
141 should give you access to the complete manual.