xref: /qemu/tests/qapi-schema/doc-good.txt (revision 3e775730)
1Section
2*******
3
4
5Subsection
6==========
7
8*with emphasis* "var" {in braces}
9
10* List item one
11
12* Two, multiple lines
13
14* Three Still in list
15
16Not in list
17
18* Second list Note: still in list
19
20Note: not in list
21
221. Third list is numbered
23
242. another item
25
26Returns: the King Since: the first age Notes:
27
281. Lorem ipsum dolor sit amet
29
302. Ut enim ad minim veniam
31
32Duis aute irure dolor
33
34Example:
35
36-> in <- out Examples: - *verbatim* - {braces}
37
38
39"Enum" (Enum)
40-------------
41
42
43Values
44~~~~~~
45
46"one" (**If: **"IFONE")
47   The _one_ {and only}, description on the same line
48
49"two"
50   Not documented
51
52
53Features
54~~~~~~~~
55
56"enum-feat"
57   Also _one_ {and only}
58
59"enum-member-feat"
60   a member feature
61
62"two" is undocumented
63
64
65If
66~~
67
68"IFCOND"
69
70
71"Base" (Object)
72---------------
73
74
75Members
76~~~~~~~
77
78"base1": "Enum"
79   description starts on a new line, minimally indented
80
81
82If
83~~
84
85"IFALL1 and IFALL2"
86
87
88"Variant1" (Object)
89-------------------
90
91A paragraph
92
93Another paragraph
94
95"var1" is undocumented
96
97
98Members
99~~~~~~~
100
101"var1": "string" (**If: **"IFSTR")
102   Not documented
103
104
105Features
106~~~~~~~~
107
108"variant1-feat"
109   a feature
110
111"member-feat"
112   a member feature
113
114
115"Variant2" (Object)
116-------------------
117
118
119"Object" (Object)
120-----------------
121
122
123Members
124~~~~~~~
125
126The members of "Base"
127The members of "Variant1" when "base1" is ""one""
128The members of "Variant2" when "base1" is ""two"" (**If: **"IFONE or
129IFTWO")
130
131Features
132~~~~~~~~
133
134"union-feat1"
135   a feature
136
137
138"Alternate" (Alternate)
139-----------------------
140
141
142Members
143~~~~~~~
144
145"i": "int"
146   description starts on the same line remainder indented the same "b"
147   is undocumented
148
149"b": "boolean"
150   Not documented
151
152
153Features
154~~~~~~~~
155
156"alt-feat"
157   a feature
158
159
160If
161~~
162
163"not (IFONE or IFTWO)"
164
165
166Another subsection
167==================
168
169
170"cmd" (Command)
171---------------
172
173
174Arguments
175~~~~~~~~~
176
177"arg1": "int"
178   description starts on a new line, indented
179
180"arg2": "string" (optional)
181   description starts on the same line remainder indented differently
182
183"arg3": "boolean"
184   Not documented
185
186
187Features
188~~~~~~~~
189
190"cmd-feat1"
191   a feature
192
193"cmd-feat2"
194   another feature
195
196
197Note
198~~~~
199
200"arg3" is undocumented
201
202
203Returns
204~~~~~~~
205
206"Object"
207
208
209Notes
210~~~~~
211
212* Lorem ipsum dolor sit amet
213
214* Ut enim ad minim veniam
215
216Duis aute irure dolor
217
218
219Example
220~~~~~~~
221
222   -> in
223   <- out
224
225
226Examples
227~~~~~~~~
228
229   - *verbatim*
230   - {braces}
231
232
233Since
234~~~~~
235
2362.10
237
238
239"cmd-boxed" (Command)
240---------------------
241
242If you're bored enough to read this, go see a video of boxed cats
243
244
245Arguments
246~~~~~~~~~
247
248The members of "Object"
249
250Features
251~~~~~~~~
252
253"cmd-feat1"
254   a feature
255
256"cmd-feat2"
257   another feature
258
259
260Example
261~~~~~~~
262
263   -> in
264
265   <- out
266
267
268"EVT_BOXED" (Event)
269-------------------
270
271
272Arguments
273~~~~~~~~~
274
275The members of "Object"
276
277Features
278~~~~~~~~
279
280"feat3"
281   a feature
282