Re: problem building v4l2-spec from docbook source

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

[Index of Archives]     [Linux Input]     [Video for Linux]     [Gstreamer Embedded]     [Mplayer Users]     [Linux USB Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Yosemite Backpacking]
  Powered by Linux