qi: determine whether to preserve debugging shell flags (for the purpose)
[dragora.git] / qi / doc / qi.1
blob609c2bbe7925179baee25e888ddde5cf523bce0f
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
2 .TH QI "1" "November 2018" "qi 1.0-rc50" "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 and exit 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\-t\fR
46 <DIR>   Target directory for symbolic links;
47 .IP
48 only valid for \fB\-i\fR, \fB\-d\fR, or \fB\-u\fR options
49 .TP
50 \fB\-k\fR
51 Keep (don't delete) srcdir or destdir
52 Keep (don't delete) package directory
53 this is for \fB\-b\fR, \fB\-d\fR or \fB\-u\fR options
54 .TP
55 \fB\-p\fR
56 Prune conflicts on package (de)installation
57 .TP
58 \fB\-r\fR
59 Use the named directory as the root directory
60 for installing, deleting, or upgrading packages.
61 The target directory, package directory will be
62 relative to this specific directory
63 .TP
64 \fB\-v\fR
65 Be verbose (a 2nd \fB\-v\fR gives more)
66 .SS "Options for 'build' mode (-b):"
67 .TP
68 \fB\-O\fR
69 <DIR>   Where the produced packages are written
70 .TP
71 \fB\-W\fR
72 <DIR>   Where archives, patches, and recipes are expected
73 .TP
74 \fB\-Z\fR
75 <DIR>   Where (compressed) sources will be found
76 .TP
77 \fB\-a\fR
78 Architecture to use [detected]
79 .TP
80 \fB\-f\fR
81 Force proceeding with a recipe
82 .TP
83 \fB\-j\fR
84 Parallel jobs for the compiler
85 .TP
86 \fB\-1\fR
87 Increment release number (release + 1)
88 .TP
89 \fB\-3\fR
90 Resume skipping completed recipes option
91 .TP
92 \fB\-n\fR
93 Don't create a .tlz package
94 .SS "Other options:"
95 .TP
96 \fB\-h\fR
97 Display this help and exit
98 .TP
99 \fB\-V\fR
100 Output version information
101 .SS "Some influential environment variables:"
103 TMPDIR
104 Temporary directory for sources
106 QICFLAGS
107 C compiler flags
109 QICXXFLAGS
110 C++ compiler flags
112 QILDFLAGS
113 Linker flags
115 When FILE is \-, read standard input.
116 .SH COPYRIGHT
117 Copyright \(co 2016\-2018 Matias Andres Fonzo.
118 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
120 This is free software: you are free to change and redistribute it.
121 There is NO WARRANTY, to the extent permitted by law.
122 .SH "SEE ALSO"
123 The full documentation for
124 .B qi
125 is maintained as a Texinfo manual.  If the
126 .B info
128 .B qi
129 programs are properly installed at your site, the command
131 .B info qi
133 should give you access to the complete manual.