Re: [Qemu-devel] [PATCH] docs: Convert migration.txt to rst

["Dr. David Alan Gilbert" <dgilbert@redhat.com>]

* Kashyap Chamarthy (kchamart@redhat.com) wrote:
> On Thu, Dec 14, 2017 at 12:26:03PM +0100, Kashyap Chamarthy wrote:
> > On Wed, Dec 13, 2017 at 08:11:46PM +0000, Dr. David Alan Gilbert wrote:
> 
> [...]
> 
> > > > > -   Command: 'postcopy listen'
> > > > > -   The device state
> > > > 
> > > > In my local Sphinx-based HTML rendering, the above "The device state"
> > > > ended up being bold somehow.
> > > 
> > > Any idea why? It's fine both in vim and rst2html-3's output.
> > 
> > Don't know yet.  You can see here in the Sphinx-rendered HTML version:
> 
> So it's due to the indentation below the line "The device state".  You
> can either put an extra blank line before indenting the next line:
> 
>    - The device state:
> 
>        A series of sections, identical to the precopy streams device
>        state stream containing everything except postcopiable devices
>        (i.e. RAM)

I think the problem here is the 'A' - it's picking it up as the first
item in a numbered list; if I change that to 'The' it also fixes it.
I added the extra blank line, it's OK but doesn't look great.

> Or, just indent it to the same level:
> 
>    - The device state: A series of sections, identical to the precopy
>      streams device state stream containing everything except
>      postcopiable devices (i.e.  RAM)
> 
> Same applies for other places where bold text came in at unwanted places.

Dave

> [...]
> 
> -- 
> /kashyap
--
Dr. David Alan Gilbert / dgilbert@redhat.com / Manchester, UK