recipes: use + to append C flags in order to preserve the current (mostly the warning...
[dragora.git] / qi / doc / qi.1
blob5801d4e6130aac4504cbbc77c5a20eb48fd5ee23
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
2 .TH QI "1" "January 2019" "qi 1.0-rc54" "User Commands"
3 .SH NAME
4 qi \- package manager
5 .SH SYNOPSIS
6 .B qi
7 [\fI\,OPTION\/\fR...] [\fI\,FILE\/\fR]...
8 .SH DESCRIPTION
9 Qi \- A practical and user\-friendly package manager.
10 .SS "Operation mode:"
11 .TP
12 \fB\-b\fR
13 Build packages using recipes
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\-x\fR
31 Extract packages for debugging purposes
32 .SS "Common options:"
33 .TP
34 \fB\-L\fR
35 Print default directory locations
36 .TP
37 \fB\-N\fR
38 Don't read the configuration file
39 .TP
40 \fB\-P\fR
41 <DIR>   Package directory for (de)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 Force package upgrade
47 Force build a recipe
48 .TP
49 \fB\-t\fR
50 <DIR>   Target directory for symbolic links
51 .IP
52 (only valid for \fB\-i\fR, \fB\-d\fR, or \fB\-u\fR options)
53 .TP
54 \fB\-k\fR
55 Keep (don't delete) srcdir or destdir
56 Keep (don't delete) package directory
57 (only valid for \fB\-b\fR, \fB\-d\fR or \fB\-u\fR options)
58 .TP
59 \fB\-p\fR
60 Prune conflicts on package (de)installation
61 .TP
62 \fB\-r\fR
63 Use the named directory as the root directory
64 for installing, deleting, or upgrading packages.
65 The target directory, package directory will be
66 relative to this specific directory
67 .TP
68 \fB\-v\fR
69 Be verbose (a 2nd \fB\-v\fR gives more)
70 .SS "Options for 'build' mode (-b):"
71 .TP
72 \fB\-O\fR
73 <DIR>   Where the produced packages are written
74 .TP
75 \fB\-W\fR
76 <DIR>   Where archives, patches, and recipes are expected
77 .TP
78 \fB\-Z\fR
79 <DIR>   Where (compressed) sources will be found
80 .TP
81 \fB\-a\fR
82 Architecture to use [detected]
83 .TP
84 \fB\-j\fR
85 Parallel jobs for the compiler
86 .TP
87 \fB\-1\fR
88 Increment release number (release + 1)
89 .TP
90 \fB\-n\fR
91 Don't create a .tlz package
92 .TP
93 \fB\-S\fR
94 Selects the option to skip completed recipes
95 .SS "Other options:"
96 .TP
97 \fB\-h\fR
98 Display this help and exit
99 .TP
100 \fB\-V\fR
101 Output version information
102 .SS "Some influential environment variables:"
104 TMPDIR
105 Temporary directory for sources
107 QICFLAGS
108 C compiler flags
110 QICXXFLAGS
111 C++ compiler flags
113 QILDFLAGS
114 Linker flags
116 When FILE is \-, read standard input.
117 .SH COPYRIGHT
118 Copyright \(co 2016\-2019 Matias Andres Fonzo.
119 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
121 This is free software: you are free to change and redistribute it.
122 There is NO WARRANTY, to the extent permitted by law.
123 .SH "SEE ALSO"
124 The full documentation for
125 .B qi
126 is maintained as a Texinfo manual.  If the
127 .B info
129 .B qi
130 programs are properly installed at your site, the command
132 .B info qi
134 should give you access to the complete manual.