<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- /home/gvatteka/dev/qt-4.3/doc/src/qt-conf.qdoc -->
<head>
<title>Using qt.conf</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<h1 align="center">Using qt.conf<br /><small></small></h1>
<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="core/QLibraryInfo.html"><tt>QLibraryInfo</tt></a> class. Without <tt>qt.conf</tt>, the functions in <a href="core/QLibraryInfo.html"><tt>QLibraryInfo</tt></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="core/QLibraryInfo.html"><tt>QLibraryInfo</tt></a> will load <tt>qt.conf</tt> from one of the following locations:</p>
<ol type="1">
<li><tt>:/qt/etc/qt.conf</tt> using the resource system</li>
<li>on Mac OS X, in the Resource directory inside the appliction bundle, for example <tt>assistant.app/Contents/Resources/qt.conf</tt></li>
<li>in the directory containing the application executable, i.e. QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"</li>
</ol>
<p>The <tt>qt.conf</tt> file is an INI text file, as described in the QSettings documentation. The file should have a <tt>Paths</tt> group which contains the entries that correspond to each value of the QLibraryInfo::LibraryLocation enum. See the <a href="core/QLibraryInfo.html"><tt>QLibraryInfo</tt></a> documentation for details on the meaning of the various locations.</p>
<p><table align="center" cellpadding="2" cellspacing="1" border="0">
<thead><tr valign="top" class="qt-style"><th>Entry</th><th>Default Value</th></tr></thead>
<tr valign="top" class="odd"><td>Prefix</td><td>QCoreApplication::applicationDirPath()</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>Data</td><td><tt>.</tt></td></tr>
<tr valign="top" class="even"><td>Translations</td><td><tt>translations</tt></td></tr>
<tr valign="top" class="odd"><td>Settings</td><td><tt>.</tt></td></tr>
<tr valign="top" class="even"><td>Examples</td><td><tt>.</tt></td></tr>
<tr valign="top" class="odd"><td>Demos</td><td><tt>.</tt></td></tr>
</table></p>
<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 (QCoreApplication::applicationDirPath()). 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.</p>
<p>For example, a <tt>qt.conf</tt> file could contain the following:</p>
<pre> [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.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> 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.1 matches <tt>Paths/4</tt></li>
<li>4.1.5 matches <tt>Paths/4.1</tt></li>
<li>4.6.3 matches <tt>Paths/4.2.5</tt></li>
<li>5.0.0 matches <tt>Paths</tt></li>
<li>6.0.2 matches <tt>Paths/6</tt></li>
</ul>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%">Copyright © 2007 <a href="trolltech.html">Trolltech</a></td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt Jambi </div></td>
</tr></table></div></address></body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
a6711891ce757817bba854bf3f25205a
>
files
>
2269
