-
-
Notifications
You must be signed in to change notification settings - Fork 594
/
ddoc10.html
142 lines (123 loc) · 3.73 KB
/
ddoc10.html
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
136
137
138
139
140
141
142
<html><head>
<META http-equiv="content-type" content="text/html; charset=utf-8">
<title>ddoc10</title>
</head><body>
<h1>ddoc10</h1>
<br><br>
<dl><dt><big><a name="Foo"></a>struct <u>Foo</u>(T);
<br>struct <u>Foo</u>(T, U);
</big></dt>
<dd>The foo<br><br>
</dd>
<dt><big><a name="func1"></a>int <u>func1</u>(T)(T <i>x</i>);
</big></dt>
<dd>This basic case doesn't work very well. The template signature is
documented twice, but the function signature (argument names and return
type) is not documented at all. This comment is also repeated twice.<br><br>
</dd>
<dt><big><a name="func2"></a>int <u>func2</u>(T, U)(T <i>x</i>, U <i>y</i>);
<br>int <u>func2</u>(T)(T <i>x</i>);
</big></dt>
<dd>This comment is also repeated twice, and the second function signature is
not very well documented.<br><br>
</dd>
<dt><big><a name="func2.2"></a>int <u>func2</u>()();
</big></dt>
<dd>Separate overload item.<br><br>
</dd>
<dt><big><a name="func3"></a>int <u>func3</u>(T, U)(T <i>x</i>, U <i>y</i>);
<br>int <u>func3</u>(T, U = int, V : long)(T <i>x</i>);
</big></dt>
<dd>This used to work adequately and documented both <u>func3</u> templates
simultaneously. Now, it documents the first template twice and
no longer documents the function argument and return types.<br><br>
</dd>
<dt><big><a name="map"></a>void <u>map</u>(char <i>rs</i>);
<br>void <u>map</u>(int <i>rs</i>);
</big></dt>
<dd>blah<br><br>
</dd>
<dt><big><a name="map2"></a>void <u>map2</u>()(char <i>rs</i>);
<br>void <u>map2</u>()(int <i>rs</i>);
</big></dt>
<dd>blah<br><br>
</dd>
<dt><big><a name="map3"></a>void <u>map3</u>(char <i>rs</i>);
</big></dt>
<dd>blah http://www.map3.com <u>map3</u><br><br>
</dd>
<dt><big><a name="map4"></a>void <u>map4</u>(string s)(char <i>rs</i>);
</big></dt>
<dd>blah http://www.map.com map<br><br>
</dd>
<dt><big><a name="map5"></a>template <u>map5</u>(string s)</big></dt>
<dd>blah http://www.map.com map<br><br>
</dd>
<dt><big><a name="bar6"></a>struct <u>bar6</u>;
</big></dt>
<dd>blah<br><br>
</dd>
<dt><big><a name="Foo7"></a>struct <u>Foo7</u>(T);
</big></dt>
<dd>template bodies<br><br>
<dl><dt><big><a name="Foo7.bar"></a>void <u>bar</u>();
</big></dt>
<dd>Attempt two: Inside.
<br><br>
Attempt one: Doc outside static if.<br><br>
</dd>
<dt><big><a name="Foo7.abc"></a>static void <u>abc</u>();
</big></dt>
<dd>the <u>abc</u> function should be static<br><br>
</dd>
</dl>
</dd>
<dt><big><a name="Foo8"></a>abstract class <u>Foo8</u>;
</big></dt>
<dd>show abstract<br><br>
</dd>
<dt><big><a name="bug4878"></a>void <u>bug4878</u>(string <i>a</i> = ")");
</big></dt>
<dd><i>a</i> stray ) mustn't foul the macros<br><br>
</dd>
<dt><big><a name="S"></a>struct <u>S</u>;
</big></dt>
<dd><br><br>
<dl><dt><big><a name="S.this"></a>const pure nothrow this(long <i>ticks</i>);
</big></dt>
<dd><br><br>
</dd>
<dt><big><a name="S.foo"></a>const pure nothrow void <u>foo</u>(long <i>ticks</i>);
</big></dt>
<dd><br><br>
</dd>
</dl>
</dd>
<dt><big><a name="f10"></a>float <u>f10</u>(float <i>a</i>, float <i>b</i>);
</big></dt>
<dd>Produces something in (<i>a</i>;<i>b</i>]<br><br>
</dd>
<dt><big><a name="h10"></a>float <u>h10</u>(float <i>a</i>, float <i>b</i>);
</big></dt>
<dd>Produces something in [<i>a</i>;<i>b</i>)<br><br>
</dd>
<dt><big><a name="bug6090"></a>void <u>bug6090</u>(string f = "$(B b)", char g = ')')(string <i>h</i> = "$(", string <i>i</i> = "$)");
</big></dt>
<dd><br><br>
</dd>
<dt><big><a name="T"></a>struct <u>T</u>;
</big></dt>
<dd><br><br>
<dl><dt><big><a name="T.this"></a>this(A...)(A <i>args</i>);
</big></dt>
<dd><br><br>
</dd>
<dt><big><a name="T.this.2"></a>this(int);
</big></dt>
<dd><br><br>
</dd>
</dl>
</dd>
</dl>
<hr><small>Page generated by <a href="http://dlang.org/ddoc.html">Ddoc</a>. </small>
</body></html>