summaryrefslogtreecommitdiffstats
path: root/src/corelib/io/qsettings.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/corelib/io/qsettings.cpp')
-rw-r--r--src/corelib/io/qsettings.cpp21
1 files changed, 21 insertions, 0 deletions
diff --git a/src/corelib/io/qsettings.cpp b/src/corelib/io/qsettings.cpp
index d7c8c50..4f318ae 100644
--- a/src/corelib/io/qsettings.cpp
+++ b/src/corelib/io/qsettings.cpp
@@ -2437,6 +2437,27 @@ void QConfFileSettingsPrivate::ensureSectionParsed(QConfFile *confFile,
Note that this may affect framework libraries' functionality if they expect
the settings to be shared between applications.
+ \section2 Changing the location of global Qt settings on Mac OS X
+
+ On Mac OS X, the global Qt settings (stored in \c com.trolltech.plist)
+ are stored in the application settings file in two situations:
+
+ \list 1
+ \o If the application runs in a Mac OS X sandbox (on Mac OS X 10.7 or later) or
+ \o If the \c Info.plist file of the application contains the key \c "ForAppStore" with the value \c "yes"
+ \endlist
+
+ In these situations, the application settings file is named using
+ the bundle identifier of the application, which must consequently
+ be set in the application's \c Info.plist file.
+
+ This feature is provided to ease the acceptance of Qt applications into
+ the Mac App Store, as the default behaviour of storing global Qt
+ settings in the \c com.trolltech.plist file does not conform with Mac
+ App Store file system usage requirements. For more information
+ about submitting Qt applications to the Mac App Store, see
+ \l{mac-differences.html#Preparing a Qt application for Mac App Store submission}{Preparing a Qt application for Mac App Store submission}.
+
\section2 Platform Limitations
While QSettings attempts to smooth over the differences between