V4L docs and docbook

2016-02-17 Thread Jonathan Corbet
Hey, Mauro, There's been a conversation going on that I keep meaning to bring you into. In short, there's a fair amount of interest in improving our formatted kernel documentation, and, in particular, making it easier to write; I'd like to be sure that work doesn't leave media behind. Work pushe

Re: V4L docs and docbook

2016-02-17 Thread Mauro Carvalho Chehab
Hi Jon, Em Wed, 17 Feb 2016 14:52:54 -0700 Jonathan Corbet escreveu: > Hey, Mauro, > > There's been a conversation going on that I keep meaning to bring you > into. In short, there's a fair amount of interest in improving our > formatted kernel documentation, and, in particular, making it easi

Re: V4L docs and docbook

2016-02-17 Thread Hans Verkuil
Hi Jon, On 02/17/2016 10:52 PM, Jonathan Corbet wrote: > Hey, Mauro, > > There's been a conversation going on that I keep meaning to bring you > into. In short, there's a fair amount of interest in improving our > formatted kernel documentation, and, in particular, making it easier to > write; I

Re: V4L docs and docbook

2016-02-18 Thread Russel Winder
On Wed, 2016-02-17 at 21:51 -0200, Mauro Carvalho Chehab wrote: > […] > > We have 2 types of documentation for the Kernel part of the > subsystem, > Both using DocBook: > - The uAPI documentation: > https://linuxtv.org/downloads/v4l-dvb-apis > - The kAPI documentation: > https://linuxt

Re: V4L docs and docbook

2016-02-18 Thread Mauro Carvalho Chehab
Em Thu, 18 Feb 2016 08:17:00 + Russel Winder escreveu: > On Wed, 2016-02-17 at 21:51 -0200, Mauro Carvalho Chehab wrote: > > […] > > > > We have 2 types of documentation for the Kernel part of the > > subsystem, > > Both using DocBook: > > - The uAPI documentation: > > https://linuxtv.or

Re: V4L docs and docbook

2016-02-18 Thread Mauro Carvalho Chehab
Em Thu, 18 Feb 2016 06:31:14 -0200 Mauro Carvalho Chehab escreveu: > Em Thu, 18 Feb 2016 08:17:00 + > Russel Winder escreveu: > > > On Wed, 2016-02-17 at 21:51 -0200, Mauro Carvalho Chehab wrote: > > > […] > > > > > > We have 2 types of documentation for the Kernel part of the > > > subs

Re: V4L docs and docbook

2016-02-18 Thread Mauro Carvalho Chehab
Em Thu, 18 Feb 2016 07:10:14 -0200 Mauro Carvalho Chehab escreveu: > Em Thu, 18 Feb 2016 06:31:14 -0200 > Mauro Carvalho Chehab escreveu: > > > Em Thu, 18 Feb 2016 08:17:00 + > > Russel Winder escreveu: > > > > > On Wed, 2016-02-17 at 21:51 -0200, Mauro Carvalho Chehab wrote: > > >

Re: V4L docs and docbook

2016-02-18 Thread Jani Nikula
On Thu, 18 Feb 2016, Russel Winder wrote: > On Wed, 2016-02-17 at 21:51 -0200, Mauro Carvalho Chehab wrote: >> […] >> >> We have 2 types of documentation for the Kernel part of the >> subsystem, >> Both using DocBook: >> - The uAPI documentation: >> https://linuxtv.org/downloads/v4l-dvb-apis

Re: V4L docs and docbook

2016-02-18 Thread Jani Nikula
On Thu, 18 Feb 2016, Mauro Carvalho Chehab wrote: > Are there any tools that would convert from DocBook to ASCIIDoc? I used pandoc when I tested the asciidoc pipeline. Something along the lines of this for filtering docbook in stdin to asciidoc in stdout: pandoc --atx-headers -f docbook -t ascii

Re: V4L docs and docbook

2016-02-18 Thread Mauro Carvalho Chehab
Em Thu, 18 Feb 2016 11:37:41 +0200 Jani Nikula escreveu: > On Thu, 18 Feb 2016, Mauro Carvalho Chehab wrote: > > Are there any tools that would convert from DocBook to ASCIIDoc? > > I used pandoc when I tested the asciidoc pipeline. Something along the > lines of this for filtering docbook in

Re: V4L docs and docbook

2016-02-18 Thread Jani Nikula
On Thu, 18 Feb 2016, Hans Verkuil wrote: > I looked at ReStructuredText and it looks like it will be a pain to convert > the media DocBook code to that, and the main reason is the poor table support. > The syntax for that looks very painful and the media DocBook is full of > tables. The table su

Re: V4L docs and docbook

2016-02-18 Thread Hans Verkuil
On 02/18/16 11:19, Jani Nikula wrote: > On Thu, 18 Feb 2016, Hans Verkuil wrote: >> I looked at ReStructuredText and it looks like it will be a pain to convert >> the media DocBook code to that, and the main reason is the poor table >> support. >> The syntax for that looks very painful and the me

Re: V4L docs and docbook

2016-02-19 Thread Russel Winder
On Thu, 2016-02-18 at 07:28 -0200, Mauro Carvalho Chehab wrote: > Em Thu, 18 Feb 2016 07:10:14 -0200 > […] > > Stupid me: it should be just: > asciidoc book.asciidoc > > Still, there are lots of broken things there, and lots of errors when > building it: > https://mchehab.fedorapeople

Re: V4L docs and docbook

2016-02-19 Thread Mauro Carvalho Chehab
Em Fri, 19 Feb 2016 08:28:13 + Russel Winder escreveu: > On Thu, 2016-02-18 at 07:28 -0200, Mauro Carvalho Chehab wrote: > > Em Thu, 18 Feb 2016 07:10:14 -0200 > > […] > > > > Stupid me: it should be just: > > asciidoc book.asciidoc > > > > Still, there are lots of broken things there,

Re: V4L docs and docbook

2016-02-19 Thread Keith Packard
Hans Verkuil writes: > But good table handling is a prerequisite for us since we rely heavily on > that. I converted an asciidoc document that included some tables to sphinx via docbook using pandoc; that seemed to generate workable results for me, but my needs are pretty simple. Asciidoc has