<?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>