Document what the QMimeDatabase constructor really does.

Change-Id: I8d4dcc92296163dea7b78fbb0ceefaee08e57a94
Reviewed-by: Simon Hausmann <simon.hausmann@digia.com>
Reviewed-by: Allan Sandfeld Jensen <kde@carewolf.com>

diff --git a/src/corelib/mimetypes/qmimedatabase.cpp b/src/corelib/mimetypes/qmimedatabase.cpp
index c141eb9..5acc290 100644 (file)
--- a/src/corelib/mimetypes/qmimedatabase.cpp
+++ b/src/corelib/mimetypes/qmimedatabase.cpp
@@ -289,7 +289,12 @@ bool QMimeDatabasePrivate::inherits(const QString &mime, const QString &parent)
 
 /*!
     \fn QMimeDatabase::QMimeDatabase();
-    Constructs this QMimeDatabase object.
+    Constructs a QMimeDatabase object.
+
+    It is perfectly OK to create an instance of QMimeDatabase every time you need to
+    perform a lookup.
+    The parsing of mimetypes is done on demand (when shared-mime-info is installed)
+    or when the very first instance is constructed (when parsing XML files directly).
  */
 QMimeDatabase::QMimeDatabase() :
         d(staticQMimeDatabase())