On 3/9/20 8:43 AM, Peter Maydell wrote: > There are exactly two places in our json doc comments where we > use the markup accepted by the texi doc generator where a '|' in > the first line of a doc comment means the line should be emitted > as a literal block (fixed-width font, whitespace preserved). > > Since we use this syntax so rarely, instead of making the rST > generator support it, instead just convert the two uses to > rST-format literal blocks, which are indented and introduced > with '::'. > > (The rST generator doesn't complain about the old style syntax, > it just emits it with the '|' and with the whitespace not > preserved, which looks odd, but means we can safely leave this > change until after we've stopped generating texinfo.) > > Signed-off-by: Peter Maydell <peter.mayd...@linaro.org> > --- > qapi/block-core.json | 16 +++++++++------- > qapi/qapi-schema.json | 6 ++++-- > 2 files changed, 13 insertions(+), 9 deletions(-)
Reviewed-by: Richard Henderson <richard.hender...@linaro.org> r~