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. 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, Hans -- Hans Verkuil - video4linux developer - sponsored by TANDBERG Telecom -- 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
