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
|
/// - attention: This function is so hip and exciting, it can't be trusted.
func attention() {}
/// - author: Stephen
func author() {}
/// - authors:
/// - Homer
/// - Mark
/// - J.
func authors() {}
/// - bug: rdar://problem/8675309
func bug() {}
/// - complexity: O(n log2(n))
func complexity() {}
/// - copyright: 2015 Apple, Inc.
func copyright() {}
/// - date: Thu Apr 23 22:38:09 PDT 2015
func date() {}
/// - experiment: Try some more. The strawberries taste like strawberries.
func experiment() {}
/// - invariant: x not nil
struct Invariant {
let x: Int!
}
/// - note: This function is very hip and exciting.
func note() {}
/// - postcondition: x is unchanged
func postcondition(_ x: inout Int) {}
/// - precondition: `x < 100`
func precondition(_ x: Int) {
assert(x < 100)
}
/// - remark: Always, no, never forget to check your references.
func remark() {}
/// - remarks:
/// - Never let a bear approach you.
func remarks() {}
/// - requires:
/// - explicit package name. Just kidding!
func requires() {}
/// - seealso: the pie (it's very good).
func see() {}
/// - since: 1809
func since() {}
/// - todo: be
/// - todo: or not to be
func todo() {}
/// - version: Beta.
func version() {}
/// - warning: Share the road.
func warning() {}
/// ![/bogus/url/as/title]()
func imageWithEmptyURLAndBogusTitle () {}
/// Brief.
///
/// 
func imageTitleAndAlt() {}
/// Brief.
///
/// 
func imageAlt() {}
/// Brief.
///
/// 
func imageTitle() {}
/// Brief.
///
/// Test [a link](http://apple.com?a=1&b=1&c=abc)
func urlWithQueryString() {}
/// Brief.
///
/// 
func imageWithAmpersandsInTitleAndAlt() {}
|
