File: qt-conf.html

package info (click to toggle)
qt4-x11 4%3A4.8.2%2Bdfsg-11
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 701,696 kB
  • sloc: cpp: 2,686,179; ansic: 375,485; python: 25,859; sh: 19,349; xml: 17,091; perl: 14,765; yacc: 5,383; asm: 5,038; makefile: 1,259; lex: 555; ruby: 526; objc: 347; cs: 112; pascal: 112; php: 54; sed: 34
file content (99 lines) | stat: -rw-r--r-- 6,680 bytes parent folder | download 
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qt-conf.qdoc -->
  <title>Qt 4.8: Using qt.conf</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="content"> 
    <a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
  </div>
  <div class="breadcrumb toolblock">
    <ul>
      <li class="first"><a href="index.html">Home</a></li>
      <!--  Breadcrumbs go here -->
<li>Using qt.conf</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<h1 class="title">Using qt.conf</h1>
<span class="subtitle"></span>
<!-- $$$qt-conf.html-description -->
<div class="descr"> <a name="details"></a>
<p>The <tt>qt.conf</tt> file overrides the hard-coded paths that are compiled into the Qt library. These paths are accessible using the <a href="qlibraryinfo.html">QLibraryInfo</a> class. Without <tt>qt.conf</tt>, the functions in <a href="qlibraryinfo.html">QLibraryInfo</a> return these hard-coded paths; otherwise they return the paths as specified in <tt>qt.conf</tt>.</p>
<p>Without <tt>qt.conf</tt>, the Qt libraries will use the hard-coded paths to look for plugins, translations, and so on. These paths may not exist on the target system, or they may not be accesssible. Because of this, you need <tt>qt.conf</tt> to make the Qt libraries look elsewhere.</p>
<p><a href="qlibraryinfo.html">QLibraryInfo</a> will load <tt>qt.conf</tt> from one of the following locations:</p>
<ol class="1">
<li><tt>:/qt/etc/qt.conf</tt> using the resource system</li>
<li>on Mac OS X, in the Resource directory inside the application bundle, for example <tt>assistant.app/Contents/Resources/qt.conf</tt></li>
<li>in the directory containing the application executable, i.e&#x2e; <a href="qcoreapplication.html#applicationDirPath">QCoreApplication::applicationDirPath</a>() + <a href="qdir.html#separator">QDir::separator</a>() + &quot;qt.conf&quot;</li>
</ol>
<p>The <tt>qt.conf</tt> file is an INI text file, as described in the <a href="qsettings.html#Format-enum">QSettings</a> documentation. The file should have a <tt>Paths</tt> group which contains the entries that correspond to each value of the <a href="qlibraryinfo.html#LibraryLocation-enum">QLibraryInfo::LibraryLocation</a> enum. See the <a href="qlibraryinfo.html">QLibraryInfo</a> documentation for details on the meaning of the various locations.</p>
<table class="generic">
<thead><tr class="qt-style"><th >Entry</th><th >Default Value</th></tr></thead>
<tr valign="top" class="odd"><td >Prefix</td><td ><a href="qcoreapplication.html#applicationDirPath">QCoreApplication::applicationDirPath</a>()</td></tr>
<tr valign="top" class="even"><td >Documentation</td><td ><tt>doc</tt></td></tr>
<tr valign="top" class="odd"><td >Headers</td><td ><tt>include</tt></td></tr>
<tr valign="top" class="even"><td >Libraries</td><td ><tt>lib</tt></td></tr>
<tr valign="top" class="odd"><td >Binaries</td><td ><tt>bin</tt></td></tr>
<tr valign="top" class="even"><td >Plugins</td><td ><tt>plugins</tt></td></tr>
<tr valign="top" class="odd"><td >Imports</td><td ><tt>imports</tt></td></tr>
<tr valign="top" class="even"><td >Data</td><td ><tt>.</tt></td></tr>
<tr valign="top" class="odd"><td >Translations</td><td ><tt>translations</tt></td></tr>
<tr valign="top" class="even"><td >Settings</td><td ><tt>.</tt></td></tr>
<tr valign="top" class="odd"><td >Examples</td><td ><tt>.</tt></td></tr>
<tr valign="top" class="even"><td >Demos</td><td ><tt>.</tt></td></tr>
</table>
<p>Absolute paths are used as specified in the <tt>qt.conf</tt> file. All paths are relative to the <tt>Prefix</tt>. On Windows and X11, the <tt>Prefix</tt> is relative to the directory containing the application executable (<a href="qcoreapplication.html#applicationDirPath">QCoreApplication::applicationDirPath</a>()). On Mac OS X, the <tt>Prefix</tt> is relative to the <tt>Contents</tt> in the application bundle. For example, <tt>application.app/Contents/plugins/</tt> is the default location for loading Qt plugins. Note that the plugins need to be placed in specific sub-directories under the <tt>plugins</tt> directory (see <a href="plugins-howto.html">How to Create Qt Plugins</a> for details).</p>
<p>For example, a <tt>qt.conf</tt> file could contain the following:</p>
<pre class="cpp"> [Paths]
 Prefix = /some/path
 Translations = i18n</pre>
<p>Subgroups of the <tt>Paths</tt> group may be used to specify locations for specific versions of the Qt libraries. Such subgroups are of the form <tt>Paths/x.y&#x2e;z</tt>, where x is the major version of the Qt libraries, y the minor, and z the patch level. The subgroup that most closely matches the current Qt version is used. If no subgroup matches, the <tt>Paths</tt> group is used as the fallback. The minor and patch level values may be omitted, in which case they default to zero.</p>
<p>For example, given the following groups:</p>
<pre class="cpp"> Paths
 Paths/4
 Paths/4.1
 Paths/4.2.5
 Paths/6</pre>
<p>The current version will be matched as shown:</p>
<ul>
<li>4.0&#x2e;1 matches <tt>Paths/4</tt></li>
<li>4.1&#x2e;5 matches <tt>Paths/4.1</tt></li>
<li>4.6&#x2e;3 matches <tt>Paths/4.2&#x2e;5</tt> (because 4.2&#x2e;5 is the latest version with the same major version number)</li>
<li>5.0&#x2e;0 matches <tt>Paths</tt></li>
<li>6.0&#x2e;2 matches <tt>Paths/6</tt></li>
</ul>
</div>
<!-- @@@qt-conf.html -->
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
    <p>
      <acronym title="Copyright">&copy;</acronym> 2012 Nokia Corporation and/or its
      subsidiaries. Documentation contributions included herein are the copyrights of
      their respective owners.</p>
    <br />
    <p>
      The documentation provided herein is licensed under the terms of the
      <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
      License version 1.3</a> as published by the Free Software Foundation.</p>
    <p>
      Documentation sources may be obtained from <a href="http://www.qt-project.org">
      www.qt-project.org</a>.</p>
    <br />
    <p>
      Nokia, Qt and their respective logos are trademarks of Nokia Corporation 
      in Finland and/or other countries worldwide. All other trademarks are property
      of their respective owners. <a title="Privacy Policy"
      href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
</body>
</html>