Re: [PATCH v2 00/12] Include linux PCI docs into Sphinx TOC tree

From: Jonathan Corbet
Date: Wed Apr 03 2019 - 15:23:15 EST


On Wed, 3 Apr 2019 23:49:43 +0800
Changbin Du <changbin.du@xxxxxxxxx> wrote:

> The kernel now uses Sphinx to generate intelligent and beautiful documentation
> from reStructuredText files. I converted most of the Linux PCI docs to rst
> format in this serias.
>
> For you to preview, please visit below url:
> http://www.bytemem.com:8080/kernel-doc/PCI/index.html
>
> Thank you!

So I have the same comment that I had with regard to the ACPI set: I would
really rather not clutter the top level of the doc tree with this. In
this case the resolution is a lot simpler, though: everything here seems
suitable for the driver API guide. Could you please redo the patch set to
place the docs there?

Reflecting Bjorn's comment on the title lines and adding his ack would be
a nice touch while you're at it.

Thanks for doing this work - this one's almost there, I think.

jon