xref: /qemu/tests/qapi-schema/doc-good.txt (revision 7653b1ea)
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
209Errors
210~~~~~~
211
212some
213
214
215Notes
216~~~~~
217
218* Lorem ipsum dolor sit amet
219
220* Ut enim ad minim veniam
221
222Duis aute irure dolor
223
224
225Example
226~~~~~~~
227
228   -> in
229   <- out
230
231
232Examples
233~~~~~~~~
234
235   - *verbatim*
236   - {braces}
237
238
239Since
240~~~~~
241
2422.10
243
244
245"cmd-boxed" (Command)
246---------------------
247
248If you're bored enough to read this, go see a video of boxed cats
249
250
251Arguments
252~~~~~~~~~
253
254The members of "Object"
255
256Features
257~~~~~~~~
258
259"cmd-feat1"
260   a feature
261
262"cmd-feat2"
263   another feature
264
265
266Example
267~~~~~~~
268
269   -> in
270
271   <- out
272
273
274"EVT_BOXED" (Event)
275-------------------
276
277
278Arguments
279~~~~~~~~~
280
281The members of "Object"
282
283Features
284~~~~~~~~
285
286"feat3"
287   a feature
288