From patchwork Tue Sep 1 13:11:17 2009 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 45062 Received: from vger.kernel.org (vger.kernel.org [209.132.176.167]) by demeter.kernel.org (8.14.2/8.14.2) with ESMTP id n81DC2Oa016983 for ; Tue, 1 Sep 2009 13:12:02 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754531AbZIANL7 (ORCPT ); Tue, 1 Sep 2009 09:11:59 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1754565AbZIANL7 (ORCPT ); Tue, 1 Sep 2009 09:11:59 -0400 Received: from bombadil.infradead.org ([18.85.46.34]:40355 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754430AbZIANL6 (ORCPT ); Tue, 1 Sep 2009 09:11:58 -0400 Received: from 201-13-165-112.dial-up.telesp.net.br ([201.13.165.112] helo=pedra.chehab.org) by bombadil.infradead.org with esmtpsa (Exim 4.69 #1 (Red Hat Linux)) id 1MiT9Q-0001Qu-ED; Tue, 01 Sep 2009 13:11:56 +0000 Date: Tue, 1 Sep 2009 10:11:17 -0300 From: Mauro Carvalho Chehab To: "Hans Verkuil" Cc: "Laurent Pinchart" , "William M. Brack" , "V4L Mailing List" , =?ISO-8859-1?B?TultZXRoIE3hcnRvbg==?= Subject: Re: problem building v4l2-spec from docbook source Message-ID: <20090901101117.5868440d@pedra.chehab.org> In-Reply-To: <61a1e1ecfcace9d2a452fa8de0521ab9.squirrel@webmail.xs4all.nl> References: <4A9A3650.3000106@freemail.hu> <20090831213531.4eb2c10a@pedra.chehab.org> <200909010859.34027.hverkuil@xs4all.nl> <200909011049.15964.laurent.pinchart@ideasonboard.com> <61a1e1ecfcace9d2a452fa8de0521ab9.squirrel@webmail.xs4all.nl> X-Mailer: Claws Mail 3.3.1 (GTK+ 2.10.4; x86_64-redhat-linux-gnu) Mime-Version: 1.0 X-SRS-Rewrite: SMTP reverse-path rewritten from by bombadil.infradead.org See http://www.infradead.org/rpr.html Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Em Tue, 1 Sep 2009 10:55:10 +0200 "Hans Verkuil" escreveu: > > > 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 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. IMHO, the spanspec is bad specified on this table. See if this would produce a better result: > In other cases there is very > >> little > >> space between columns, e.g. section 3.5, table 3.3. Maybe it is not properly handling the colwidth. We need to do more investigation. This DocBook version is less tolerant to standard violations. I had to fix several violations that V3.1 didn't complain during the conversion. Maybe there are some violations at the way some tables are specified, or maybe xmlto doesn't care to colwidth or handles it differently. > >> 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 suspect that that is quite difficult: the core problem are some very > wide tables that are cut off on the right hand side if I am not mistaken. There are also some pictures that are cut. > Of course, if someone wants to take this on... It will be good if someone could fix it. I had to keep the old docbook2pdf to generate pdf's since xmlto refuses to do it, mostly due to the size violations. Cheers, Mauro --- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/v4l2-spec/controls.sgml b/v4l2-spec/controls.sgml --- a/v4l2-spec/controls.sgml +++ b/v4l2-spec/controls.sgml @@ -610,7 +610,7 @@ certain hardware. - + ID