On Tuesday 01 September 2009 08:59:33 Hans Verkuil wrote: > On Tuesday 01 September 2009 02:35:31 Mauro Carvalho Chehab wrote: > > Em Mon, 31 Aug 2009 13:52:37 -0300 > > > > Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxx> escreveu: > > > Hmm.. maybe Debian docbook packages have some issues with old versions > > > of DocBook? Anyway, we should upgrade to XML 4.1.2 to use the same > > > DocBook version as used on kernel. Also, as kernel uses xmlto, I'm > > > working on a patch to port it to the same version/tools used on kernel. > > > This will make easier for a future integration of the documentation at > > > the kernel tree. > > > > As promised, I just committed a changeset that upgraded the DocBook > > version. It will now prefer to use xmlto, since, on my tests, it seemed > > more reliable than docbook, for html targets. Unfortunately, it didn't > > work fine for pdf target, so, it will keep using docbook (in fact db2pdf) > > for generating the pdf version. > > > > Please test. It everything is fine, IMO, we should consider the inclusion > > of the V4L2 API on kernel (or at least, some parts of the API - since the > > "changes" chapter doesn't seem much relevant to be on kernel). > > Hi Mauro, > > I did a quick test of the html output and it seems that table handling is > hit and miss: e.g. see section 1.9.5.1. In other cases there is very little > space between columns, e.g. section 3.5, table 3.3. > > Regarding pdf: do we really want to keep that? The output never looked > good. I wouldn't shed a tear if we dropped pdf support. Can't we fix it to make it look good instead ? :-) > I would also suggest to either remove the revision and changes sections or > move it to a ChangeLog file instead. Now that we have the spec under > revision control I do not see much benefit. The only reason why we still > need something like that is that it provides a log of when certain > functionality first appeared. A ChangeLog would do just as well. -- Regards, Laurent Pinchart -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html