summaryrefslogtreecommitdiffstats
path: root/doc/src/declarative
diff options
context:
space:
mode:
authorWarwick Allison <warwick.allison@nokia.com>2010-07-05 23:59:41 (GMT)
committerJason McDonald <jason.mcdonald@nokia.com>2010-07-13 05:16:36 (GMT)
commit174216f57b881ff1ab9d7df8bdbb5e2564df51b0 (patch)
tree1232b21372ce74c59fe03ca51553491305a2e856 /doc/src/declarative
parent4f9b0f34c985c810da5027d245515d8c66191881 (diff)
downloadQt-174216f57b881ff1ab9d7df8bdbb5e2564df51b0.zip
Qt-174216f57b881ff1ab9d7df8bdbb5e2564df51b0.tar.gz
Qt-174216f57b881ff1ab9d7df8bdbb5e2564df51b0.tar.bz2
Fix inconsistent reporting of module import errors when using versions.
Task-number: QTBUG-11936 (cherry picked from commit cabdb16f5ea6458dec9a2ec3b70a01e498b27dbc)
Diffstat (limited to 'doc/src/declarative')
-rw-r--r--doc/src/declarative/modules.qdoc11
1 files changed, 9 insertions, 2 deletions
diff --git a/doc/src/declarative/modules.qdoc b/doc/src/declarative/modules.qdoc
index 02a2f5f..36570da 100644
--- a/doc/src/declarative/modules.qdoc
+++ b/doc/src/declarative/modules.qdoc
@@ -103,9 +103,16 @@ the \c qmldir file. Types which you do not wish to export to users of your modul
may be marked with the \c internal keyword: \c internal <TypeName> <File>.
The same type can be provided by different files in different versions, in which
-case later earlier versions (eg. 1.2) must precede earlier versions (eg. 1.0),
+case later versions (eg. 1.2) must precede earlier versions (eg. 1.0),
since the \e first name-version match is used and a request for a version of a type
-can be fulfilled by one defined in an earlier version of the module.
+can be fulfilled by one defined in an earlier version of the module. If a user attempts
+to import a version earlier than the earliest provided or later than the latest provided,
+an error results, but if the user imports a version within the range of versions provided,
+even if no type is specific to that version, no error results.
+
+A single module, in all versions, may only be provided in a single directory (and a single \c qmldir file).
+If multiple are provided, only the first in the search path will be used (regardless of whether other versions
+are provided by directories later in the search path).
Installed and remote files without a namespace \e must be referred to by version information described above,
local files \e may have it.