summaryrefslogtreecommitdiffstats
path: root/src/corelib
diff options
context:
space:
mode:
authorPasi Matilainen <pasi.matilainen@digia.com>2012-04-17 12:58:20 (GMT)
committerQt by Nokia <qt-info@nokia.com>2012-04-23 07:05:50 (GMT)
commitb5149bec53e6eb3b2baa4bfb95eeaf0bfb9bd67b (patch)
tree392e35debbdb79eb6b668008077624ad18fcca93 /src/corelib
parentee6708dda8312d6e5af0cf914e8fa277224b16aa (diff)
downloadQt-b5149bec53e6eb3b2baa4bfb95eeaf0bfb9bd67b.zip
Qt-b5149bec53e6eb3b2baa4bfb95eeaf0bfb9bd67b.tar.gz
Qt-b5149bec53e6eb3b2baa4bfb95eeaf0bfb9bd67b.tar.bz2
Update QSettings and Mac OS X documentation with App Store information
Add information about changing the location of global Qt settings to QSettings documentation, and general information about submitting Qt apps to the Mac App Store to the "Qt for Mac OS X - Specific Issues" document. Task-number: QTBUG-16549 Change-Id: Ic0210e8f4d3c3f6369032abd5c1e214b4200b179 Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
Diffstat (limited to 'src/corelib')
-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