/usr/share/qt5/doc/qdoc/25-qdoc-configuration-derivedprojects.html is in qttools5-doc-html 5.9.5-0ubuntu1.
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 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qdoc-manual-qdocconf.qdoc -->
<title>Supporting Derived Projects | QDoc Manual 5.9</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.9</td><td ><a href="qdoc-index.html">QDoc Manual</a></td><td >Supporting Derived Projects</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.5 Reference Documentation</td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<link rel="prev" href="24-qdoc-configuration-htmlvariables.html" />
<link rel="next" href="26-qdoc-configuration-example-manifest-files.html" />
<p class="naviNextPrevious headerNavi">
<a class="prevPage" href="24-qdoc-configuration-htmlvariables.html">HTML Specific Configuration Variables</a>
<span class="naviSeparator"> ◦ </span>
<a class="nextPage" href="26-qdoc-configuration-example-manifest-files.html">Example Manifest Files</a>
</p><p/>
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#description">description</a></li>
<li class="level1"><a href="#indexes">indexes</a></li>
<li class="level1"><a href="#project">project</a></li>
<li class="level1"><a href="#url">url</a></li>
<li class="level1"><a href="#how-to-support-derived-projects">How to Support Derived Projects</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Supporting Derived Projects</h1>
<span class="subtitle"></span>
<!-- $$$25-qdoc-configuration-derivedprojects.html-description -->
<div class="descr"> <a name="details"></a>
<p>Some configuration variables allow you to use QDoc to support Qt-based projects. They allow your project to contain links to the online Qt documentation, which means that QDoc will be able to create links to the class reference documentation, without any explicit linking command.</p>
<a name="description-variable"></a><a name="description"></a>
<h2 id="description">description</h2>
<p>The description variable holds a short description of the associated project.</p>
<p>See also <a href="25-qdoc-configuration-derivedprojects.html#project">project</a>.</p>
<a name="indexes-variable"></a><a name="indexes"></a>
<h2 id="indexes">indexes</h2>
<p>The <code>indexes</code> variable lists the index files that will be used to generate references.</p>
<p>For example. to make a derived Qt project contain links to the Qt Reference documentation, you need to specify the associated index file:</p>
<pre class="cpp plain">
indexes = $QTDIR/doc/html/qt.index
</pre>
<p>See also <a href="25-qdoc-configuration-derivedprojects.html#project">project</a> and <a href="25-qdoc-configuration-derivedprojects.html#url">url</a>.</p>
<a name="project-variable"></a><a name="project"></a>
<h2 id="project">project</h2>
<p>The <code>project</code> variable provides a name for the project associated with the <code>.qdocconf</code> file.</p>
<p>The project's name is used to form a file name for the associated project's <i>index</i> file.</p>
<pre class="cpp plain">
project = QtCreator
</pre>
<p>This will cause an index file called <code>qtcreator.index</code> to be created.</p>
<p>See also <a href="25-qdoc-configuration-derivedprojects.html#description">description</a> and <a href="25-qdoc-configuration-derivedprojects.html#indexes">indexes</a>.</p>
<a name="url-variable"></a><a name="url"></a>
<h2 id="url">url</h2>
<p>The <code>url</code> variable holds the base URL for the reference documentation associated with the current project.</p>
<p>The URL is stored in the generated index file for the project. When we use the index on its own, QDoc will use this as the base URL when constructing links to classes, functions, and other things listed in the index.</p>
<pre class="cpp plain">
project = Qt
description = Qt Reference Documentation
url = http://doc.qt.io/qt-4.8/
...
</pre>
<p>This makes sure that whenever <code>qt.index</code> is used to generate references to for example Qt classes, the base URL is <code>http://doc.qt.io/qt-4.8/</code>.</p>
<p>See also <a href="25-qdoc-configuration-derivedprojects.html#indexes">indexes</a>.</p>
<a name="howto"></a><a name="how-to-support-derived-projects"></a>
<h2 id="how-to-support-derived-projects">How to Support Derived Projects</h2>
<p>This feature makes use of the comprehensive indexes generated by QDoc when it creates the Qt reference documentation.</p>
<p>For example, <a href="21-2-qtgui-qdocconf.html">qtgui.qdocconf</a> (the configuration file for Qt) contains the following variable definitions:</p>
<pre class="cpp plain">
project = Qt
description = Qt Reference Documentation
url = http://doc.qt.io/qt-4.8/
...
</pre>
<p>The <a href="25-qdoc-configuration-derivedprojects.html#project">project</a> variable name is used to form a file name for the index file; in this case the <code>qt.index</code> file is created. The <a href="25-qdoc-configuration-derivedprojects.html#url">url</a> is stored in the index file. Afterwards, QDoc will use this as the base URL when constructing links to classes, functions, and other things listed in the index.</p>
</div>
<!-- @@@25-qdoc-configuration-derivedprojects.html -->
<p class="naviNextPrevious footerNavi">
<a class="prevPage" href="24-qdoc-configuration-htmlvariables.html">HTML Specific Configuration Variables</a>
<span class="naviSeparator"> ◦ </span>
<a class="nextPage" href="26-qdoc-configuration-example-manifest-files.html">Example Manifest Files</a>
</p>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2017 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>
|