Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1468202

Re: [PATCH 3/3] docs: Pull HSI documentation together

Show all headers | View raw

[Multipart message — attachments visible in raw view] - view raw

Hi Jonathan,

On Mon, Aug 22, 2016 at 02:57:43PM -0600, Jonathan Corbet wrote:
> The HSI subsystem documentation was split across hsi.txt and the
> device-drivers docbook.  Now that the latter has been converted to Sphinx,
> pull in the HSI document so that it's all in one place.

Thanks for doing this. I like the resulting HTML. I'm a bit confused
by the rendering of the struct sections, though. Initially I thought
the blue box with "struct xyz" is an empty table (= there are no
members).

Also I think it would be better to split serial-interfaces.rst into
the different subsystems. It generates different sections anyways.

Note that currently the document's title is "Serial Peripheral Interface
(SPI)", so if we don't split the document it should be changed to
"Serial Interfaces" (document title = html>head>title and in the
breadcrumb trail of the generated html).

Anyways, all of that would be extra patches. This one is

Acked-By: Sebastian Reichel <sre@kernel.org>

-- Sebastian

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH 0/3] RFC: The beginning of a proper driver-api book Jonathan Corbet <corbet@lwn.net> - 2016-08-22 23:00 +0200
  [PATCH 3/3] docs: Pull HSI documentation together Jonathan Corbet <corbet@lwn.net> - 2016-08-22 23:00 +0200
    Re: [PATCH 3/3] docs: Pull HSI documentation together Sebastian Reichel <sre@kernel.org> - 2016-08-23 02:30 +0200
  [PATCH 1/3] Docs: sphinxify device-drivers.tmpl Jonathan Corbet <corbet@lwn.net> - 2016-08-22 23:00 +0200
  [PATCH 2/3] docs: split up the driver book Jonathan Corbet <corbet@lwn.net> - 2016-08-22 23:00 +0200
    Re: [PATCH 2/3] docs: split up the driver book Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-08-23 16:40 +0200
      Re: [PATCH 2/3] docs: split up the driver book Jonathan Corbet <corbet@lwn.net> - 2016-08-25 00:50 +0200
        Re: [PATCH 2/3] docs: split up the driver book Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-08-25 07:40 +0200
  Re: [PATCH 0/3] RFC: The beginning of a proper driver-api book Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-08-23 16:50 +0200

csiph-web