blob: ed48aa30f8f749386fd9af9d6f59bba3431b233c (
plain)
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
|
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<!-- qdoctests-outputfromqdocfiles.qdoc -->
<title>Testing QDoc output from .qdoc files | OutputFromQDocFiles</title>
</head>
<body>
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#supported-file-types">Supported file types</a></li>
<li class="level1"><a href="#further-information">Further information</a></li>
<li class="level1"><a href="#linking">Linking</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Testing QDoc output from .qdoc files</h1>
<span class="subtitle"></span>
<!-- $$$qdoctests-qdocfileoutput.html-description -->
<div class="descr"> <a name="details"></a>
<p>QDoc generates documentation for software projects. It does this by extracting <i>QDoc comments</i> from project source files. QDoc comments are signified by a C-style-like comment tag followed by an exclamation point, like this: <code translate="no">/*!</code> <code translate="no">This text is contained within QDoc comment tags.</code> <code translate="no">*/</code>.</p>
<a name="supported-file-types"></a>
<h2 id="supported-file-types">Supported file types</h2>
<p>QDoc parses <code translate="no">.cpp</code> and <code translate="no">.qdoc</code> files. It does extract comments from header (<code translate="no">.h</code>) files.</p>
<a name="further-information"></a>
<h2 id="further-information">Further information</h2>
<p>This test document is written with the purpose of testing the output QDoc generates when parsing <code translate="no">.qdoc</code> files. It is fairly simple and makes use of a limited subset of QDoc's command. Those commands are:</p>
<ul>
<li><code translate="no">\page</code></li>
<li><code translate="no">\title</code></li>
<li><code translate="no">\brief</code></li>
<li><code translate="no">\e</code> (for emphasizing "QDoc comments")</li>
<li><code translate="no">\c</code> (for multiple monospace-formatted entries)</li>
<li><code translate="no">\section1</code></li>
<li><code translate="no">\list</code></li>
<li><code translate="no">\li</code></li>
<li><code translate="no">\endlist</code></li>
</ul>
<a name="linking"></a>
<h2 id="linking">Linking</h2>
<p>There are multiple ways to create hyperlinks to other topics:</p>
<ul>
<li><a href="qdoctests-qdocfileoutput-linking.html" translate="no">Linking to a page title</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html#link-targets" translate="no">Linking to a section title</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html#link-test-target" translate="no">Linking using a \target string</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html" translate="no">Linking using a \keyword string</a></li>
</ul>
</div>
<!-- @@@qdoctests-qdocfileoutput.html -->
</body>
</html>
|
