Re: [PATCH 2/3] docs: split up the driver book

2016-08-25 Thread Jonathan Corbet
On Tue, 23 Aug 2016 11:30:16 -0300 Mauro Carvalho Chehab wrote: > I noticed several issues on the converted document. Just commenting > a few of them, as they all follow a pattern: kernel-doc markups > needs review during the conversion to RST, because, unfortunately, >

Re: [PATCH 2/3] docs: split up the driver book

2016-08-25 Thread Jonathan Corbet
On Tue, 23 Aug 2016 11:30:16 -0300 Mauro Carvalho Chehab wrote: > I noticed several issues on the converted document. Just commenting > a few of them, as they all follow a pattern: kernel-doc markups > needs review during the conversion to RST, because, unfortunately, > the conversion is not

Re: [PATCH 2/3] docs: split up the driver book

2016-08-24 Thread Mauro Carvalho Chehab
Em Wed, 24 Aug 2016 16:46:22 -0600 Jonathan Corbet escreveu: > On Tue, 23 Aug 2016 11:30:16 -0300 > Mauro Carvalho Chehab wrote: > > > On the output text, you'll see two places with "@:c:func:threadfn()". > > > > The problem here is that threadfn() is

Re: [PATCH 2/3] docs: split up the driver book

2016-08-24 Thread Mauro Carvalho Chehab
Em Wed, 24 Aug 2016 16:46:22 -0600 Jonathan Corbet escreveu: > On Tue, 23 Aug 2016 11:30:16 -0300 > Mauro Carvalho Chehab wrote: > > > On the output text, you'll see two places with "@:c:func:threadfn()". > > > > The problem here is that threadfn() is a function argument. While this > > used

Re: [PATCH 2/3] docs: split up the driver book

2016-08-24 Thread Jonathan Corbet
On Tue, 23 Aug 2016 11:30:16 -0300 Mauro Carvalho Chehab wrote: > On the output text, you'll see two places with "@:c:func:threadfn()". > > The problem here is that threadfn() is a function argument. While this > used to work with DocBooks, now with Sphinx this is not

Re: [PATCH 2/3] docs: split up the driver book

2016-08-24 Thread Jonathan Corbet
On Tue, 23 Aug 2016 11:30:16 -0300 Mauro Carvalho Chehab wrote: > On the output text, you'll see two places with "@:c:func:threadfn()". > > The problem here is that threadfn() is a function argument. While this > used to work with DocBooks, now with Sphinx this is not handled well. > > I got

Re: [PATCH 2/3] docs: split up the driver book

2016-08-23 Thread Mauro Carvalho Chehab
Em Mon, 22 Aug 2016 14:57:42 -0600 Jonathan Corbet escreveu: > We don't need to keep it as a single large file anymore; split it up so > that it is easier to manage and the individual sections can be read > directly as plain files. > > Cc: Jani Nikula >

Re: [PATCH 2/3] docs: split up the driver book

2016-08-23 Thread Mauro Carvalho Chehab
Em Mon, 22 Aug 2016 14:57:42 -0600 Jonathan Corbet escreveu: > We don't need to keep it as a single large file anymore; split it up so > that it is easier to manage and the individual sections can be read > directly as plain files. > > Cc: Jani Nikula > Cc: Mauro Carvalho Chehab >

[PATCH 2/3] docs: split up the driver book

2016-08-22 Thread Jonathan Corbet
We don't need to keep it as a single large file anymore; split it up so that it is easier to manage and the individual sections can be read directly as plain files. Cc: Jani Nikula Cc: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet

[PATCH 2/3] docs: split up the driver book

2016-08-22 Thread Jonathan Corbet
We don't need to keep it as a single large file anymore; split it up so that it is easier to manage and the individual sections can be read directly as plain files. Cc: Jani Nikula Cc: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet --- Documentation/driver-api/basics.rst|