summaryrefslogtreecommitdiffstats
path: root/doc/qtchooser.1
blob: 4c9bb83f0cad19d5f7cb56d3b19baecdd1391061 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
.TH QTCHOOSER 1 "JANUARY 2, 2013"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
qtchooser \- a wrapper used to select between Qt development binary versions
.SH SYNOPSIS
.B qtchooser
\fB\-list\-versions\fR
.br
.B qtchooser
\fB\-print\-env\fR [\fB\-qt=\fIversion\fR]
.br
.B qtchooser
\fB\-run\-tool=\fItool\fR [\fB\-qt=\fIversion\fR] [\fIprogram_arguments\fR]
.br
.B <executable_name>
[\fB\-qt=\fIversion\fR] [\fIprogram_arguments\fR]
.br
.SH DESCRIPTION
Qt is a cross-platform C++ application framework. Qt's primary feature
is its rich set of widgets that provide standard GUI functionality.

The Qt Chooser provides a wrapper to switch between versions of Qt
development binaries when multiple versions like 4 and 5 are installed
or local Qt builds are to be used.

It is commonly used via a symlink from an \fIexecutable_name\fR like qmake.
.SH OPTIONS
The options which apply to the
\fBqtchooser\fR
command are:
.PP
\fB\-list\-versions\fR
.RS 4
Lists available Qt versions from the configuration files
.RE
.PP
\fB\-print\-env\fR
.RS 4
Prints environment information
.RE
.PP
\fB\-qt=\fIversion\fR
.RS 4
Selects \fIversion\fR as the Qt version to be used
.RE
.PP
\fB\-run\-tool=\fItool\fR
.RS 4
Runs the selected \fItool\fR.
.RE
.SH ENVIRONMENT
.TP
.B QTCHOOSER_NO_GLOBAL_DIR
If qtchooser has been built with \fBQTCHOOSER_GLOBAL_DIR\fR (predefined search
paths for qtchooser's configuration files, useful in some distros), setting this
variable will override its effect.
.RE
.TP
.B QT_SELECT
Same as \fB\-qt=\fIversion\fR. If set, the selected configuration is used and binaries
symlinked to qtchooser will be executed without additional parameters.
.RE
.TP
.B XDG_CONFIG_HOME
.TP
.B XDG_CONFIG_DIRS
Used as specified in
<\fBhttp://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html\fR>
.SH FILES
.TP
.I /etc/xdg/qtchooser/*.conf
System-wide configuration files. Each has two lines, the first is the path
to the binaries and the second is the path to the Qt libraries. If a
\fIdefault.conf\fR is provided, the settings from it will be automatically
used in case nothing else is selected.
.TP
.I \fB$HOME\fP/.config/qtchooser/*.conf
User configuration files.

.SH AUTHOR
qtchooser was written by Thiago Macieira from Intel.
.PP
This manual page was written by Timo Jyrinki <timo@debian.org>,
for the Debian project (but may be used by others).