[Qemu-devel] [RFC PATCH 01/32] tests/qapi-schema: Improve coverage of '@'

[Markus Armbruster]

Demonstrates a qapi2texi.py bug: it can fail to escape '@'.

Signed-off-by: Markus Armbruster <address@hidden>
---
 tests/qapi-schema/doc-good.json | 3 +++
 tests/qapi-schema/doc-good.out  | 3 +++
 tests/qapi-schema/doc-good.texi | 4 ++++
 3 files changed, 10 insertions(+)

diff --git a/tests/qapi-schema/doc-good.json b/tests/qapi-schema/doc-good.json
index 97ab4625ff..44098d7f1a 100644
--- a/tests/qapi-schema/doc-good.json
+++ b/tests/qapi-schema/doc-good.json
@@ -10,6 +10,7 @@
 #
 # *strong* _with emphasis_
 # @var {in braces}
+# lone @ BUG: gets passed to Texinfo unescaped
 # * List item one
 # - Two, multiple
 #   lines
@@ -46,6 +47,7 @@
 # <- out
 # Examples:
 # - *verbatim*
+# - @at sign
 # - {braces}
 ##
 
@@ -115,6 +117,7 @@
 # <- out
 # Examples:
 # - *verbatim*
+# - @at sign BUG: gets passed to Texinfo unescaped
 # - {braces}
 # Since: 2.10
 ##
diff --git a/tests/qapi-schema/doc-good.out b/tests/qapi-schema/doc-good.out
index 1d2c250527..b732b81119 100644
--- a/tests/qapi-schema/doc-good.out
+++ b/tests/qapi-schema/doc-good.out
@@ -38,6 +38,7 @@ doc freeform
 
 *strong* _with emphasis_
 @var {in braces}
+lone @ BUG: gets passed to Texinfo unescaped
 * List item one
 - Two, multiple
 lines
@@ -74,6 +75,7 @@ Example:
 <- out
 Examples:
 - *verbatim*
+- @at sign
 - {braces}
 doc symbol=Enum
     body=
@@ -136,6 +138,7 @@ Duis aute irure dolor
 <- out
     section=Examples
 - *verbatim*
+- @at sign BUG: gets passed to Texinfo unescaped
 - {braces}
     section=Since
 2.10
diff --git a/tests/qapi-schema/doc-good.texi b/tests/qapi-schema/doc-good.texi
index 1778312581..840a492249 100644
--- a/tests/qapi-schema/doc-good.texi
+++ b/tests/qapi-schema/doc-good.texi
@@ -4,6 +4,7 @@
 
 @strong{strong} @emph{with emphasis}
 @code{var} @{in address@hidden
+lone @ BUG: gets passed to Texinfo unescaped
 @itemize @bullet
 @item
 List item one
@@ -69,6 +70,8 @@ Examples:
 @item
 @strong{verbatim}
 @item
address@hidden sign
address@hidden
 @address@hidden
 @end itemize
 
@@ -206,6 +209,7 @@ Duis aute irure dolor
 @b{Examples:}
 @example
 - *verbatim*
+- @at sign BUG: gets passed to Texinfo unescaped
 - @address@hidden
 @end example
 
-- 
2.13.6