Re: [PATCH] Documentation: add ibmvmc to toctree(index) and fix warnings

[Jonathan Corbet]

On Sun, 13 Jan 2019 19:21:46 -0800
Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:

> Fix Sphinx warnings in ibmvmc.rst, add an index.rst file in
> Documentation/misc-devices/, and insert that index file into the
> top-level index file.
> 
> Documentation/misc-devices/ibmvmc.rst:2: WARNING: Explicit markup ends without a blank line; unexpected unindent.
> Documentation/misc-devices/ibmvmc.rst:: WARNING: document isn't included in any toctree
> 
> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> Cc: Steven Royer <seroyer@xxxxxxxxxxxxx>
> Cc: Jonathan Corbet <corbet@xxxxxxx>

Rather than make another new top-level entry to add to the mess there, I
do wonder if this isn't better placed in the driver-api manual.  I *think*
that's appropriate, though the document is a bit vague to use that way.

Oh well, bringing it in and killing some warnings is better than what we
have now, so I've applied it.  We can always move it around later.

Thanks,

jon