blob: 7aa8e64d50df0cc0af4a1c8bfb5c362531d3430a (
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
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
|
// THIS IS A GENERATED TEST. DO NOT EDIT.
// To regenerate, see clang-doc/gen_test.py docstring.
//
// RUN: rm -rf %t
// RUN: mkdir %t
// RUN: echo "" > %t/compile_flags.txt
// RUN: cp "%s" "%t/test.cpp"
/// \brief Brief description.
///
/// Extended description that
/// continues onto the next line.
///
/// <ul class="test">
/// <li> Testing.
/// </ul>
///
/// \verbatim
/// The description continues.
/// \endverbatim
/// --
/// \param [out] I is a parameter.
/// \param J is a parameter.
/// \return void
void F(int I, int J);
/// Bonus comment on definition
void F(int I, int J) {}
// RUN: clang-doc --format=yaml --doxygen --extra-arg=-fmodules-ts -p %t %t/test.cpp -output=%t/docs
// RUN: cat %t/docs/./GlobalNamespace.yaml | FileCheck %s --check-prefix CHECK-0
// CHECK-0: ---
// CHECK-0-NEXT: USR: '{{[0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z]}}'
// CHECK-0-NEXT: ChildFunctions:
// CHECK-0-NEXT: - USR: '{{[0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z][0-9A-Z]}}'
// CHECK-0-NEXT: Name: 'F'
// CHECK-0-NEXT: Description:
// CHECK-0-NEXT: - Kind: 'FullComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'BlockCommandComment'
// CHECK-0-NEXT: Name: 'brief'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' Brief description.'
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' Extended description that'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' continues onto the next line.'
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'HTMLStartTagComment'
// CHECK-0-NEXT: Name: 'ul'
// CHECK-0-NEXT: AttrKeys:
// CHECK-0-NEXT: - 'class'
// CHECK-0-NEXT: AttrValues:
// CHECK-0-NEXT: - 'test'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'HTMLStartTagComment'
// CHECK-0-NEXT: Name: 'li'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' Testing.'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'HTMLEndTagComment'
// CHECK-0-NEXT: Name: 'ul'
// CHECK-0-NEXT: SelfClosing: true
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'VerbatimBlockComment'
// CHECK-0-NEXT: Name: 'verbatim'
// CHECK-0-NEXT: CloseName: 'endverbatim'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'VerbatimBlockLineComment'
// CHECK-0-NEXT: Text: ' The description continues.'
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' --'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'ParamCommandComment'
// CHECK-0-NEXT: Direction: '[out]'
// CHECK-0-NEXT: ParamName: 'I'
// CHECK-0-NEXT: Explicit: true
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' is a parameter.'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'ParamCommandComment'
// CHECK-0-NEXT: Direction: '[in]'
// CHECK-0-NEXT: ParamName: 'J'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' is a parameter.'
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: - Kind: 'BlockCommandComment'
// CHECK-0-NEXT: Name: 'return'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' void'
// CHECK-0-NEXT: - Kind: 'FullComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'ParagraphComment'
// CHECK-0-NEXT: Children:
// CHECK-0-NEXT: - Kind: 'TextComment'
// CHECK-0-NEXT: Text: ' Bonus comment on definition'
// CHECK-0-NEXT: DefLocation:
// CHECK-0-NEXT: LineNumber: 28
// CHECK-0-NEXT: Filename: 'test'
// CHECK-0-NEXT: Location:
// CHECK-0-NEXT: - LineNumber: 25
// CHECK-0-NEXT: Filename: 'test'
// CHECK-0-NEXT: Params:
// CHECK-0-NEXT: - Type:
// CHECK-0-NEXT: Name: 'int'
// CHECK-0-NEXT: Name: 'I'
// CHECK-0-NEXT: - Type:
// CHECK-0-NEXT: Name: 'int'
// CHECK-0-NEXT: Name: 'J'
// CHECK-0-NEXT: ReturnType:
// CHECK-0-NEXT: Type:
// CHECK-0-NEXT: Name: 'void'
// CHECK-0-NEXT: ...
|