summaryrefslogtreecommitdiffstats
path: root/doc/src/declarative
diff options
context:
space:
mode:
authorWarwick Allison <warwick.allison@nokia.com>2010-07-05 23:59:41 (GMT)
committerWarwick Allison <warwick.allison@nokia.com>2010-07-05 23:59:41 (GMT)
commitcabdb16f5ea6458dec9a2ec3b70a01e498b27dbc (patch)
tree5c7bea7f618edb91be5d365913324967857e89e2 /doc/src/declarative
parent48fa690558a8a73b6845aaea13fc29965150e733 (diff)
downloadQt-cabdb16f5ea6458dec9a2ec3b70a01e498b27dbc.zip
Qt-cabdb16f5ea6458dec9a2ec3b70a01e498b27dbc.tar.gz
Qt-cabdb16f5ea6458dec9a2ec3b70a01e498b27dbc.tar.bz2
Fix inconsistent reporting of module import errors when using versions.
Task-number: QTBUG-11936
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 a77c64e..938222a 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.