Mauro Carvalho Chehab wrote: > Em Sun, 6 Sep 2009 22:25:25 -0300 > Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxx> escreveu: > > >> Em Sat, 05 Sep 2009 18:54:27 +0100 >> Peter Brouwer <pb.maillists@xxxxxxxxxxxxxx> escreveu: >> >> >>> Is it possible to create a link on the linuxtv.org website to the latest dvb and >>> v4l spec in pdf? >>> For dvb the v3 is still on the documentation page. >>> >> The pdf version of V4L2 spec is currently broken: several tables and graphics >> don't fit at the page size. If you (or someone else) is interested on fixing >> it, I'll add a pointer at linuxtv.org for the updated version, and improve the >> script to auto-generate it. >> >> In the case of the DVB spec, the version of the current document is version 3. >> Patrick's ISDB-T patch series are increasing version to 5.1, but there are >> still some missing parts when comparing with the current API. >> >> In order to make easier for people to maintain the DVB API and to allow people >> of just using just one language and document generation tools, I've converted the >> DVB API specs to DocBook as well. I'll add it to the tree soon. It is yet a >> work undergoing, but it would be nice if people could review it and improve. >> After having some review and porting the ISDB-T changes to it, IMO, the better >> is to deprecate the LaTex version using the DocBooc version one instead. >> >> > > I've updated the Documentation page at linuxtv.org to warn people to not trust > at V4L2 spec pdf file, while nobody fixes it. I also added there a link to the > dvbapi spec generated via the newly DocBook port of the docs that I posted at: > http://linuxtv.org/hg/~mchehab/dvb-specs > > This way, it will be easier for people to double check if nothing were lost > during the format conversion. IMHO, one of the biggest advantage of the html > generated from DocBook is that the chapter/section numbering is preserved, > while, with the LaTex version, they are shown only at the pdf doc. It should be > noticed that, as no styles are applied to the tables, that they are not > nicely displayed at the DocBook version. > We've got too many entry points/links to things -- which lends itself to becoming a maintenance nightmare (not blaming anyone, just pointing out the obvious). For example: although the updated info was applied here: http://www.linuxtv.org/docs.php, we have other avenues such as http://www.linuxtv.org/downloads/video4linux/API/V4L2_API/ (as linked to by, for example, from here :http://www.linuxtv.org/wiki/index.php/Development:_Video4Linux_APIs) that do not reflect those changes, and hence we have inconsistent info across the board. Same goes with mailing lists and #irc channels -- we've got too many of them! ... /trails off mumbling about this and that....mumble mumble mumble grumble.... -- 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
