lkml.org 
[lkml]   [2019]   [Jun]   [22]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH 1/3] Docs: An initial automarkup extension for sphinx
On Fri, 21 Jun 2019 22:00:46 -0300
Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:

> > +#
> > +# The DVB docs create references for these basic system calls, leading
> > +# to lots of confusing links. So just don't link them.
> > +#
> > +Skipfuncs = [ 'open', 'close', 'write' ]
>
> and yeah, of course, if there's something weird, it has to be at
> the media docs :-)
>
> Btw, if I'm not mistaken, we do the same for ioctl.

So that's actually interesting. In, for example,
Documentation/media/uapi/v4l/func-ioctl.rst, you see something that looks
like this:

> .. c:function:: int ioctl( int fd, int request, void *argp )
> :name: v4l2-ioctl

Some digging around didn't turn up any documentation for :name:, but it
seems to prevent ioctl() from going into the list of functions that can be
cross-referenced. I wonder if the same should be done for the others? I
think that would be better than putting a special-case hack into the
toolchain.

> I'm wandering if this could also handle the Documentation/* auto-replace.

I think it's the obvious place for it, yes. Let's make sure I haven't
badly broken anything with the existing change first, though :)

Thanks,

jon

\
 
 \ /
  Last update: 2019-06-22 16:44    [W:0.082 / U:24.804 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site