On Sat, Mar 10, 2018 at 12:50:46PM +0100, Linus Walleij wrote: > On Fri, Mar 9, 2018 at 12:40 AM, Jonathan Neuschäfer > <j.neuschaefer@xxxxxxx> wrote: > > > The aim of this patchset is to move the GPIO subsystem's documentation > > under Documentation/driver-api/gpio/ such that it is picked up by Sphinx > > and compiled into HTML. > > Awesome! > > > I moved everything except for sysfs.txt, because > > this file describes the legacy sysfs ABI, and doesn't seem to serve much > > (non-historical) purpose anymore. > > > > There are still some rough edges: > > > > * I think the API documentation (kernel-doc) should be moved out of > > index.rst into more appropriate files. > > * The headings are arguably wrong, because driver.rst, consumer.rst, > > etc. use the "document title" style, even though they are part of the > > GPIO chapter. But the resulting TOC tree is consistent, and I did not > > want to change almost all headings. > > * Some of the files could use more :c:func:`...` references and general > > ReST polish. > > > > But I don't want to make this patchset too large. > > It's fine, we take it one step at a time. > > On Fri, Mar 09, 2018 at 10:41:20AM -0700, Jonathan Corbet wrote: > > > Anyway, I'm happy to take these through the docs tree or see them go via > > GPIO; Linus, what's your preference? > > I might have some doc patches that could collide so I can take them. > > I take it there will be a v2? Not necessarily, but if I need to rebase on a different branch, or on future linux-next, I'll do that. (Or if some other issue is found.) I thought that patch 8/8 currently requires commit 93db446a424c ("mtd: nand: move raw NAND related code to the raw/ subdir"), which is in next through Boris Brezillon's nand tree, but this isn't true. The patchset (currently) applies to both v4.16-rc4 and next, AFAICS. Thanks, Jonathan Neuschäfer
Attachment:
signature.asc
Description: PGP signature