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

[Jonathan Corbet]

On Sun, 13 Jan 2019 19:21:46 -0800
Randy Dunlap  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 
> Cc: Steven Royer 
> Cc: Jonathan Corbet 

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

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

[Randy Dunlap]

From: Randy Dunlap 

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 
Cc: Steven Royer 
Cc: Jonathan Corbet 
---
 Documentation/index.rst   |1 +
 Documentation/misc-devices/ibmvmc.rst |1 +
 Documentation/misc-devices/index.rst  |   17 +
 3 files changed, 19 insertions(+)

--- lnx-50-rc2.orig/Documentation/misc-devices/ibmvmc.rst
+++ lnx-50-rc2/Documentation/misc-devices/ibmvmc.rst
@@ -1,4 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0+
+
 ==
 IBM Virtual Management Channel Kernel Driver (IBMVMC)
 ==
--- lnx-50-rc2.orig/Documentation/index.rst
+++ lnx-50-rc2/Documentation/index.rst
@@ -90,6 +90,7 @@ needed).
filesystems/index
vm/index
bpf/index
+   misc-devices/index
 
 Architecture-specific documentation
 ---
--- /dev/null
+++ lnx-50-rc2/Documentation/misc-devices/index.rst
@@ -0,0 +1,17 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+
+Assorted Miscellaneous Devices Documentation
+
+
+This documentation contains information for assorted devices that do not
+fit into other categories.
+
+.. class:: toc-title
+
+  Table of contents
+
+.. toctree::
+   :maxdepth: 2
+
+   ibmvmc