/usr/share/qt5/doc/qtqml/qtqml-modules-legacymodules.html is in qtdeclarative5-doc-html 5.5.1-2ubuntu6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- legacymodules.qdoc -->
<title>Legacy Modules | Qt QML 5.5</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.5</li>
<li><a href="qtqml-index.html">Qt QML</a></li>
<li>Legacy Modules</li>
<li id="buildversion">Qt 5.5.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#installed-legacy-modules">Installed Legacy Modules</a></li>
<li class="level1"><a href="#located-legacy-modules">Located Legacy Modules</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Legacy Modules</h1>
<span class="subtitle"></span>
<!-- $$$qtqml-modules-legacymodules.html-description -->
<div class="descr"> <a name="details"></a>
<p>Legacy modules are modules whose specification <code>qmldir</code> file does not contain a module identifier directive. A legacy module may be either installed into the QML import path (as an installed legacy module) or imported by clients with a relative import (as a located legacy module). Clients are advised to avoid using legacy modules if possible. Module developers should ensure they create identified modules and not legacy modules.</p>
<a name="installed-legacy-modules"></a>
<h2 id="installed-legacy-modules">Installed Legacy Modules</h2>
<p>An installed, non-identified module is automatically given an identifier by the QML engine. This implicitly defined identifier is equal to the install path of the module (relative to the QML import path) where directory-separator characters are replaced with period characters.</p>
<p>A non-identified module which is installed into the QML import path has the following semantics:</p>
<ul>
<li>it may be imported by clients via the implicit module identifier</li>
<li>clients must specify a version when importing the module</li>
<li>conflicting type names are resolved arbitrarily by the QML engine, and the way in which conflicts are resolved is not guaranteed to stay the same between different versions of QML</li>
<li>other legacy modules may modify or override type definitions provided by the installed legacy module</li>
</ul>
<a name="located-legacy-modules"></a>
<h2 id="located-legacy-modules">Located Legacy Modules</h2>
<p>A non-identified module which is imported via a relative directory path import statement is loaded by the engine as a located legacy module. The following semantics apply to located legacy modules:</p>
<ul>
<li>it may be imported by clients via a relative import path</li>
<li>it is not mandatory for clients to specify a version when importing the module</li>
<li>if no import version is supplied by the client in the import statement, no guarantees are given by the QML engine about which version of the definition of a given type name will be imported</li>
<li>conflicting type names are resolved arbitrarily by the QML engine, and the way in which conflicts are resolved is not guaranteed to stay the same between different versions of QML</li>
<li>other legacy modules may modify or override type definitions provided by the located legacy module</li>
</ul>
<p>A located legacy module may reside on the local file system or on the network and can be referred to by a URL that specifies the file system path or network URL.</p>
</div>
<!-- @@@qtqml-modules-legacymodules.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|