mirror of
https://github.com/qemu/qemu.git
synced 2025-08-14 03:15:54 +00:00
b09c8f7a99
doc-good.json currently uses the old *strong* and _emphasis_ markup.
As part of the conversion to rST this needs to switch to **strong**
and *emphasis*, because rST uses underscores as part of its markup
of hyperlinks and will otherwise warn about the syntax error.
In commit a660eed482 we fixed up the in-tree uses of the
old markup:
1) _this_ was replaced with *this*
2) the only in-tree use of *this* was left alone (turning
a 'strong' into an 'emphasis')
(and so currently in-tree nothing is using either new-style
**strong** or old-style _emphasis_).
Update doc-good.json in a similar way:
1) replace _this_ with *this*
2) remove the usage of old-style *this*
(This slightly reduces the coverage for the old Texinfo generator,
which is about to go away, but is fine for the new rST generator
because that does not need to handle strong/emphasis itself because
it is simply passing the entire text as raw rST to Sphinx.)
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-Id: <20200925162316.21205-13-peter.maydell@linaro.org>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
314 lines
3.6 KiB
Plaintext
314 lines
3.6 KiB
Plaintext
@c AUTOMATICALLY GENERATED, DO NOT MODIFY
|
|
|
|
@section Section
|
|
|
|
@subsection Subsection
|
|
|
|
@strong{with emphasis}
|
|
@code{var} @{in braces@}
|
|
|
|
@itemize @bullet
|
|
@item
|
|
List item one
|
|
@item
|
|
Two, multiple
|
|
lines
|
|
|
|
@item
|
|
Three
|
|
Still in list
|
|
|
|
@end itemize
|
|
|
|
Not in list
|
|
|
|
@itemize @minus
|
|
@item
|
|
Second list
|
|
Note: still in list
|
|
|
|
@end itemize
|
|
|
|
Note: not in list
|
|
|
|
@enumerate
|
|
@item
|
|
Third list
|
|
is numbered
|
|
|
|
@item
|
|
another item
|
|
|
|
@end enumerate
|
|
|
|
Returns: the King
|
|
Since: the first age
|
|
Notes:
|
|
|
|
@enumerate
|
|
@item
|
|
Lorem ipsum dolor sit amet
|
|
|
|
@item
|
|
Ut enim ad minim veniam
|
|
|
|
@end enumerate
|
|
|
|
Duis aute irure dolor
|
|
|
|
Example:
|
|
|
|
-> in
|
|
<- out
|
|
Examples:
|
|
@itemize @minus
|
|
@item
|
|
@strong{verbatim}
|
|
@item
|
|
@{braces@}
|
|
@end itemize
|
|
|
|
|
|
|
|
@deftp {Enum} Enum
|
|
|
|
|
|
|
|
@b{Values:}
|
|
@table @asis
|
|
@item @code{one}
|
|
The @emph{one} @{and only@}
|
|
@*@b{If:} @code{defined(IFONE)}
|
|
@item @code{two}
|
|
Not documented
|
|
@end table
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{enum-feat}
|
|
Also @emph{one} @{and only@}
|
|
@end table
|
|
@code{two} is undocumented
|
|
|
|
@b{If:} @code{defined(IFCOND)}
|
|
@end deftp
|
|
|
|
|
|
|
|
@deftp {Object} Base
|
|
|
|
|
|
|
|
@b{Members:}
|
|
@table @asis
|
|
@item @code{base1: Enum}
|
|
the first member
|
|
@end table
|
|
|
|
@end deftp
|
|
|
|
|
|
|
|
@deftp {Object} Variant1
|
|
|
|
A paragraph
|
|
|
|
Another paragraph (but no @code{var}: line)
|
|
|
|
@b{Members:}
|
|
@table @asis
|
|
@item @code{var1: string}
|
|
Not documented
|
|
@*@b{If:} @code{defined(IFSTR)}
|
|
@end table
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{variant1-feat}
|
|
a feature
|
|
@item @code{member-feat}
|
|
a member feature
|
|
@end table
|
|
|
|
@end deftp
|
|
|
|
|
|
|
|
@deftp {Object} Variant2
|
|
|
|
|
|
|
|
@end deftp
|
|
|
|
|
|
|
|
@deftp {Object} Object
|
|
|
|
|
|
|
|
@b{Members:}
|
|
@table @asis
|
|
@item The members of @code{Base}
|
|
@item The members of @code{Variant1} when @code{base1} is @t{"one"}
|
|
@item The members of @code{Variant2} when @code{base1} is @t{"two"} (@b{If:} @code{IFTWO})
|
|
@end table
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{union-feat1}
|
|
a feature
|
|
@end table
|
|
|
|
@end deftp
|
|
|
|
|
|
|
|
@deftp {Object} SugaredUnion
|
|
|
|
|
|
|
|
@b{Members:}
|
|
@table @asis
|
|
@item @code{type}
|
|
One of @t{"one"}, @t{"two"}
|
|
@item @code{data: Variant1} when @code{type} is @t{"one"}
|
|
@item @code{data: Variant2} when @code{type} is @t{"two"} (@b{If:} @code{IFTWO})
|
|
@end table
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{union-feat2}
|
|
a feature
|
|
@end table
|
|
|
|
@end deftp
|
|
|
|
|
|
|
|
@deftp {Alternate} Alternate
|
|
|
|
|
|
|
|
@b{Members:}
|
|
@table @asis
|
|
@item @code{i: int}
|
|
an integer
|
|
@code{b} is undocumented
|
|
@item @code{b: boolean}
|
|
Not documented
|
|
@end table
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{alt-feat}
|
|
a feature
|
|
@end table
|
|
|
|
@end deftp
|
|
|
|
|
|
@subsection Another subsection
|
|
|
|
|
|
@deftypefn Command {} cmd
|
|
|
|
|
|
|
|
@b{Arguments:}
|
|
@table @asis
|
|
@item @code{arg1: int}
|
|
the first argument
|
|
@item @code{arg2: string} (optional)
|
|
the second
|
|
argument
|
|
@item @code{arg3: boolean}
|
|
Not documented
|
|
@end table
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{cmd-feat1}
|
|
a feature
|
|
@item @code{cmd-feat2}
|
|
another feature
|
|
@end table
|
|
|
|
@b{Note:}
|
|
@code{arg3} is undocumented
|
|
|
|
@b{Returns:}
|
|
@code{Object}
|
|
|
|
@b{TODO:}
|
|
frobnicate
|
|
|
|
@b{Notes:}
|
|
@itemize @minus
|
|
@item
|
|
Lorem ipsum dolor sit amet
|
|
@item
|
|
Ut enim ad minim veniam
|
|
|
|
@end itemize
|
|
|
|
Duis aute irure dolor
|
|
|
|
@b{Example:}
|
|
@example
|
|
-> in
|
|
<- out
|
|
@end example
|
|
|
|
@b{Examples:}
|
|
@example
|
|
- *verbatim*
|
|
- @{braces@}
|
|
@end example
|
|
|
|
@b{Since:}
|
|
2.10
|
|
|
|
@end deftypefn
|
|
|
|
|
|
|
|
@deftypefn Command {} cmd-boxed
|
|
|
|
If you're bored enough to read this, go see a video of boxed cats
|
|
|
|
@b{Arguments:} the members of @code{Object}
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{cmd-feat1}
|
|
a feature
|
|
@item @code{cmd-feat2}
|
|
another feature
|
|
@end table
|
|
|
|
@b{Example:}
|
|
@example
|
|
-> in
|
|
|
|
<- out
|
|
@end example
|
|
|
|
@end deftypefn
|
|
|
|
|
|
|
|
@deftypefn Event {} EVT-BOXED
|
|
|
|
|
|
|
|
@b{Arguments:} the members of @code{Object}
|
|
|
|
@b{Features:}
|
|
@table @asis
|
|
@item @code{feat3}
|
|
a feature
|
|
@end table
|
|
|
|
@end deftypefn
|
|
|