blob: 6f444482da6f01cfe9f1e7932526db67438a28bb (
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
54
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qdoctests-outputfromqdocfiles.qdoc -->
<title>Testing QDoc output from .qdoc files | Test</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>/*!</code> <code>This text is contained within QDoc comment tags.</code> <code>*/</code>.</p>
<a name="supported-file-types"></a>
<h2 id="supported-file-types">Supported file types</h2>
<p>QDoc parses <code>.cpp</code> and <code>.qdoc</code> files. It does extract comments from header (<code>.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>.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>\page</code></li>
<li><code>\title</code></li>
<li><code>\brief</code></li>
<li><code>\e</code> (for emphasizing "QDoc comments")</li>
<li><code>\c</code> (for multiple monospace-formatted entries)</li>
<li><code>\section1</code></li>
<li><code>\list</code></li>
<li><code>\li</code></li>
<li><code>\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">Linking to a page title</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html#link-targets">Linking to a section title</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html#link-test-target">Linking using a \target string</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html">Linking using a \keyword string</a></li>
</ul>
</div>
<!-- @@@qdoctests-qdocfileoutput.html -->
</body>
</html>
|
