Re: [PATCH 2/3] docs/devel/qtest: Include protocol spec in document

[Eduardo Habkost]

On Wed, Oct 07, 2020 at 01:03:21PM +0200, Paolo Bonzini wrote:
> On 05/10/20 22:52, Eduardo Habkost wrote:
> > + * DOC: QTest Protocol
> > + *
> > + * .. highlight:: none
> >   *
> >   * Line based protocol, request/response based.  Server can send async 
> > messages
> >   * so clients should always handle many async messages before the response
> >   * comes in.
> >   *
> >   * Valid requests
> > + * ^^^^^^^^^^^^^^
> >   *
> >   * Clock management:
> > + * """""""""""""""""
> >   *
> >   * The qtest client is completely in charge of the QEMU_CLOCK_VIRTUAL.  
> > qtest commands
> >   * let you adjust the value of the clock (monotonically).  All the commands
> >   * return the current value of the clock in nanoseconds.
> >   *
> > + * .. code-block::
> 
> What version of Sphinx do you have?  I need to have ".. code-block::
> none" here, so presumably the "highlight" directive is newer than my
> version (1.7.6, pretty old I admit)?

I have 2.2.2.

It looks like we should really add code to print a warning if not
running Sphinx 2.x.

-- 
Eduardo