Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-24 Thread Mauro Carvalho Chehab
Em Mon, 24 Jun 2019 08:29:50 -0600 Jonathan Corbet escreveu: > On Sat, 22 Jun 2019 14:46:10 -0300 > Mauro Carvalho Chehab wrote: > > > > > .. c:function:: int ioctl( int fd, int request, void *argp ) > > > > :name: v4l2-ioctl > > > > > > Some digging around didn't turn up any documen

Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-24 Thread Jonathan Corbet
On Sat, 22 Jun 2019 14:46:10 -0300 Mauro Carvalho Chehab wrote: > > > .. 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

Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-24 Thread Jonathan Corbet
On Mon, 24 Jun 2019 14:30:47 +0300 Jani Nikula wrote: > > +def auto_markup(app, doctree, name): > > +for para in doctree.traverse(nodes.paragraph): > > +for node in para.traverse(nodes.Text): > > +if not isinstance(node.parent, nodes.literal): > > +node.par

Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-24 Thread Jani Nikula
On Fri, 21 Jun 2019, Jonathan Corbet wrote: > Rather than fill our text files with :c:func:`function()` syntax, just do > the markup via a hook into the sphinx build process. > > Signed-off-by: Jonathan Corbet > --- > Documentation/conf.py | 3 +- > Documentation/sphinx/automarkup.

Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-22 Thread Mauro Carvalho Chehab
Em Sat, 22 Jun 2019 08:43:46 -0600 Jonathan Corbet escreveu: > On Fri, 21 Jun 2019 22:00:46 -0300 > Mauro Carvalho Chehab wrote: > > > > +# > > > +# The DVB docs create references for these basic system calls, leading > > > +# to lots of confusing links. So just don't link them. > > > +# > > >

Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-22 Thread Jonathan Corbet
On Fri, 21 Jun 2019 22:00:46 -0300 Mauro Carvalho Chehab 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

Re: [PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-21 Thread Mauro Carvalho Chehab
Em Fri, 21 Jun 2019 17:51:57 -0600 Jonathan Corbet escreveu: > Rather than fill our text files with :c:func:`function()` syntax, just do > the markup via a hook into the sphinx build process. Didn't test it, but it sounds a way nicer than the past version! > Signed-off-by: Jonathan Corbet > -

[PATCH 1/3] Docs: An initial automarkup extension for sphinx

2019-06-21 Thread Jonathan Corbet
Rather than fill our text files with :c:func:`function()` syntax, just do the markup via a hook into the sphinx build process. Signed-off-by: Jonathan Corbet --- Documentation/conf.py | 3 +- Documentation/sphinx/automarkup.py | 80 ++ 2 files changed, 8