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


Groups > linux.kernel > #1565054

Re: [PATCH] kernel-doc: Handle returning pointers to pointers

From Jonathan Corbet <corbet@lwn.net>
Newsgroups linux.kernel
Subject Re: [PATCH] kernel-doc: Handle returning pointers to pointers
Date 2017-01-23 16:30 +0100
Message-ID <t2OJc-885-13@gated-at.bofh.it> (permalink)
References <t2I14-40Y-3@gated-at.bofh.it> <t2M4G-6rG-21@gated-at.bofh.it> <t2Ozx-84K-53@gated-at.bofh.it>
Organization LWN.net

Show all headers | View raw


On Mon, 23 Jan 2017 15:14:51 +0000
Matthew Wilcox <mawilcox@microsoft.com> wrote:

> > I maintain my own stack of "linuxdoc" with a python version
> > of the kernel-doc script (hosted on github). It uses the same
> > regexes as the perl version (using a python rewrite here has some
> > other benefits, one you will see below). I merged your patch:  
> 
> Are there plans to merge that?  It feels so odd to have a python script calling a perl script ...

I pushed back pretty hard on it last year; my feeling at the time was that
the Sphinx transition had enough moving parts as it was.  I do think we
can reconsider it now, though.  It's not as if the perl kerneldoc script
is a thing of great beauty in need of preservation.

Markus, would you consider sending out a new patch set for review?  What I
would like to do see is something adding the new script for the Sphinx
toolchain, while leaving the DocBook build unchanged, using the old
script.  We could then delete it once the last template file has moved
over. 

4.12 would be the probable merge target; it's a big enough change that I'd
like to have it in -next for a full development cycle.

Thanks,

jon

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


Thread

[PATCH] kernel-doc: Handle returning pointers to pointers Matthew Wilcox <mawilcox@microsoft.com> - 2017-01-23 09:20 +0100
  Re: [PATCH] kernel-doc: Handle returning pointers to pointers Markus Heiser <markus.heiser@darmarit.de> - 2017-01-23 13:40 +0100
    RE: [PATCH] kernel-doc: Handle returning pointers to pointers Matthew Wilcox <mawilcox@microsoft.com> - 2017-01-23 16:20 +0100
      Re: [PATCH] kernel-doc: Handle returning pointers to pointers Jonathan Corbet <corbet@lwn.net> - 2017-01-23 16:30 +0100
        Re: [PATCH] kernel-doc: Handle returning pointers to pointers Markus Heiser <markus.heiser@darmarit.de> - 2017-01-24 08:00 +0100
          RE: [PATCH] kernel-doc: Handle returning pointers to pointers Matthew Wilcox <mawilcox@microsoft.com> - 2017-01-24 16:40 +0100
            Re: [PATCH] kernel-doc: Handle returning pointers to pointers Markus Heiser <markus.heiser@darmarit.de> - 2017-01-24 21:10 +0100
  Re: [PATCH] kernel-doc: Handle returning pointers to pointers Jonathan Corbet <corbet@lwn.net> - 2017-01-26 23:30 +0100

csiph-web